跳转到内容

无源退货

无源退货

如果您想在没有原始付款或者过超过退款有效期的情况下将资金退还给购物者,则需要调用 POST Merchandise Credit 接口。

主要流程如下:

  1. 在调用 POST Merchandise Credit 接口时需要包含但不限于以下参数,字段详情参考 API 文档:
    • paymentMethod.type:表明支付方式的字段,如果是卡交易则使用 card
    • paymentMethod.card:包含消费者卡信息以及终端信息的结构体。当 paymentMethod.typecard 时必填。
    • 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"
    }
}'
  1. 检查 EVO Cloud 应答中的 merchandiseCredit.status 字段内容。如果字段的值为 Success 则表示退款成功,否则就需要查看 result.code 以及 result.message 来查看交易失败原因。
  2. 如果您没有收到来自 EVO Cloud 的应答报文,则需要您调用 GET Merchandise Credit 来查询交易结果。当收到查询应答时,您同样也需要通过 merchandiseCredit.status 字段内容来判断交易结果,判断方式与第 2 步一致。如果交易失败,您需要通过 merchandiseCredit.failureCode 以及 merchandiseCredit.failureReason 来查看交易失败原因。
  3. 如果您在 POST Merchandise Credit 请求中上送了 webhook,您也可以通过异步通知来获取交易结果。同样也需要通过 merchandiseCredit.status 字段内容来判断交易结果,判断方式与第 2 步一致。