Payment

Payment

To initiate a payment, terminal prompts the shopper to present their card and verify the payment, then you make a payment API call from your gateway. The terminal then sends the payment to your gateway, and then you forwards the request to EVO Cloud.

Once processed, your gateway will receive the result of the payment.

The main process is as follows:

1. From your server, submit a post payment request with the data you have collected from the shopper and include the following values:
   • autoCapture: The fixed value “true”, mean purchase.
   • paymentMethod.type: Filed that indicates the transaction type.
   • paymentMethod.card: Object that contains the shopper's card information. Mandatory when paymentMethod.type is card.
   • transAmount: Object that contains the currency and value of the payment.
   • transInitiator: Object that contains the merchant’s device type.

Example

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"
    }
}'

2. Check from the response.
3. From your server, make a GET payment to query the result of the transaction.
4. Present the payment result to your shopper.
5. After the shopper completes the payment, use the payment.status to inform the shopper of the payment status.