同步分账订单
接口说明
当分账订单状态为 processing(分账中)时,商户可主动调用本接口向支付通道发起状态同步,获取最新的分账结果。适用于通道异步推进缓慢、回调延迟或商户需要主动确认状态的场景。
请求地址
POST /unipay/sync/order/alloc
- 认证:RSA 签名(
@PaymentVerify) - 响应:
DaxResult<AllocSyncResult>
请求参数
基础参数同 统一支付 - 基础参数,业务参数:
| 参数 | 类型 | 必填 | 最大长度 | 描述 |
|---|---|---|---|---|
| allocNo | string | 否* | 100 | 平台分账单号 |
| bizAllocNo | string | 否* | 100 | 商户分账单号 |
*两个单号至少传一个,优先级:allocNo > bizAllocNo
请求示例
json
{
"mchNo": "M200000001",
"appId": "APP001",
"reqId": "REQ20241201031",
"reqTime": "2024-12-01 12:31:00",
"sign": "Base64签名值",
"allocNo": "A2024120112345700001"
}响应参数
DaxResult<AllocSyncResult>,data 字段结构:
| 参数 | 类型 | 描述 |
|---|---|---|
| orderStatus | string | 同步后的分账状态(AllocOrderStatusEnum) |
| adjust | boolean | 是否触发了状态调整(同步前后状态是否变化) |
响应示例
json
{
"code": 0,
"msg": "success",
"data": {
"orderStatus": "success",
"adjust": true
},
"sign": "Base64签名值",
"resTime": "2024-12-01 12:31:00",
"reqId": "REQ20241201031"
}