5.1 Refund

POST

/open-api/payment/refund

param is a JSON-serialized string. The table below describes its decoded logical fields.

Parameter Name	Required	Type	Length	Example	Description
mchRefundOrderId	Y	string	1-32	1677495496979	Merchant refund order id (unique for customer) format: letter + num, 1-32 characters: CCP20220428011068111
originalTransactionId	Y	string	1-32	CCP20220428011068111	Original transaction id
refundAmount	Y	Long	-	-	Refund amount (Unit is in cents)
refundReason	N	string	1-200	-	Refund reason
refundCallbackUrl	Y	string	1-256	-	Refund callback URL
timestamp	Y	long	-	1677495496979	timestamp

Source documentation: https://docs.paycools.com.my/en/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

Business result

Bodyapplication/json

示例

Success exampleFailure example

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

修改于 2026-08-31 11:04:18

Refund Status Enum

5.2 Get Refund Payments