订单已经分账,可以调用此接口,将已分账的资金从分账接收方账户回退给收单方,再发起退款。
换单重试,视为新的业务订单,需开发者自行将新的业务订单关联业务原订单。接口重入规则说明如下(供参考):
重入判定字段 | 支持原单重入场景 | 建议换单重试场景 |
|---|---|---|
商户分账回收订单号(mercReclaimOrderNo) |
| 分账回收订单状态RECLAIM_FAILED,则订单进入失败终态。如需重新分账回收,需要换单重试。 |
承载协议 | HTTPS POST |
|---|---|
接口方向 | 开发者服务器-> 华为支付服务器 |
接口URL | https://petalpay-developer.cloud.huawei.com.cn/api/v1/allocation/reclaim/orders |
数据格式 | 请求消息:Content-Type: application/json 响应消息:Content-Type: application/json |
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
Content-Type | 是 | String | 取值为:application/json; charset=UTF-8 |
PayMercAuth | 是 | String | 取值为:PayMercAuth的JSON串 |
参数 | 是否必填 | 参数类型 | 描述 |
|---|---|---|---|
mercReclaimOrderNo | 是 | String | 商户分账回收订单号,由商户自己生成,商户需保证订单信息唯一性。建议采用。 |
sysTransOrderNo | 是 | String | 华为支付系统订单号。 |
mercAllocationOrderNo | 否 | String | 商户分账订单号。 |
sysAllocationOrderNo | 否 | String | 华为支付分账订单号, 和mercAllocOrderNo二选一。 |
reclaimAllocDetails | 是 | List<MercAllocRuleDetail> | 分账回收详情列表。 说明:
|
callbackUrl | 是 | String | 回调通知地址。 |
payload | 否 | String | 商户预留信息。 |
POST /api/v1/allocation/reclaim/orders
Content-Type: application/json;charset=UTF-8
PayMercAuth:
{"traceId":"20230725070600048","headerSign":"cTftnyyJ4fx0Xb7HGttv8j6nP4c4PPVcu0D6fm03Krz5r4P3MUq+19MZHMbKhnJdfrkTHJmxCzraGft6fb35CJRum9Lsc98qfodWSWPyeXv00LxXoVqlLgSd0CRJu84K2mFZ9+b5MmKTiqleJV9WNLDcl9VUIapRfRRUwUX+688zwA********************YeISkl+NTddlOXRYN9qlsL23RM/vdZLC6EHAQsR9BfpQVaDZy5Q2dKUrQ5H0Cyc5bBAQ=","bodySign":"X4agTBBraWqGTX3dW9rEYi0X4riY1RJQmVKYtT/P3x0m5VuNd19********************yvdepLUsltS3KlPhaEUnptIUi/KNK3OPP4Jz1buTPHWGlYOc8EF5V1QyRVlsDLIZ39ml8xaScPjFf5Ej3VrUiAoP0rMlCCTeF0ZAWLz3D0aUoRqHAiI=","callerId":"10132120***","time":1690240008474,"authId":"120291744647139***"}
Accept: application/json
{
"mercReclaimOrderNo": "Demo_1690331931205",
"sysAllocationOrderNo": "1230523110241006100003255580",
"sysTransOrderNo": "12407030857530004914518***",
"reclaimAllocDetails": [
{
"fromMercNo": "102752210***",
"toMercNo": "103732320***",
"amount": 1
}
],
"callbackUrl": "https://www.xxxxxx.com/hw/pay/callback/callback",
"payload": "example-payload"
} 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
Content-Type | 是 | String | 取值为:application/json; charset=UTF-8 |
参数 | 是否必填 | 参数类型 | 描述 |
|---|---|---|---|
resultCode | 是 | String | 结果码,"000000"表示成功,其他表示失败 |
resultDesc | 是 | String | 结果描述 |
subCode | 否 | String | 业务错误码 |
subDesc | 否 | String | 业务错误描述信息 |
sign | 是 | String | 签名值 |
sysReclaimAllocOrderNo | 否 | String | 华为支付分账回收订单号 |
HTTP/1.1 200 OK
Content-Type: application/json; charset=UTF-8
{
"resultCode": "000000",
"resultDesc": "Success.",
"sign": "MEYCIQClBklYA5DzvZZouoF6ltkMk********************AME0GFesTTKtWFLLyvfUXrIE8+VBrnFBe/SzINQzmrjr",
"sysReclaimAllocOrderNo": "1230725070648014369172951783"
} (resultCode非400000的错误码请看公共错误码说明)
resultCode | resultDesc | subCode | subDesc |
|---|---|---|---|
400000 | 业务处理失败 | INVALID_ARGUMENTS | 参数不合法 |
400000 | 业务处理失败 | CHECK_ORDER_STATUS | 订单状态异常 |
400000 | 业务处理失败 | UNKNOW_ERROR | 服务暂不可用,请稍后重试 |
400000 | 业务处理失败 | ORDER_NOT_SUPPORT | 订单不支持分账 |
400000 | 业务处理失败 | CHECK_TRANSACTION_ORDER_STATUS | 交易订单状态异常 |
400000 | 业务处理失败 | NEED_CHANGE_ORDER | 请换单重试 |
400000 | 业务处理失败 | MERC_ORDER_NOT_EXIST | 商户订单号不存在 |
400000 | 业务处理失败 | ALLOCATION_FINISH | 分账已完结 |
400000 | 业务处理失败 | ALLOCATION_AMOUNT_ERROR | 分账金额异常 |
400000 | 业务处理失败 | INVALID_MERC_NO | 无效商户号 |
400000 | 业务处理失败 | CHECK_MERC_STATUS | 商户状态异常 |
400000 | 业务处理失败 | MERC_NOT_SUPPORT_ALLOCATION | 商户不支持分账 |
400000 | 业务处理失败 | CHECK_ALLOCATION_MERC | 分账接收方商户号不合法 |