支付业务中涉及资金变动的接口重入规则梳理
2025/5/5大约 4 分钟
| 场景 | 重入订单字段 | 支持原单重入场景 | 建议换单重试场景 |
|---|---|---|---|
| 预下单 | 商户订单号（mercOrderNo） | 1、预下单失败 ，建议根据错误码排查后，原单重试。2、预下单成功，原单重试将幂等返回。如果prepayId有效期已有，则刷新prepayId的有效期。该笔订单状态以异步结果通知或同步查询接口里为准。 | 2. 如果订单已成功支付，或订单已过期时，订单状态将进入失败终态，无法支持原单重试。如需继续完成支付，则需要换单重试。 |
| 退款 | 商户退款订单（mercRefundOrderNo） | 1、发起退款请求失败，建议根据错误码（400000 RETRY_TOO_MANY错误码场景，需要换单重试）排查后，原单重试。 | 1. 400000 RETRY_TOO_MANY错误码场景，需要换单重试。2. 多次部分退款场景下，每次需要换单后发起请求。 |
| 预签约 | 商户签约协议号（mercContractCode） | 1、预签约失败 ，建议根据错误码排查，支持原商户签约订单号重试。2、预签约成功，原商户签约订单号重入，将刷新presignNo。该次签约请求状态以异步结果通知或同步查询接口里为准。 | 1、预签约号已完成用户签约后，需要更新商户签约订单号，建议换单重试。2、不同的用户签约，需要更新商户签约订单号。 |
| 申请代扣 | 商户订单号（mercOrderNo） | 1、代扣请求接口失败，根据错误码排查后，支持原商户订单号重试。2、代扣请求接口成功，原商户订单号重入，接口幂等返回。该笔订单状态以异步结果通知或同步查询接口里为准。 | 1、代扣请求成功，代扣订单查询或代扣回调通知扣款状态为TRX_FAILED，则订单进入失败终态。如需重新扣款时，需要换单重试。 |
| 商户分账 | 商户分账订单号（mercAllocOrderNo） | 1、请求分账接口失败，建议根据错误码排查后，支持同一商户分账订单号重入。2、请求分账接口成功，原商户分账订单号重入，接口会幂等返回。该笔订单状态以异步结果通知或同步查询接口里为准。 | 1、分账订单状态返为ALLOC_FAILED，则订单进入失败终态。如需重新分账，需要换单重试。 |
| 分账回收 | 商户分账回收订单号（mercReclaimOrderNo） | 1、请求分账回收接口失败，建议根据错误码排查后，支持原商户分账回收订单号重入。2、请求分账回收接口成功，原商户分账回收订单号重入，接口幂等返回。该笔订单状态以异步结果通知或同步查询接口里为准。 | 1、分账回收订单状态RECLAIM_FAILED，则订单进入失败终态。如需重新分账回收，需要换单重试。 |
| 请求补差 | 商户补差订单号（mercSubsidyOrderNo）} | 1、请求补差接口失败，建议根据错误码排查后，支持原商户补差订单号重入。2、请求补差接口成功，原商户补差订单号重入，接口幂等返回。 | 1、补差状态为FAILED时，则订单进入失败终态。如需重新发起补差，需要换单重试。 |
| 请求补差退款 | 商户补差退款订单号（mercSubsidyRefundOrderNo） | 1、请求补差接口失败，建议使用原补差退款订单号重入，避免可能出现重复补差退款等异常问题。2、请求补差接口成功，原补差退款订单号重入，接口幂等返回。 | 1、多次补差退款场景下，每次需要换单后发起请求。2、补差退款状态为FAILED，则订单进入失败终态。如需重新补差回退，需要换单重试。 |
| B2C转账 | 商户转账订单号（mercOrderNo） | 1、b2c转账失败，且未返回转账订单状态时，建议根据错误码排查后，支持原商户转账订单号重入。2、b2c转账成功，原单重试接口幂等返回，不会二次转账。 | 1、B2C转账订单状态为AG_PAY_FAILED，则订单进入失败终态。如需重新发起B2C转账，需要换单重试。 |
对开API文档中开放接口说明示例
https://developer.huawei.com/consumer/cn/doc/HMSCore-References/api-partner-base-payment-apply-refund-0000001594822654
贡献者
Yangxi