1. Payment
EVO Payment Gateway API
  • Gateway Integration
    • Version Record
    • CardInfoLink Gateway API Integration Guide
      • Online payments scenes
        • DCC
        • Tokenization
        • Payment
        • 3DS Authentication
        • Capture
        • Cancel
        • Refund
        • Merchandise Credit
        • Network token management
        • Cancel or Refund
        • Recapture
        • Recurring
      • Security Requirements and Message Header
        • Message protocol
        • Signature
        • Card Information Encryption
        • PIN Encryption
      • Offline payments scenes
        • Pre-authorization
        • Payment
        • Capture
        • Refund
        • Merchandise Credit
        • Cancel
        • Reversal
        • DCC
        • Recurring
      • Appendix
        • Response code
        • FAQ
        • Mastercard-Merchant Advice Code
        • Product Code
    • Offline API Specification
      • Payment
        • Payment
        • Payment
      • StandaloneCapture
        • StandaloneCapture
        • StandaloneCapture
      • Reversal
        • Reversal
      • MerchandiseCredit
        • MerchandiseCredit
        • MerchandiseCredit
      • Capture
        • Capture
        • Capture
      • TipsAdjustment
        • TipsAdjustment
        • TipsAdjustment
      • Cancel
        • Cancel
        • Cancel
      • MultipleCapture
        • MultipleCapture
        • MultipleCapture
      • FXRateInquiry
        • FXRateInquiry
        • FXRateInquiry
      • Refund
        • Refund
        • Refund
      • DCCToNon-DCC
        • DCCToNon-DCC
        • DCCToNon-DCC
      • ZPK
        • ZPK
      • Notification
        • Asynchronous notification for StandaloneCapture
        • Asynchronous notification for MultipleCapture
        • Asynchronous notification for Payment
        • Asynchronous notification for Capture
        • Asynchronous notification for Refund
        • Asynchronous notification for MerchandiseCredit
        • Asynchronous notification for Cancel
    • Online API Specification
      • PaymentMethod
        • PaymentMethod
        • PaymentMethod
        • PaymentMethod
        • PaymentMethod
      • Payment
        • Payment
          POST
        • Payment
          PUT
        • Payment
          GET
      • Refund
        • Refund
        • Refund
      • Cancel
        • Cancel
        • Cancel
      • Capture
        • Capture
        • Capture
      • PaymentInstrument
        • PaymentInstrument
        • PaymentInstrument
        • PaymentInstrument
        • PaymentInstrument
      • MerchandiseCredit
        • MerchandiseCredit
        • MerchandiseCredit
      • CancelOrRefund
        • CancelOrRefund
        • CancelOrRefund
      • TransactionHistoryInquiry Copy
        • TransactionHistoryInquiry
      • MultipleCapture
        • MultipleCapture
        • MultipleCapture
      • Cryptogram
        • Cryptogram
        • Cryptogram
      • StandaloneCapture
        • StandaloneCapture
        • StandaloneCapture
      • Recapture
        • Recapture
        • Recapture
      • AsynchronousNotification
        • Asynchronous notification for Multiple Capture
        • Asynchronous notification for PaymentMethod
        • Asynchronous notification for PaymentInstrument
        • Asynchronous notification for Payment
        • Asynchronous notification for Merchandise Credit
        • Asynchronous notification for Refund
        • Asynchronous notification for Capture
        • Asynchronous notification for Cancel
        • Asynchronous notification for Recapture
        • Asynchronous notification for Cryptogram
        • Asynchronous notification for Network Token update
        • Asynchronous notification for Standalone Capture
        • Asynchronous notification for Network Token authentication finished
      • HealthCheck
        • HealthCheck
      • FX Rate inquiry
        • FXRateInquiry
        • FXRateInquiry
  1. Payment

Payment

POST
/g2/v0/payment/acq/{aid}/evo.e-commerce.payment

Request

Path Params

Header Params

Body Params application/json

Example
{
    "merchantTransInfo": {
        "merchantTransID": "{{merchantTransID}}",
        "merchantTransTime": "{{merchantTransTime}}"
    },
    "paymentMethod": {
        "type": "card",
        "card": {
            "cardInfo": {
                "cardNumber": "2222669999000333",
                "expiryDate": "2712"
            },
            "tokenize": false
        }
    },
    "transAmount": {
        "currency":"HKD",
        "value":"1.00"
    },
    "transInitiator": {
        "platform": "WEB"
    },
    "pspInfo": {
        "mcc": "5499",
        "sponsorCode": "123456",
        "merchantID": "123456789999888",
        "merchantName": "Test",
        "storeID": "12345678",
        "storeName": "Test Store",
        "street": "Test street",
        "city": "HongKong",
        "postCode": "202000",
        "nation": "HKG"
    }
}

Responses

🟢200Success
application/json
Headers

Bodyapplication/json

Example
"payment": {
    "evoTransInfo": {
        "evoTransID": "bf0cb23d0a924b34aa7ef51d34c1abd7",
        "evoTransTime": "2025-06-20T02:22:20Z",
        "retrievalReferenceNum": "517110517652",
        "traceNum": "517652"
    },
    "merchantTransInfo": {
        "merchantTransID": "T20250620102219133",
        "merchantTransTime": "2025-06-20T10:22:19+08:00"
    },
    "pspTransInfo": {
        "authorizationCode": "085168",
        "pspTransID": "305171085406910",
        "pspTransTime": "2025-06-20T02:22:19Z"
    },
    "status": "Captured",
    "transAmount": {
        "currency": "HKD",
        "value": "1.00"
    }
},
"paymentMethod": {
    "card": {
        "first6No": "417666",
        "fundingType": "debit",
        "issuingCountry": "826",
        "last4No": "0104",
        "paymentBrand": "VIS"
    },
    "type": "card"
},
"pspData": {
    "name": "Visa"
},
"result": {
    "code": "S0000",
    "message": "Success",
    "pspMessage": "Successful approval/completion or V .I.P .PIN\n verification is successful",
    "pspResponseCode": "00"
},
"transInitiator": {
    "platform": "WEB"
}
}
Previous
PaymentMethod
Next
Payment
Built with