1. Tokenization
Merchant Connect API
latest
  • latest
  • HASE
  • Version Record
  • Integration Guide
    • EC Payment
      • Merchant API
        • Overview
        • Payment
        • Payment Methods
        • Response code
        • After Payment
          • Capture
          • Cancel
          • Refund
          • Cancel or Refund
          • Accept Notification
        • Features
          • Account Status Inquiry (ASI)
          • COF
          • Multi-Currency Transaction
          • Recurring
          • Smart Routing
          • Transaction Retry
          • Payout
          • Authentication
            • 3D Secure
            • FIDO Authentication
            • Authentication only
            • Authorization only
          • Tokenization
            • Gateway Tokenization
            • Create a gateway token
            • Network Tokenization
            • Pay with gateway token
            • Manage token
            • Network Token update notification
            • Card Based Network Token
    • In-store Payment
      • Merchant API(QR)
        • Payment
          • CPM
          • MPM
          • MPM static QR code
        • After Payment
          • Capture
          • Cancel
          • Refund
          • Cancel or Refund
          • Accept Notification
      • Merchant API (Card)
        • ZPK
          • ZPK
        • Payment
          • Payment
        • After Payment
          • Capture
          • Cancel
          • Refund
          • Cancel or Refund
          • Accept Notification
  • API Explorer
    • API Rules
    • PaymentMethod
      • PaymentMethod
      • PaymentMethod
      • PaymentMethod
      • PaymentMethod
    • FXRateInquiry
      • FXRateInquiry
      • FXRateInquiry
    • Payment
      • Payment
      • Payment
      • Payment
    • Payout
      • Payout
      • Payout
    • Capture
      • Capture
      • Capture
    • Cancel
      • Cancel
      • Cancel
    • Refund
      • Refund
      • Refund
    • Cryptogram
      • Cryptogram
      • Cryptogram
    • Cancel or Refund
      • Cancel or Refund
      • Cancel or Refund
    • Notification
      • Notification for PaymentMethod
      • Notification for Payment
      • Notification for Capture
      • Notification for Cancel
      • Notification for Refund
      • Notification for DataSubmission
      • Notification for MPM Static QR Code
      • Notification for Token Status Update
      • Notification for Settlement
      • Notification for Reversal
      • Notification for Cryptogram
      • Notification for Payout
    • Appendix
      • Result Code
      • Payment Brands
      • Payment Method Variant
      • Currency list
      • Country and region list
      • Product Code
    • HealthCheck
      • HealthCheck
    • Coupon Write-off
      • Coupon Write-off
    • Coupon Reversal
      • Coupon Reversal
    • ZPK
      • ZPK
latest
  • latest
  • HASE
  1. Tokenization

Pay with gateway token

For later payment with one-off transactions, users can store payment information and make purchases on your website or app later using the stored information.
1.
Build the Payment Method Selection Page
Create a page to present the user's stored payment methods for selection.
You can use the details stored on your server or retrieve the user's stored payment methods from EVO Cloud. See the chapter on retrieving gateway tokens for more details.
2.
Prepare for Recurring Payments
For recurring payments, your server needs to choose the stored payment method to initiate the payment.
3.
Make the Payment Request
Once the user chooses a stored payment method, you can make an HTTP POST request to the EVO Cloud endpoint:
POST /g2/v1/payment/mer/{sid}/payment
Body ParameterRequiredDescription
merchantTransInfoMThe reference for the payment, including a unique merchantTransID and merchantTransTime to specify the time you initiate the request.
transAmountMThe currency and value of the payment. The value must follow the currency's minor unit.
paymentMethodMSet paymentMethod.type to token, with paymentMethod.token.value specified from your stored token information.
transInitiatorMThe information of the terminal to initiate the transaction.
storeInfoOSupplemental store information. Required if your store is assigned multiple MCCs in EVO Cloud to indicate which MCC you are using for this payment.
tradeInfoOIf paymentMethod.token is an Alipay token, specify this field to indicate detailed information about this payment.
webhookOThe URL to receive notifications. Specify this to get notifications from EVO Cloud after the payment succeeds.
metadataOCustom reference information that you can specify in the request, echoed back in the response.
Here is an example of making a $10 payment using the token created in the previous step:
tip
Your next steps depend on whether the payment response contains an action object. See chapter Payment for more details.
Previous
Network Tokenization
Next
Manage token
Built with