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
:支付成功authorized
、verified
、identified
:可将此次行动置为成功declined
、identify_declined
、verify_declined
:支付失败xxx_pending
:需根据action.type
进行后续处理
关键字段:
字段名 | 类型 | 描述 | 注意事项 |
---|---|---|---|
payment.status | string | 支付状态 | 如 xxxed 表示成功,xxx_pending 需进一步处理 |
result.code | string | 应答码 | S 开头表示查询成功 |
更多参数信息请参考:payment API 中 GET payment 部分。
Note轮询建议:7 次,间隔 8、16、32、128、512、2048、8192 秒,获取到最终支付成功或失败后停止。
Updated about 1 month ago