从连接成功,到第一笔用量。
在你的产品后端接入。产品负责用户登录和实际服务,Billing 负责额度与账务。
接入我的产品
准备连接配置,交给开发 Agent,或跟着指南完成第一次调用。
查看接入步骤 →02 / 先了解流程体验充值与扣费
无需登录,看看用户余额如何随充值、用量上报和再次充值变化。
开始交互演示 →03 / 负责人管理控制台
登录已部署的服务,管理测试用户、订单、退款和额度流水。
查看登录方式 →-
拿到服务地址和产品配置
负责人在「开发接入」签发本产品的密钥,存进后端私有的
product.json,再复制接入说明交给开发者。需要验证用量时,在「测试体验」另行准备测试用户;复制说明不会改变数据。当前浏览器访问的服务:
当前服务地址。产品后端需要能访问此地址;使用 127.0.0.1 时须在同一台机器上运行。我自己部署了 Billing,配置在哪里?
用部署配置 BILLING_OWNERS 里列出的负责人邮箱登录控制台(首次登录自动开通)。新部署里还没有产品:先在「产品」页新建一个,再在它的「开发接入」页签发密钥。密钥只显示一次,复制后连同服务地址存入后端私有的 product.json(base_url、api_key)。
把这个私有文件交给产品后端,用一次只读的 capabilities 请求核对(密钥经 stdin 交给 curl,不出现在命令行参数里):
查看签发密钥与交付 →jq -r '"header = \"Authorization: Bearer \(.api_key)\"\nurl = \"\(.base_url)/v1/capabilities\""' /absolute/private/path/product.json | curl -fsS -K -。 -
在你的产品项目里验证连接
用产品 Key 请求一次
打开分步指南与可执行命令 →/v1/capabilities,actions含usage.record、balance.read即说明服务地址和产品身份可用(checkout.create只在配置 Stripe 后出现)。几条 curl 就能接完:连接、在你的购买页建单、上报用量、读余额。 -
完成一次测试用量,再接入业务
用有额度的测试用户上报一次用量,核对余额减少;用同一
event_id重复上报不会重复扣费。TypeScript 后端用公开 SDKgithub:flyresearch/billing-sdk#v0.12.0(createBillingClient/createMeter),其他语言直接调用POST /v1/users/{user}/usage。接着在你的产品中接入充值入口、余额显示与用量上报。计量单位和费率由产品配置。产品后端负责可信计量,在用量发生后上报,平台负责扣减与记账。余额可以变为负数;返回
查看产品侧需要实现的功能 →allowed=false时应停止服务,下次充值先抵扣欠额。也可上架按月订阅的档位,每月额度先于额度包使用。
复制说明到你的产品开发任务
补上产品需求和配置文件路径。配置中的密钥留在后端文件里,无需粘贴到对话或此页面。
用一笔示例余额,走完使用过程。
这是浏览器内的交互演示,不创建订单、不改变账户余额。数字为示意额度,与当前商品价格无关。
示意演示 · 本页数字由浏览器生成,不连接服务,也不产生任何记录
- 1. 充值
- 2. 用后上报
- 3. 欠额与再充值
先为账户充值
点击下面的按钮,为示例账户加入 100 额度。