1.4 退款回调接口

HTTP请求信息

URL

由商户提供

请求方式

POST

Content-Type

application/json

请求体参数

参数名	必选	类型	说明
param	是	string	参数体
sign	是	string	签名

param 参数

参数名	必选	类型	说明
eventName	是	string	事件名称 (payment.refund.success, payment.refund.failed, payment.refund.cancel)
mchRefundOrderId	是	string	商户-退款编号, 商户系统唯一标识
refundTransactionId	是	string	退款交易流水号
originalTransactionId	是	string	原交易流水号
refundAmount	是	int	退款金额
feeRefunded	是	int	退款退回手续费金额
refundStatus	是	string	退款状态
refundCreateTime	是	string	退款创建时间
refundReturnTime	是	string	退款完成时间
refundReason	是	string	退款原因
failedCode	否	int	失败Code（失败时返回）
failedMessage	否	int	失败信息（失败时返回）

请求示例

请求体

{
  "param": "{\"eventName\":\"payment.refund.success\",\"mchRefundOrderId\":\"18184914989277184\",\"originalTransactionId\":\"CU508022434763373688\",\"refundAmount\":10000,\"feeRefunded\":1000,\"refundCreateTime\":\"2024-07-31 11:38:54\",\"refundReturnTime\":\"2024-07-31 11:38:55\",\"refundStatus\":\"COMPLETE\",\"refundTransactionId\":\"1818491499290169344\"}",
  "sign": "W3j7iWptU5CDfXAAl9URzBzb2NpEaBTP4wnYTsv2XFuN70m+SJnlPVpByM7OR5w/zGQWAzmJGIYgJeNwPQDHzP24MPQDtWjPVIMPvzqlTNC2SKnzbhTPCjt3B8cgLc2o/oBhQ6nA9itk0A9lnhe5ZdOZnbOZmIO9Lq2VTEAG6lda5rEK7ycvGEp0t+MnC5rKYJsKS8OWklnB9oRnxd+vNLw+yOGGIExdn1WFrNnQnsNl86sqx7+NdBu0gK/EEvqhWAW+WronOS5I61ymSKNk4d3IGQxflgCsMsPQRBgU8Q6lnCflci7bMeT2gz3zevPZDXFxbtdg2PkEeWKHBXWg=="
}

Platform 如何构造请求体

---

响应参数

参数名	类型	说明
code	integer	响应码，固定为 10000
message	string	响应消息，固定为 Success

返回示例

{
  "code": 10000,
  "message": "Success"
}