单号说明
通过 APO 集成收单机构 后,与商户直连机构的模式相比,订单号的管理方式发生了一些变化。您需要根据不同的接入方式,维护适配的订单号体系。
- 商户直连收单机构:商户侧需要维护以下字段信息:
- 商户订单号(merchantId)
- 商户请求机构支付单号(paymentRequestId)
- 机构订单号(acquirerInfo.acquirerTransactionId)
- 商户通过 APO 连接收单机构:商户侧需要维护以下字段信息:
- 商户订单号(merchantId)
- 商户请求 APO 支付单号(paymentRequestId)
- APO 订单号(paymentId)
- APO 请求机构订单号(acquirerInfo.referenceRequestId)
- 机构订单号(acquirerInfo.acquirerTransactionId)
机构订单号的常见使用场景
对账
如果您对账时使用机构提供的原始报告(通常包含机构侧订单号),那么您需要存储接口中返回的 acquirerInfo.referenceRequestId、acquirerInfo.acquirerTransactionId 参数的值。通过上述信息,您的财务人员可以将机构订单号与商家订单号进行匹配,实现高效对账。
争议
若卡支付发生争议,您需要直接与收单机构协商处理。收单机构会提供给您机构侧订单号,此时您有以下两种方法可以查到商家侧的单号信息:
- 建议您存储接口返回的 acquirerInfo.referenceRequestId、acquirerInfo.acquirerTransactionId 参数的值,运营人员则可以直接通过机构侧订单号在内部平台查询对应商家的订单号。
- 您可以登录 APO Dashboard 输入机构侧订单号查询到对应商家侧的单号。