5.3 退款回调接口

POST

/callbacks/refund

此接口由商户实现，路径和服务器地址均为导入占位值。

param 是经过 JSON 序列化后的字符串；下表描述其反序列化后的逻辑字段。

参数名	必选	类型	说明
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	失败信息（失败时返回）

原始文档：https://docs.paycools.com.my/zh/refund/RefundCallback.html

请求参数

Body 参数application/json必填

示例

{
    "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=="
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/callbacks/refund' \
--header 'Content-Type: application/json' \
--data '{
    "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=="
}'

返回响应

🟢200

application/json

业务处理结果

Bodyapplication/json

示例

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

修改于 2026-08-31 11:03:58

5.2 退款查询接口