Refund API

请求示例：

{
    "merchantTransInfo": {
        "merchantTransID": "refund_25072",
        "merchantTransTime": "2025-07-09T11:18:00+08:00"
    },
    "transAmount": {
        "currency": "HKD",
        "value": "100.00"
    },
    "webhook": "https://6ee8218a-52e4-4b16-8d67-594cdb34bb23.mock.pstmn.io",
    "initiatingReason": "initiatingReason",
    "metadata": "metadata"
}

响应示例：

{
    "refund": {
        "evoTransInfo": {
            "evoTransID": "pay_2507211628080001000035713104",
            "evoTransTime": "2025-07-21T08:28:08Z",
            "retrievalReferenceNum": "520216129284",
            "traceNum": "032160"
        },
        "merchantTransInfo": {
            "merchantTransID": "refund_25072",
            "merchantTransTime": "2025-07-21T16:28:07+08:00"
        },
        "pspTransInfo": {
            "authorizationCode": "082636",
            "pspTransTime": "2025-07-21T08:26:57Z",
            "retrievalReferenceNum": "520216129284"
        },
        "status": "refund_pending",
        "transAmount": {
            "currency": "HKD",
            "value": "10.00"
        }
    },
    "payment": {
        "evoTransInfo": {
            "evoTransID": "pay_2507211626460001000061984707",
            "evoTransTime": "2025-07-21T08:26:46Z",
            "retrievalReferenceNum": "520216128911",
            "traceNum": "128911"
        },
        "merchantTransInfo": {
            "merchantOrderReference": "mc-250528",
            "merchantTransID": "pay_2507211626460001000061984707",
            "merchantTransTime": "2025-07-09T11:18:00+08:00"
        },
        "pspTransInfo": {
            "authorizationCode": "082636",
            "pspTransID": "305202304186741",
            "pspTransTime": "2025-07-21T08:26:57Z",
            "retrievalReferenceNum": "520216128911"
        },
        "status": "refund_pending",
        "transAmount": {
            "currency": "HKD",
            "value": "100.00"
        }
    },
    "paymentMethod": {
        "card": {
            "first6No": "489533",
            "fundingType": "credit",
            "issuingCountry": "USA",
            "last4No": "1119",
            "paymentBrand": "Visa"
        }
    },
    "result": {
        "code": "S0000",
        "message": "Success"
    }
}

处理逻辑

响应中，需首先查看 result.code：

非 S 开头：退款失败
S 开头（如 S0000）：查询成功，需要查看 refund.status
- refund_pending：需接收 eventCode: "Refund" 的异步通知，通过异步通知中的 refund.status 字段确定退款结果

📘
Note
可以通过调用 GET /payment 接口来查看部分退款或全额退款。

关键字段：

字段名	类型	描述	注意事项
refund.status	string	退款状态
result.code	string	应答码	S 开头表示查询成功

更多参数信息请参考：payment API 中 POST refund 部分。