跳到主要内容

商业支付开发指南

使用服务端商户 API 接收付款、查询结果,并在能力开通后处理通知、退款与资金归集。Checkout 是一次收款会话,关联你的业务订单并提供收银台链接。指南按业务任务组织,资源与操作的字段说明见 API 参考。

阅读前可先核对商户收款术语,区分订单、Checkout 和付款项。

先完成收款闭环​

准备服务端 → 创建 Checkout → 交付收银台链接 → 服务端查询状态 → 按订单幂等履约。

付款人从收银台返回你的页面,不代表付款成功。当前接入应以服务端查询为基础,不把尚待确认的 Webhook 当成唯一通知渠道。

选择任务​

任务指南API
查询可用收款方式、创建收款第一笔收款收款方式、创建 Checkout
处理支付状态与异常状态及异常查询 Checkout
发货、交付内容或开通服务查询确认与幂等履约列出 Checkout
接收事件Webhook 验签与处理通知端点与事件,开放待确认
退款、退差价与重复付款退款流程付款明细、退款,开放待确认
将 IPP 入款归集到钱包归集流程归集项与任务,执行支持待确认

先核对可用范围​

接口开放状态逐项区分商户路由已确认、执行支持待确认与开放待确认。使用前确认目标环境和账户支持所需操作。当前最小闭环是创建、查询与订单对账。

金额使用币种本身的十进制字符串,例如 "10" USDC。商户开发者无需管理零知识证明或协议凭证。若要直接集成协议或自建 Facilitator,请查看开放协议,原生协议接口与本节的商户 API 分别接入。

上线前完成测试与上线检查,不要把文档中的演示响应当成真实结果。