Skip to content

同步分账订单

更新时间:2026/9/11 20:21:59

接口说明

当分账订单状态为 processing(分账中)时,商户可主动调用本接口向支付通道发起状态同步,获取最新的分账结果。适用于通道异步推进缓慢、回调延迟或商户需要主动确认状态的场景。

请求地址

POST /unipay/sync/order/alloc

  • 认证:RSA 签名(@PaymentVerify
  • 响应:DaxResult<AllocSyncResult>

请求参数

基础参数同 统一支付 - 基础参数,业务参数:

参数类型必填最大长度描述
allocNostring否*100平台分账单号
bizAllocNostring否*100商户分账单号

*两个单号至少传一个,优先级:allocNo > bizAllocNo

请求示例

json
{
  "mchNo": "M200000001",
  "appId": "APP001",
  "reqId": "REQ20241201031",
  "reqTime": "2024-12-01 12:31:00",
  "sign": "Base64签名值",
  "allocNo": "A2024120112345700001"
}

响应参数

DaxResult<AllocSyncResult>data 字段结构:

参数类型描述
orderStatusstring同步后的分账状态(AllocOrderStatusEnum
adjustboolean是否触发了状态调整(同步前后状态是否变化)

响应示例

json
{
  "code": 0,
  "msg": "success",
  "data": {
    "orderStatus": "success",
    "adjust": true
  },
  "sign": "Base64签名值",
  "resTime": "2024-12-01 12:31:00",
  "reqId": "REQ20241201031"
}

使用建议

  • 同步是幂等操作,可重复调用,不会重复分账或重复通知。
  • 同步触发状态变更后,平台会按 异步回调 流程重新发送通知(事件 alloc.success / alloc.fail)。
  • 分账终态(success / partial / fail)确定后同步将不再调整状态,可结合 adjust 判断。
  • 分账单详情(含各接收方明细结果)可调用 分账订单查询 获取。

官方网站 · 基于 GNU LGPL v3.0 协议开源