跳到主要内容
版本:当前指南

创建收款请求

能力状态与准备​

创建、查询、列出和关闭 Checkout 的商户路由已确认,实际权限以账户与目标环境为准。无代码后台和可复用支付链接的开放状态待确认。当前用服务端查询确认收款,不依赖 Webhook。

准备业务订单号、可信的应收金额、计价币种、可用收款方式和服务端凭据。普通商户操作人员请将本页交给技术负责人接入;不要将 API Key 填进网页、聊天或客户表单。

创建并交付收款入口​

  1. 在自己的订单系统保存订单、应收金额和币种。价格由服务端订单数据决定,不能让客户浏览器覆盖。
  2. 查询当前账户可用的收款方式,只选接口实际返回的完整“方式+币种+网络”组合。IPP 与直接 ERC-20 转账是不同方式。
  3. 在发送创建请求前,持久化这次付款尝试、请求参数和幂等键。幂等键是同一次操作重试时保持不变的标识;新业务操作才换新键。
  4. 创建 Checkout 后保存返回的 ID、真实 URL 和订单关联。同一业务订单可以有多个 Checkout,订单号本身不保证创建去重。
  5. 把该 URL 交付对应付款人;在商户订单页先验证其访问权限,再展示本订单付款状态。不要手工拼接收银台地址。
  6. 由服务端查询已保存的 Checkout,核对订单、金额、币种、主状态和资金异常。按订单指南安排一次履约。

接口请求格式由技术人员在开发者中心的商业支付“创建并确认第一笔收款”指南中核对;本页不提供未经确认的接口或参数。

请求中断后怎么做​

情况下一步
创建时超时,未收到 ID查找已保存的原操作;按有效幂等规则用原键和原参数恢复,不立即新建付款尝试
已有 Checkout ID,查询失败保留“结果待核对”,恢复查询;不改成“未付款”
客户重复点击付款查询原会话;processing 时提示等待,不要求再次转账
原会话为 open,客户回来付款在有效期内恢复原入口,先查询最新状态
会话已失败或关闭核对失败原因及是否有迟到资金,再由业务决定是否新建会话
收款方式为空或无权限核对环境、凭据与账户开放范围;不要自行改链或改币种试收

付款后需要记录什么​

保留订单与全部付款尝试的关联、应收数值、最新查询时间、异常处理结果及唯一履约记录。return_url 是“返回商户”的目的地,不是到账凭证,也不保证自动跳转。发货前继续阅读迟到、多付与少付;需要后台工具时阅读Checkout 与支付链接。