无源退货
无源退货
如果您想在没有原始付款或者过超过退款有效期的情况下将资金退还给购物者,则需要调用 POST Merchandise Credit
接口。
主要流程如下:
- 在调用
POST Merchandise Credit
接口时需要包含但不限于以下参数,字段详情参考 API 文档: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.merchandiseCredit' \
-H 'Authorization: 4e2420fdb01b5ba61d18db59f25fe1b26e578d28f64f91038183773b872b8322' \
-H 'DateTime: 20240306140435+0800' \
-H 'SignType: SHA256' \
-H 'Content-Type: application/json' \
-H 'MsgID: M20240306140435199' \
-d '{
"merchantTransInfo": {
"merchantTransID": "T20240306140435199",
"merchantTransTime": "2024-03-06T14:04:35+08:00"
},
"paymentMethod": {
"type": "card",
"card": {
"posEntryMode":"magnetic",
"pinFlag":false,
"termReadability":"5",
"cardInfo": {
"cardNumber": "4761340000000043",
"expiryDate": "2212",
"track2": "4761340000000043=221220113183086"
}
}
},
"transAmount": {
"currency": "HKD",
"value": "1.00"
},
"pspInfo": {
"mcc": "5499",
"sponsorCode": "467881",
"merchantID": "202106305812001",
"terminalID":"00000001",
"merchantName": "Test",
"storeID": "202106305812001",
"storeName": "Test Store",
"street": "Test street",
"city": "SH",
"postCode": "202000",
"nation": "MYS"
}
}'
- 检查 EVO Cloud 应答中的
merchandiseCredit.status
字段内容。如果字段的值为Success
则表示退款成功,否则就需要查看result.code
以及result.message
来查看交易失败原因。 - 如果您没有收到来自 EVO Cloud 的应答报文,则需要您调用
GET Merchandise Credit
来查询交易结果。当收到查询应答时,您同样也需要通过merchandiseCredit.status
字段内容来判断交易结果,判断方式与第 2 步一致。如果交易失败,您需要通过merchandiseCredit.failureCode
以及merchandiseCredit.failureReason
来查看交易失败原因。 - 如果您在
POST Merchandise Credit
请求中上送了webhook
,您也可以通过异步通知来获取交易结果。同样也需要通过merchandiseCredit.status
字段内容来判断交易结果,判断方式与第 2 步一致。