为保证回调请求的可靠性,系统具备重试机制,所以可能出现重发的通知。
承载协议 | 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 | 签名所使用的证书编号。 |
mercRefundNo | 是 | String | 商户退款订单号。 |
sysRefundNo | 是 | String | 华为支付退款订单号。 |
refundAmount | 是 | long | 退款总金额,单位:分。 |
payerRefundAmount | 是 | long | 退款给用户的金额,单位:分。 |
promotionRefundAmount | 是 | long | 营销退款金额,单位:分。 |
currency | 是 | String | 交易币种单位,最大长度为3。
|
mercNo | 否 | String | 商户号。 |
finishTime | 否 | String | 退款完成时间,UTC时间格式(yyyy-MM-dd'T'HH:mm:ss.SSSZ)。 |
refundOrderStatus | 是 | String | 退款订单状态。
|
payload | 否 | String | 预留信息,如商户请求时传递该参数,此时会原样返回。 |
POST /opengw/merc/v1/transactions/result HTTP/1.1
Content-Type: application/json;charset=UTF-8
{
"callbackId": "f2eff0509b864125bc3ea5485260851b",
"callbackTime": "2023-03-29 09:52:37",
"currency": "CNY",
"dataType": "plain",
"finishTime": "2023-02-23T10:05:17.000+0800",
"mercNo": "101723200xxx",
"mercRefundNo": "fztk2022083001",
"payerRefundAmount": 100,
"payload": "example-payload",
"promotionRefundAmount": 10,
"refundAmount": 100,
"refundOrderStatus": "REFUND_SUCCESS",
"sign": "MEYCIQD8RlHJ9tGmc2tass32BgGgRbV********************2KxxldbJA2GYpU7nDIJCYHcZpBY1ffr21wgjQ2l",
"signType": "SM2",
"certNo": "10132120***",
"sysRefundNo": "1230223100516008511858780002"
} 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
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."
}