Billing 管理控制台 →
为你的产品接入预付费

让用户先充值,
再按实际用量付费。

Billing 帮你的产品管理购买、余额和扣费。你的用户在产品里充值和使用服务,你在后台查看每一笔额度的去向。

当前以测试环境验证流程,提供预付额度包和用后上报的按量计费。真实产品与生产收款需要另行接入。

接入我的产品

从连接成功,到第一笔用量。

在你的产品后端接入。产品负责用户登录和实际服务,Billing 负责额度与账务。

01 / 产品开发者

接入我的产品

准备连接配置,交给开发 Agent,或跟着指南完成第一次调用。

查看接入步骤 →
02 / 先了解流程

体验充值与扣费

无需登录,看看用户余额如何随充值、用量上报和再次充值变化。

开始交互演示 →
03 / 负责人

管理控制台

登录已部署的服务,管理测试用户、订单、退款和额度流水。

查看登录方式 →
  1. 拿到服务地址和产品配置

    负责人在「开发接入」签发本产品的密钥,存进后端私有的 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 -。

    查看签发密钥与交付 →
  2. 在你的产品项目里验证连接

    用产品 Key 请求一次 /v1/capabilities,actions 含 usage.record、balance.read 即说明服务地址和产品身份可用(checkout.create 只在配置 Stripe 后出现)。几条 curl 就能接完:连接、在你的购买页建单、上报用量、读余额。

    打开分步指南与可执行命令 →
  3. 完成一次测试用量,再接入业务

    用有额度的测试用户上报一次用量,核对余额减少;用同一 event_id 重复上报不会重复扣费。TypeScript 后端用公开 SDK github:flyresearch/billing-sdk#v0.12.0(createBillingClient / createMeter),其他语言直接调用 POST /v1/users/{user}/usage。接着在你的产品中接入充值入口、余额显示与用量上报。

    计量单位和费率由产品配置。产品后端负责可信计量,在用量发生后上报,平台负责扣减与记账。余额可以变为负数;返回 allowed=false 时应停止服务,下次充值先抵扣欠额。也可上架按月订阅的档位,每月额度先于额度包使用。

    查看产品侧需要实现的功能 →
让开发 Agent 帮你接入

复制说明到你的产品开发任务

补上产品需求和配置文件路径。配置中的密钥留在后端文件里,无需粘贴到对话或此页面。

查看 API 文档 →
体验充值与扣费

用一笔示例余额,走完使用过程。

这是浏览器内的交互演示,不创建订单、不改变账户余额。数字为示意额度,与当前商品价格无关。

示意演示 · 本页数字由浏览器生成,不连接服务,也不产生任何记录

  1. 1. 充值
  2. 2. 用后上报
  3. 3. 欠额与再充值
余额0
累计充值0
已消费0

先为账户充值

点击下面的按钮,为示例账户加入 100 额度。

看懂了流程?开始接入产品 → · 想在实际测试账本操作?登录管理控制台 →