5.2 退款查询接口

POST

/open-api/refund/payments

退款查询接口

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

参数名	必选	类型	长度	示例	说明
originalTransactionId	否	string	1-32	CCP20220428011068111	原交易流水号(原交易流水号或退款交易流水号选填一个)
refundTransactionId	否	string	1-32	CCP20220428011068111	退款交易流水号(原交易流水号或退款交易流水号选填一个)
timestamp	是	long	-	1677495496979	当前时间戳

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

请求参数

Body 参数application/json必填

示例

{
    "appId": "733b887a4a784708bb369524db5b6ded",
    "sign": "A5Vd8NcQvU3QT41Yee2jCIK58jDAKZ6kP5gEE4q7Yu92hUCY3k00FKTSlCNU+CcZm0LSrGbEMFMID3p7uvXaqy5khNv3kPndrgp7MIRHUmQnMgRK+g1XG7PzWdnrqlXc3g+L+kqVja+qrFRz+uVS6GLKLR1P4AtgTa9dok6NU7YTWOnG9r/FwIVx/At4czfEpI10pvg2TptVpiANmseGmz4G30hkaYTTNahkcOMQJn6PDFjivHvjNLZNJVOqHQzVUa+kca1yZZMPHtgxR647KjoY2oAjjl0Y45GL6zP9qHD/eVwcPPAPrRZ4K2o05OJnPf67fAcWNVqpnu6ZGQIXhQ==",
    "param": "{\"originalTransactionId\":\"CU518563189147832320\",\"timestamp\":1722416882}"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/open-api/refund/payments' \
--header 'Content-Type: application/json' \
--data '{
    "appId": "733b887a4a784708bb369524db5b6ded",
    "sign": "A5Vd8NcQvU3QT41Yee2jCIK58jDAKZ6kP5gEE4q7Yu92hUCY3k00FKTSlCNU+CcZm0LSrGbEMFMID3p7uvXaqy5khNv3kPndrgp7MIRHUmQnMgRK+g1XG7PzWdnrqlXc3g+L+kqVja+qrFRz+uVS6GLKLR1P4AtgTa9dok6NU7YTWOnG9r/FwIVx/At4czfEpI10pvg2TptVpiANmseGmz4G30hkaYTTNahkcOMQJn6PDFjivHvjNLZNJVOqHQzVUa+kca1yZZMPHtgxR647KjoY2oAjjl0Y45GL6zP9qHD/eVwcPPAPrRZ4K2o05OJnPf67fAcWNVqpnu6ZGQIXhQ==",
    "param": "{\"originalTransactionId\":\"CU518563189147832320\",\"timestamp\":1722416882}"
}'

返回响应

🟢200

application/json

业务处理结果

Bodyapplication/json

示例

成功示例失败示例

{
    "code": 10000,
    "message": "Success",
    "data": [
        {
            "mchRefundOrderId": "refund7806664227088",
            "originalTransactionId": "CU51856318914782320",
            "refundTransactionId": "1818563941756964864",
            "refundAmount": 10000,
            "feeRefunded": 1000,
            "refundStatus": "FAILED",
            "refundCreateTime": "2024-07-31 16:26:46",
            "refundReturnTime": "2024-07-31 16:26:48",
            "failedCode": -10010,
            "failedMessage": "Channel Refund Failed"
        },
        {
            "mchRefundOrderId": "refund4884505715830",
            "originalTransactionId": "CU51856318914782320",
            "refundTransactionId": "1818566685947465728",
            "refundAmount": 10000,
            "feeRefunded": 1000,
            "refundStatus": "COMPLETE",
            "refundCreateTime": "2024-07-31 16:37:40",
            "refundReturnTime": "2024-07-31 17:07:40"
        }
    ]
}

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

5.1 退款接口

5.3 退款回调接口