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

订单与对账

能力状态与判断依据​

当前通过服务端查询 Checkout 确认支付。后台订单列表的开放状态待确认;如果已开通,可用它定位订单,但履约仍需核对权威支付结果。付款已发送、收款成功、订单已履约、资金已归集分别记录。

找到并核对一笔订单​

  1. 在自己的订单系统定位业务订单号;后台若可用,按订单号与时间筛选。
  2. 找出该订单关联的全部 Checkout,而非只看最新一次。记录测试/正式环境,避免查错账户。
  3. 从服务端读取已绑定的 Checkout,核对 ID、业务订单、应收金额与币种;有实际付款网络信息时一并核对。
  4. 检查主状态及 exception_status。查询失败只表示结果未知,保留既有支付事实。
  5. 检查是否已发货、开通权益或生成交付任务,再决定下一步。
Checkout 状态处理方式
open等待付款,在有效期内可恢复原入口
processing已检测到付款上链,等待确认;不引导重复支付
succeeded达到该会话的确认要求;核对金额、币种、关联及异常后才能履约
failed查看失败原因;不把随后到账直接改为原会话成功

succeeded 和 failed 是终态,退款、迟到资金和后续异常不会翻转主状态。没有异常也可能尚未付款,不能单看 exception_status 为空。

确认后只履约一次​

将支付确认和履约分开。技术负责人应按业务订单建立唯一履约任务,使轮询、重复通知及多个成功 Checkout 都指向同一交付结果;仓库、权益和内容交付也要能按同一业务标识重试。

操作人员遇到“已收款但未发货”时,先查询支付与履约任务,不要让客户重付。履约中断则恢复原交付任务;两个 Checkout 都成功也只交付订单约定的一份,额外资金进入异常处理。

每日对账步骤​

  1. 固定时区、起止时间、环境和币种,保留本次对账范围。
  2. 关联订单、全部 Checkout、可查询的付款、退款和归集记录。不要将它们直接相加当成收入。
  3. 比较应收、确认收款、退款、费用与实际到账;按费用指南逐资产核对。
  4. 将“结果未知、资金异常、已收未履约、已履约待核对、退款进行中、归集未完成”分开列出,指定负责人和下次复核时间。
  5. 保存差异解释与最终处理结果;后续到账或退款发生时补充记录,不覆盖原事实。

隐私支付不保证公开付款人地址或全部链上细节;不要为了补齐表格而推断钱包身份。报表汇总口径见报表与经营分析。