使用指南
高级

让自己的网站接入 FloatPass

让你自己的网站接入 FloatPass,网站上的购买记成创造者积分,和市场上获得的积分一起管理。

除了在 Floatboat 市场里上架作品,你可能还有自己的网站:老师在上面放网课,设计师放模板,自由职业者放一个顺手的小工具。FloatPass 让这样的网站也能接入一次性购买。

网站上的购买会记成创造者积分,和你在市场上获得的积分放在同一个账上,一起兑换,不用分两处管。

接入这件事可以交给 Agent 去做。你下载 FloatPass 的 Skill,把接入指令交给 Claude Code、Codex 这类 Agent,它会照着把 FloatPass 接到你的网站上。你不用自己写代码,但这一页会把它要做的每件事讲清楚,方便你把关。

需要有效的创造者计划

FloatPass 是创造者计划的权益。创建密钥、批准授权的时候,你的计划要在有效期内,资格没有被暂停,也没有停止经营。还没加入?看取得收费资格。

积分怎么记

动手接入前,先知道网站上的购买会怎么记到你的账上:

  • 网站上的购买会按平台规则记成创造者积分,具体以 FloatPass 页面和平台规则为准。
  • 记好之后,会出现在「创造者数据」的「最近记录」里,标着 FloatPass。
  • 和市场上获得的积分一样,记入后要等 30 天,之后可以兑换成 Floatboat 积分。
  • 买家退款时,对应的积分会扣回。

打开 FloatPass

在浏览器里打开创造者中心的 FloatPass,用你的 Floatboat 账号登录。

也可以从客户端进:点左下角你的名字,选「开发者中心」,再点左边的「FloatPass」。

浏览器里打开 floatboat.ai/zh/developer/floatpass,左侧是创造者中心的菜单,「FloatPass」处于选中状态。右上角的「下载 Skill」和「复制接入指令」分别被框出并标上 1、2。中间是刚创建好的密钥 fpk_live_7c2e9a41…,框上写着「完整密钥只显示这一次」,右边有复制按钮。下面的列表里有「小林的模板小站」(有效)和「旧网站(已停用)」(已撤销)。

让 Agent 帮你接入

下载 Skill,复制接入指令

在 FloatPass 页面点「下载 Skill」,把下载的 Skill 放进你网站的项目文件夹里。再点「复制接入指令」。

这段指令就是给 Agent 的任务单。它会让 Agent 做这些事:

  • 领取一把密钥,让你的网站能和 FloatPass 对话。
  • 配置回调地址和服务端凭据。
  • 创建要卖的商品(SKU,也就是一件件可以单独定价的东西)。
  • 把购买流程接到你的网站上。
  • 买家在你网站上完成购买时,把这笔购买报给 FloatPass,积分按这个记。
  • 中途出错时,把原来那一单撤回(也叫冲正)。

同时,指令也给 Agent 立了几条规矩:沿用你网站现有的登录和积分逻辑;不碰你已经有的订阅;密钥只放在服务端,不提交到 Git;正式上线和部署之前,先来问你。

把指令交给 Agent

在网站项目里打开 Claude Code 或 Codex,粘贴接入指令,让它开始。

批准 Agent 的授权

做到需要密钥那一步,Agent 会停下来给你一个 10 位的授权码。这一步是让你亲手确认:确实是你的 Agent 在要密钥。授权码 10 分钟内有效。

回到 FloatPass 页面的「Agent 授权」,在「授权码」里填上,点「查验」。页面会显示这次授权的范围:只能管理你本人的 FloatPass 资源。

看着没问题,点「授权创建密钥」。Agent 会拿到密钥,接着往下做。

先测试,再上线

让 Agent 先在测试环境里走一遍购买和退款。要正式上线或部署时,它会先跟你确认。

自己管理密钥

不想交给 Agent,也可以手动建密钥。在「密钥名称」里起个好认的名字,比如网站名,然后点「创建密钥」。

完整的密钥只显示这一次。 马上点「复制密钥」,存进你网站的服务端配置里。关掉之后,列表里只剩开头几位(前缀)。

列表里能看到每把密钥的名称、前缀和状态(「有效」或「已撤销」)。怀疑哪把泄露了,点「撤销密钥」,再建一把新的。

密钥能做什么,不能做什么

密钥只能管你自己的 FloatPass 资源,比如商品和回调。它不能发放积分,也动不了你账号里的积分和账户设置。所以就算泄露了,你的创造者积分也不会被拿走。不过还是请尽快撤销。

遇到问题?

提示「需要有效的创造者计划权益」。 账号还没加入创造者计划、计划过期了,或者资格被暂停了。到「创造者资格」页看看状态。

授权码填进去提示无效。 授权码只在 10 分钟内有效。让 Agent 重新发起一次,用新的码。

密钥找不到了。 完整密钥没法再看第二次。撤销旧的,建一把新的,再把网站配置里的那把换掉。

积分没显示。 先确认买家的购买真的完成了,再去「创造者数据」的「最近记录」里找 FloatPass 的记录。新记入的积分要等 30 天才能兑换。

接下来

本页目录