申请分账

功能介绍

华为支付系统支付成功后的订单，可由分账发起方调用此接口发起分账请求，将订单收款的资金分账给接收方商户。

1、一笔订单申请一次或者多次分账请求，每次分账请求可以添加多个分账规则，但只会返回一个成功或者失败的请求标识。

2、分账完成的订单不能再次发起分账。

3、分账金额不能超过最大分账比例对应的金额。

使用约束

换单重试，视为新的业务订单，需开发者自行将新的业务订单关联业务原订单。接口重入规则说明如下（供参考）：

接口原型

请求参数

• Request Header

  参数	是否必选	参数类型	描述
  Content-Type	是	String	取值为：application/json; charset=UTF-8
  PayMercAuth	是	String	取值为：PayMercAuth的JSON串

• Request Body

  参数	是否必填	参数类型	描述
  mercAllocOrderNo	是	String	商户分账订单号，由商户自己生成，商户需保证订单信息唯一性。最大长度46。
  sysTransOrderNo	是	String	华为支付系统订单号。
  allocationDetails	是	List<MercAllocRuleDetail>	分账详情。 说明： 金额总和，不能超过配置/默认最大分账比例
  allocFinish	否	boolean	分账完结标识。详见“解冻剩余分账金额”部分。 true：完结分账 false：不完结分账（默认） 说明： 超过180天分账未完结，系统自动发起分账指令，全部分给收单方
  callbackUrl	是	String	回调通知地址，最大长度512。
  payload	否	String	商户预留信息，最大长度255。

• 请求示例

  POST /api/v1/allocation/orders
  Content-Type: application/json;charset=UTF-8
  PayMercAuth: {"callerId":"10132120***","traceId":"202307260838511046791","time":1690331931382,"authId":"120291744647139***","headerSign":"3P4ucKr5UvIaUTk5msgVpNr0NMSKLvQtRwzFWeLMouuJu4nHCL4Kd4eSMHEH2AxVQlwPcU********************D6FdC7tkBPIgRkGaSq/4BSh0sQfG0wyOiA3suYe223Jl7HBy4cySl4x56yD0=","bodySign":"EvZS2tli2PG7OsjAcOxCrNcgpeVfzWtnsJDBcN4YnwUQANEN9Unb8ahaN2********************PxoKIRGSbuqg+O8lSmlKmpFV6itYX/FK/R5ag3vN9AqBMbHjz+lb3scgoHPvprKJ6KphPh0YTPIS9+xqY="}
  Accept: application/json
  {
    "mercAllocOrderNo": "Demo_1690331931205",
    "sysTransOrderNo": "12407030857530004914518***",
    "allocationDetails": [
      {
        "fromMercNo": "102752210***",
        "toMercNo": "103732320***",
        "amount": 1
      }
    ],
    "allocFinish": false,
    "callbackUrl": "https://www.xxxxxx.com/hw/pay/callback/callback",
    "payload": "example-payload"
  }

响应参数

• Response Header

  参数	是否必选	参数类型	描述
  Content-Type	是	String	取值为：application/json; charset=UTF-8

• Response Body

  参数	是否必选	参数类型	描述
  resultCode	是	String	返回码，"000000"表示成功，其他表示见错误码
  resultDesc	是	String	结果描述
  subCode	否	String	业务错误码
  subDesc	否	String	业务错误描述信息
  sign	是	String	签名值
  sysAllocationOrderNo	是	String	华为支付分账订单号

• 响应示例

  HTTP/1.1 200 OK
  Content-Type: application/json; charset=UTF-8
  {
    "resultCode": "000000",
    "resultDesc": "Success.",
    "sign": "MEQCIEIWzdpziRyTi8vhwWHFuDdxfsiw********************0YAMabeCgTDG77e+2XJItvq/ZkIcCN5/B20pQ==",
    "sysAllocationOrderNo": "1241023181702089457838601***"
  }

错误码

(resultCode非400000的错误码请看公共错误码说明)