商业支付开发指南
使用服务端商户 API 接收付款、查询结果,并在能力开通后处理通知、退款与资金归集。Checkout 是一次收款会话,关联你的业务订单并提供收银台链接。指南按业务任务组织,资源与操作的字段说明见 API 参考。
阅读前可先核对商户收款术语,区分订单、Checkout 和付款项。
先完成收款闭环
准备服务端 → 创建 Checkout → 交付收银台链接 → 服务端查询状态 → 按订单幂等履约。
付款人从收银台返回你的页面,不代表付款成功。当前接入应以服务端查询为基础,不把尚待确认的 Webhook 当成唯一通知渠道。
选择任务
| 任务 | 指南 | API |
|---|---|---|
| 查询可用收款方式、创建收款 | 第一笔收款 | 收款方式、创建 Checkout |
| 处理支付状态与异常 | 状态及异常 | 查询 Checkout |
| 发货、交付内容或开通服务 | 查询确认与幂等履约 | 列出 Checkout |
| 接收事件 | Webhook 验签与处理 | 通知端点与事件,开放待确认 |
| 退款、退差价与重复付款 | 退款流程 | 付款明细、退款,开放待确认 |
| 将 IPP 入款归集到钱包 | 归集流程 | 归集项与任务,执行支持待确认 |
先核对可用范围
接口开放状态逐项区分商户路由已确认、执行支持待确认与开放待确认。使用前确认目标环境和账户支持所需操作。当前最小闭环是创建、查询与订单对账。
金额使用币种本身的十进制字符串,例如 "10" USDC。商户开发者无需管理零知识证明或协议凭证。若要直接集成协议或自建 Facilitator,请查看开放协议,原生协议接口与本节的商户 API 分别接入。
上线前完成测试与上线检查,不要把文档中的演示响应当成真实结果。