Skip to main content
Waffo Point Topup 是 Waffo 的点卡充值 API 与白标点卡充值方案。作为供应商（Supplier），你把自己的点卡库存或充值能力接进来，Waffo Point Topup 代为运营面向终端用户的销售侧：独立子域名上的多语言店面、全球支付方式、作为该笔销售的 merchant-of-record，以及定期结算。 本组文档面向供应商的技术接入。产品视角的介绍见点卡充值。

​
术语

​
三种集成模式

按供应商系统条件选择 Waffo Point Topup 集成模式的决策图

在线 Demo 站点

想看这三种模式实际怎么跑，可以在 Demo 站点走完整的端到端流程。

​
模式对比

​
谁提供哪些接口

Waffo 侧只提供两个接口和一个 Webhook，它们在 API 参考 的「点卡充值」分组中。 供应商侧的接口全部是可选集成：本文档给出的规范只是示例。如果你已有等价的接口，直接把自己的接口文档给 Waffo Point Topup，Waffo 会适配你的既有接口。
Mode C 的最小集成是「GET /redirect 签名跳转 + 履行结果通知 Webhook」，不实现任何履行接口。这种情况下 Webhook 只会返回 PAY_SUCCESS 与 PAYMENT_FAILED 两种状态，由你在收到 PAY_SUCCESS 后走自己的发货流程。

​
按模式看接入准备

需要供应商提供的材料：接入步骤：
1

提供点卡数据

供应商以 Excel/CSV 离线提供点卡数据。
2

导入库存

Waffo Point Topup 把点卡导入库存系统。
3

拿到购买链接

Waffo Point Topup 向供应商提供购买链接。
4

埋设链接

供应商在自己的网站上埋设购买链接。
5

发货

用户购买后，Waffo Point Topup 把点卡发送到用户邮箱。
6

结算

Waffo Point Topup 提供定期结算报表。
详见 Mode A：离线点卡导入。
需要供应商提供的材料：接入步骤：
1

交换 RSA 公钥

供应商与 Waffo Point Topup 互换 RSA 公钥。
2

提供 API 资料

供应商提供 API Key 与接口文档。
3

联调

联调点卡获取 API。
4

拿到购买链接

Waffo Point Topup 提供购买链接（静态链接）。
5

埋设链接

供应商在自己的网站上埋设链接。
6

上线

正式上线。
详见 Mode B：点卡获取 API。
需要供应商提供的材料：接入步骤：
1

交换 RSA 公钥

供应商与 Waffo Point Topup 互换 RSA 公钥。
2

提供密钥与资料

供应商提供 SECRET_KEY、API Key 与接口文档。
3

实现 URL 签名

供应商在后端实现 URL 签名逻辑。
4

联调

联调 URL 签名验证、即时履行 API、查询 API（可选）、履行结果通知 Webhook（可选）。
5

埋设跳转链接

供应商在网站上集成带签名的跳转链接。
6

上线

正式上线。
详见 Mode C：即时履行 API。

​
下一步

Mode A：离线点卡导入

点卡 CSV 格式、购买链接埋点与结算报表。

Mode B：点卡获取 API

实时点卡获取接口的请求、响应与幂等要求。

Mode C：即时履行 API

URL 签名跳转、即时履行与履行结果查询。

API 共通规范

消息结构、RSA 签名验签、错误码与密钥生成。