支付
支付
在用户使用信用卡发起支付时,您需要调用 POST Payment
接口发起支付。当 EVO Cloud 处理完成后,您将收到支付结果。
主要流程如下:
- 在调用
Payment
接口时需要包含但不限于以下参数,字段详情参考 API 文档:autoCapture
:固定值true
,表示消费。paymentMethod.type
:表明支付方式的字段,如果是卡交易则使用card
。paymentMethod.card
:包含消费者卡信息以及终端信息的结构体。当paymentMethod.type
为card
时必填。transAmount
:包含交易金额和交易币种的结构体。merchantTransInfo
:包含商户订单号等信息的结构体。pspInfo
:包含卡组织资质信息的结构体。
消费请求报文样例
js
curl 'https://hkg-online-uat.everonet.com/g2/v0/payment/acq/10130014/evo.offline.payment' \
-H 'Authorization: da1b7d9d8e789ec06d8207c9614bcbeafd76a5c918cb58376458b7b4db023293' \
-H 'DateTime: 20240306135818+0800' \
-H 'SignType: SHA256' \
-H 'Content-Type: application/json' \
-H 'MsgID: M20240306135818963' \
-d '{
"merchantTransInfo": {
"merchantTransID": "T20240306135818963",
"merchantTransTime": "2024-03-06T13:58:18+08:00"
},
"paymentMethod": {
"type": "card",
"card": {
"posEntryMode":"manual",
"pinFlag":false,
"termReadability":"5",
"cardInfo": {
"cardNumber": "4761340000000043"
}
}
},
"transAmount": {
"currency":"HKD",
"value":"1.00"
},
"autoCapture": true,
"pspInfo": {
"mcc": "5499",
"sponsorCode": "441378",
"merchantID": "202106305812001",
"terminalID":"00000001",
"merchantName": "Test",
"storeID": "202106305812001",
"storeName": "Test Store",
"street": "Test street",
"city": "MYS",
"postCode": "202000",
"nation": "MYS"
}
}'
- 检查 EVO Cloud 应答中的
payment.status
字段内容。如果字段的值为Captured
则表示交易成功,否则就需要查看result.code
以及result.message
来查看交易失败原因。 - 如果您没有收到来自 EVO Cloud 的应答报文,则需要您调用
GET Payment
来查询交易结果。当收到查询应答时,您同样也需要通过payment.status
字段内容来判断交易结果,判断方式与第 2 步一致。如果交易失败,您需要通过payment.failureCode
以及payment.failureReason
来查看交易失败原因。 - 如果您在
POST Payment
请求中上送了webhook
,您也可以通过异步通知来获取交易结果。同样也需要通过payment.status
字段内容来判断交易结果,判断方式与第 2 步一致。 - 向消费者展示付款结果。