Retrieve API

响应示例：

{
    "authentication": {
        "liabilityShift": true,
        "threeDS": {
            "isFrictionless": "N",
            "mpiData": {
                "cavv": "AJkBB2NgFkNhVGNidGAWAAAAAAA=",
                "dsTransID": "7E2D422B-17F0-4130-8CB4-907F68EECE8D",
                "eci": "05",
                "status": "Y",
                "threeDSVersion": "2.2.0"
            }
        }
    },
    "events": [
        {
            "eventID": "evt_pay_2605191454280002000017143960_1",
            "eventTime": "2026-05-19T14:55:47.437Z",
            "merchantTransID": "pay_2605191454280002000017143960",
            "status": "verified"
        },
        {
            "eventID": "evt_pay_2605191454280002000017143960_2",
            "eventTime": "2026-05-19T14:55:48.399Z",
            "merchantTransID": "pay_2605191454280002000017143960",
            "status": "authorized"
        },
        {
            "eventID": "evt_pay_2605191454280002000017143960_3",
            "eventTime": "2026-05-19T14:55:48.450Z",
            "merchantTransID": "pay_2605191454280002000017143960",
            "status": "captured"
        },
        {
            "eventID": "evt_pay_2605191457000002000008808606_1",
            "eventTime": "2026-05-19T14:57:02.106Z",
            "merchantTransID": "refund_25051911",
            "status": "refund_successed"
        }
    ],
    "payment": {
        "evoTransInfo": {
            "evoTransID": "pay_2605191454280002000017143960",
            "evoTransTime": "2026-05-19T06:54:28Z",
            "retrievalReferenceNum": "613914821981",
            "traceNum": "821981"
        },
        "merchantTransInfo": {
            "merchantTransID": "pay_2605191454280002000017143960",
            "merchantTransTime": "2026-05-19T14:54:27+08:00"
        },
        "pspTransInfo": {
            "authorizationCode": "004318",
            "cvcCheckResult": "M",
            "cvcCheckResultRaw": "M",
            "pspTransTime": "2026-05-19T06:55:46Z",
            "retrievalReferenceNum": "613914821981"
        },
        "status": "refunded_full",
        "transAmount": {
            "currency": "HKD",
            "value": "100.00"
        }
    },
    "paymentMethod": {
        "card": {
            "first6No": "401200",
            "fundingType": "debit",
            "last4No": "1112",
            "paymentBrand": "Visa"
        },
        "isNetworkToken": false,
        "issuingCountry": "USA"
    },
    "result": {
        "code": "S0000",
        "message": "Success"
    },
    "transInitiator": {
        "terminalID": "123456"
    }
}

处理逻辑

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

非 S 开头：查询失败
S 开头（如 S0000）：查询成功，需要查看 payment.status 和 events.status

Payment.status 状态说明

payment.status表示当前订单整体状态。

captured：支付成功
authorized、verified、identified、refunded_partial、refunded_full、cancelled：可将此次行动置为成功
declined、identify_declined、verify_declined：支付失败
xxx_pending：需根据 action.type 进行后续处理

events.status 状态说明

events数组用户表示订单生命周期中的具体事件结果。

Payment Event： 支付下单接口的 merchantTransID

status	含义
identified	身份识别成功
verified	验证成功
authorized	授权成功
captured	扣款成功
declined	支付失败

Refund Event： 通过 Refund API 中的 merchantTransID 进行识别

status	含义
refund_successed	退款成功
refund_declined	退款失败
refund_pending	退款处理中

Capture Event： 通过 Capture API 中的 merchantTransID 进行识别

status	含义
capture_successed	手动扣款成功
capture_declined	手动扣款失败
capture_pending	手动扣款处理中

Cancel Event： 通过 Cancel API 中的 merchantTransID 进行识别

status	含义
cancel_successed	撤销成功
cancel_declined	撤销失败
cancel_pending	撤销处理中

查询建议

payment.status用于判断订单当前整体状态。
events.status用户判断具体交易行为结果。
Refund、Capture、Cancel 均建议结合events数组进行判断。
建议结合 Webhook 作为最终状态确认依据

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

📘
Note
轮询建议：7 次，间隔 8、16、32、128、512、2048、8192 秒，获取到最终支付成功或失败后停止。