5.1 退款接口

POST

/open-api/payment/refund

退款接口

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

参数名	必选	类型	长度	示例	说明
mchRefundOrderId	是	string	1-32	1677495496979	商户退款订单id, 格式：字母+数字，1-32位
originalTransactionId	是	string	1-32	CCP20220428011068111	原交易流水号
refundAmount	是	Long	-	-	退款金额（单位为分）
refundReason	否	string	1-200	-	退款原因
refundCallbackUrl	是	string	1-256	-	退款回调Url
timestamp	是	long	-	1677495496979	当前时间戳

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

请求参数

Body 参数application/json必填

示例

{
    "appId": "733b887a4a784708bb369524db5b6ded",
    "sign": "A5Vd8NcQvU3QT41Yee2jCIK58jDAKZ6kP5gEE4q7Yu92hUCY3k00FKTSlCNU+CcZm0LSrGbEMFMID3p7uvXaqy5khNv3kPndrgp7MIRHUmQnMgRK+g1XG7PzWdnrqlXc3g+L+kqVja+qrFRz+uVS6GLKLR1P4AtgTa9dok6NU7YTWOnG9r/FwIVx/At4czfEpI10pvg2TptVpiANmseGmz4G30hkaYTTNahkcOMQJn6PDFjivHvjNLZNJVOqHQzVUa+kca1yZZMPHtgxR647KjoY2oAjjl0Y45GL6zP9qHD/eVwcPPAPrRZ4K2o05OJnPf67fAcWNVqpnu6ZGQIXhQ==",
    "param": "{\"originalTransactionId\":\"CU518563189147832780\",\"mchRefundOrderId\":\"refund488455057142\",\"refundAmount\":10000,\"refundReason\":\"testRefund\",\"refundCallbackUrl\":\"http://www.test.com\",\"timestamp\":1722415059}"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/open-api/payment/refund' \
--header 'Content-Type: application/json' \
--data '{
    "appId": "733b887a4a784708bb369524db5b6ded",
    "sign": "A5Vd8NcQvU3QT41Yee2jCIK58jDAKZ6kP5gEE4q7Yu92hUCY3k00FKTSlCNU+CcZm0LSrGbEMFMID3p7uvXaqy5khNv3kPndrgp7MIRHUmQnMgRK+g1XG7PzWdnrqlXc3g+L+kqVja+qrFRz+uVS6GLKLR1P4AtgTa9dok6NU7YTWOnG9r/FwIVx/At4czfEpI10pvg2TptVpiANmseGmz4G30hkaYTTNahkcOMQJn6PDFjivHvjNLZNJVOqHQzVUa+kca1yZZMPHtgxR647KjoY2oAjjl0Y45GL6zP9qHD/eVwcPPAPrRZ4K2o05OJnPf67fAcWNVqpnu6ZGQIXhQ==",
    "param": "{\"originalTransactionId\":\"CU518563189147832780\",\"mchRefundOrderId\":\"refund488455057142\",\"refundAmount\":10000,\"refundReason\":\"testRefund\",\"refundCallbackUrl\":\"http://www.test.com\",\"timestamp\":1722415059}"
}'

返回响应

🟢200

application/json

业务处理结果

Bodyapplication/json

示例

成功示例失败示例

{
    "code": 10000,
    "message": "Success",
    "data": {
        "mchRefundOrderId": "refund488455057142",
        "refundTransactionId": "1818566685947728",
        "refundCreateTime": "2024-07-31 16:37:40",
        "refundAmount": 10000,
        "refundStatus": "PENDING"
    }
}

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

退款状态枚举

5.2 退款查询接口