为保证回调请求的可靠性,系统具备重试机制,所以可能出现重发的通知。
承载协议 | HTTPS POST |
|---|---|
接口方向 | 华为支付服务器 -> 开发者服务器 |
接口URL | URL由开发者在请求申请分账回收接口时传的callbackUrl |
数据格式 | 请求消息:Content-Type: application/json 响应消息:Content-Type: application/json |
参数 | 是否必填 | 参数类型 | 描述 |
|---|---|---|---|
callbackId | 是 | String | 回调通知的唯一ID。 |
callbackTime | 是 | String | 回调通知时间。 |
dataType | 是 | String | 数据加密类型标识。
|
sign | 是 | String | 回调通知结果签名,除“sign”字段以外的其他字段参与签名。 |
signType | 是 | String | 签名类型。华为支付生成签名字符串使用的算法,当前为SM2算法。 |
certNo | 否 | String | 签名所使用的证书编号。 |
sysAllocationOrderNo | 是 | String | 华为支付分账订单号。 |
sysTransOrderNo | 是 | String | 华为支付系统订单号。 |
mercOrderNo | 是 | String | 商户交易订单号。 |
mercReclaimOrderNo | 否 | String | 商户分账回收订单号。 |
orderStatus | 是 | String | 订单状态。
|
finishTime | 是 | String | 完成时间,UTC时间格式(yyyy-MM-dd'T'HH:mm:ss.SSSZ)。 |
reclaimAllocRule | 是 | List<MercAllocRuleDetail> | 回收分账规则。 |
payload | 否 | String | 创建交易订单时带过来(原样带回)。 |
extInfo | 否 | String | 附加信息。 |
POST /opengw/merc/v1/transactions/result HTTP/1.1
Content-Type: application/json;charset=UTF-8
{
"callbackId": "445444555555",
"mercOrderNo": "md_czl00120241023181***",
"callbackTime": "2023-03-29 09:29:14"
"mercReclaimOrderNo": "merc_123456",
"orderStatus": "RECLAIM_SUCCESS",
"finishTime": "2023-03-29T09:28:44.000+0800",
"payload": "example-payload",
"dataType": "plain",
"reclaimAllocRule": [
{
"amount": 100,
"fromMercNo": "102752210***",
"toMercNo": "103732320***"
}
],
"signType": "SM2",
"certNo": "10132120***",
"sign": "MEUCIQDoLjokddqBkcfJSmANgxo7Fi0M********************31ABMx85CxH7I65M45YE6G0oTKcftPn1YsiYcmU=",
"sysAllocationOrderNo": "123456666",
"sysTransOrderNo": "12407030857530004914518***"
} 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
Content-Type | 是 | String | 取值为:application/json; charset=UTF-8 |
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
resultCode | 是 | String | 华为支付侧解析application/json类型响应,“000000”表示成功,其他值失败,如返回值格式不匹配或非“000000”将视为失败。 |
resultDesc | 是 | String | 结果描述。 |
HTTP/1.1 200 OK
Content-Type: application/json; charset=UTF-8
{
"resultCode": "000000",
"resultDesc": "Success."
}