go to Evonet

Retrieve API

通过 GET /payment/{merchantTransID} 查询支付状态,检查 result.code 和 payment.status。

响应示例:

{
    "action": {
        "threeDSData": {
            "method": "GET",
            "url": "https://counter-uat.everonet.com/3ds?dGhyZWVEU1BzcD1ISVRSVVNUJmluc0NvZGU9OTA0NTE5MDAmb3JkZXJOdW09cGF5XzI1MDcxMTEwNTgxMTAwMDEwMDAwNTcwMzA0NTEmc3RvcmVOdW09UzAwNTIyOCZ0aHJlZWRzSW50ZWdyYXRvck9pZD0xMzY4NDg0NCZ0aHJlZURTQXV0aFVSTD1hSFIwY0hNNkx5OXphWFF0TTJSemN5MWpjSGg1TG1ocGRISjFjM1J3WVhrdVkyOXRMblIzTDNSb2NtVmxaSE10YVc1MFpXZHlZWFJ2Y2k5aGRYUm9Mekl1TVM0d0wyMUhhekpZUVd0MmMyVkxjRzU2YkVreVNtUkhNMFJrWmxCSllqWlVXVnBCWjAxTlRtZE5NVmRKZWpBPSZyZXR1cm5Vcmw9YUhSMGNITTZMeTkzZDNjdVkyRnlaR2x1Wm05c2FXNXJMbU52YlE9PQ=="
        },
        "type": "threeDSRedirect"
    },
    "authentication": {
        "threeDS": {
            "isFrictionless": "Y",
            "mpiData": {
                "cavv": "AJkBB2NpJhNCMXQ1JWkmAAAAAAA=",
                "dsTransID": "24EA7D1C-7180-4CF5-949A-456B74328015",
                "eci": "05",
                "status": "Y",
                "threeDSVersion": "2.2.0"
            }
        }
    },
    "events": [
        {
            "id": "evt_pay_2507111058110001000057030451_1",
            "status": "verified",
            "time": "2025-07-11T10:58:32.559Z"
        },
        {
            "id": "evt_pay_2507111058110001000057030451_2",
            "status": "authorized",
            "time": "2025-07-11T10:58:33.225Z"
        },
        {
            "id": "evt_pay_2507111058110001000057030451_3",
            "status": "captured",
            "time": "2025-07-11T10:58:33.342Z"
        }
    ],
    "payment": {
        "evoTransInfo": {
            "evoTransID": "pay_2507111058110001000057030451",
            "evoTransTime": "2025-07-11T02:58:10Z",
            "retrievalReferenceNum": "519210172093",
            "traceNum": "172093"
        },
        "merchantTransInfo": {
            "merchantTransID": "pay_2507111058110001000057030451",
            "merchantTransTime": "2025-07-11T10:58:10+08:00"
        },
        "pspTransInfo": {
            "authorizationCode": "065581",
            "pspTransID": "305192107129579",
            "pspTransTime": "2025-07-11T02:58:32Z",
            "retrievalReferenceNum": "519210172093"
        },
        "status": "captured",
        "transAmount": {
            "currency": "HKD",
            "value": "100.00"
        }
    },
    "paymentMethod": {
        "card": {
            "first6No": "489533",
            "fundingType": "credit",
            "issuingCountry": "USA",
            "last4No": "1119",
            "paymentBrand": "Visa",
            "productID": "C "
        },
        "e-wallet": {
            "paymentBrand": "VIS"
        },
        "isNetworkToken": false,
        "paymentMethodVariant": "Recurring",
        "recurringReference": "recurring_b6baf1971a5f408d9c72cec193b58a12",
        "token": {
            "createTime": "2025-07-09T07:59:57Z",
            "fingerprint": "6fae07340096b1dc087f52ddbf69e577",
            "paymentBrand": "Visa",
            "status": "enabled",
            "updateTime": "2025-07-09T07:59:58Z",
            "userReference": "12",
            "value": "pmt_8facd9b1cac046289236c6f6b58c7e99"
        }
    },
    "result": {
        "code": "S0000",
        "message": "Success"
    },
    "transInitiator": {
        "terminalID": "123456"
    }
}

处理逻辑

响应中,需首先查看 result.code

  • 非 S 开头:查询失败
  • S 开头(如 S0000):查询成功,需要查看 payment.status
    • captured:支付成功
    • authorizedverifiedidentified:可将此次行动置为成功
    • declinedidentify_declinedverify_declined:支付失败
    • xxx_pending:需根据 action.type 进行后续处理

关键字段:

字段名类型描述注意事项
payment.statusstring支付状态如 xxxed 表示成功,xxx_pending 需进一步处理
result.codestring应答码S 开头表示查询成功

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

📘

Note

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