为保证回调请求的可靠性，系统具备重试机制，可能会出现重发的通知。
为保证信息合法性，开发者需要对返回的支付信息进行SM2验签，验签注意事项：
- 需直接使用通知的完整内容进行验签。
- 验签前需要对返回数据进行排序拼接，sign字段是签名值，排序拼接后的待验签内容需要排除sign字段。
- 验签公钥使用华为支付证书。
退款状态需根据refundOrderStatus字段判断。

场景描述

一笔订单退款成功后，华为支付服务器会调用开发者的应用/元服务在申请退款接口中传递的回调接口（callbackUrl）传递给开发者退款订单具体信息。

接口原型

承载协议： HTTPS POST
接口方向： 华为支付服务器 -> 开发者服务器
接口URL： URL由开发者在请求申请退款接口时传递的callbackUrl参数决定
数据格式：

请求消息：Content-Type: application/json; charset=UTF-8

响应消息：Content-Type: application/json; charset=UTF-8

请求参数

Request Body

展开

参数	是否必选	参数类型	描述
callbackId	是	String	回调通知的唯一ID。
callbackTime	是	String	回调通知时间。格式为yyyy-MM-dd HH:mm:ss。
dataType	是	String	数据加密类型标识。 - encrypt：加密 - plain：未加密
sign	是	String	回调通知结果签名，除“sign”字段以外的其他字段参与签名。开发者可参考验签规则对回调报文进行验签处理。
signType	是	String	签名类型。华为支付生成签名字符串使用的算法，当前为SM2算法。
certNo	否	String	签名所使用的证书编号。
mercRefundNo	是	String	商户退款订单号。
sysRefundNo	是	String	华为支付退款订单号。
refundAmount	是	Long	退款总金额。订单需要退款的金额，该金额不能大于订单金额，单位：分。说明：如果正向交易使用了营销，该退款金额包含营销金额，华为支付会按业务规则分配营销和买家自有资金分别退多少，默认按比例退款。如不填则默认全额退款。
payerRefundAmount	是	Long	退款给用户的金额，单位：分。
promotionRefundAmount	是	Long	营销退款金额，单位：分。
currency	是	String	交易币种单位，最大长度为3。 CNY （默认，当前仅支持该币种单位）
mercNo	否	String	商户号。
finishTime	否	String	退款完成时间，UTC时间格式（yyyy-MM-dd'T'HH:mm:ss.SSSZ）。
refundOrderStatus	是	String	退款订单状态。 - REFUND_CHL_PROC：处理中 - REFUND_SUCCESS：成功 - REFUND_FAILED：失败
payload	否	String	预留信息，如商户请求时传递该参数，此时会原样返回。

请求示例

POST /hw/pay/callback HTTP/1.1
Content-Type: application/json;charset=UTF-8
{
  "callbackId": "124070308575300049145189***",
  "callbackTime": "2023-03-29 09:52:37",
  "currency": "CNY",
  "dataType": "plain",
  "finishTime": "2023-02-23T10:05:17.000+0800",
  "mercNo": "10132120***",
  "mercRefundNo": "czl00120240705***",
  "payerRefundAmount": 100,
  "payload": "example-payload",
  "promotionRefundAmount": 10,
  "refundAmount": 100,
  "refundOrderStatus": "REFUND_SUCCESS",
  "sign": "MEYCIQD8RlHJ9tGmc2*******************GYpU7nDIJCYHcZpBY1ffr21wgjQ2l",
  "signType": "SM2",
  "certNo": "120291744647139***",
  "sysRefundNo": "1230223100511858780002***"
}

响应参数

Response Header

展开

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

Response Body

展开

参数	是否必选	参数类型	描述
resultCode	是	String	响应码。华为支付侧解析application/json类型响应。 “000000”表示成功，其他值表示失败，如返回值格式不匹配或非“000000”将视为回调失败。
resultDesc	是	String	结果描述。

响应示例

HTTP/1.1 200 OK
Content-Type: application/json; charset=UTF-8
{
  "resultCode": "000000",
  "resultDesc": "Success."
}

意见反馈

以上内容对您是否有帮助？

意见反馈

如果您有其他疑问，您也可以通过开发者社区问答频道来和我们联系探讨。

社区提问智能客服提问