Contents x
    Token
    • 30 May 2024
    • 1 Minute to read
    • Dark
      Light
    Contents

    Token

    • Updated on 30 May 2024
    • 1 Minute to read
    • Dark
      Light
    Article summary

    Callback Handler - Token

    The token key in the Callback handler response provides details of the Uplift virtual card that will be used by the merchant to process the payment in full. The token’s includes the information required to complete the transaction and charge the virtual card as you would any other credit card, see the sample information below:

    {
  "card_number": "string",
  "card_ccv": "string",
  "card_type": "string", // enum: "VISA", "MASTERCARD" or "UATP"
  "expiration_month": "integer",
  "expiration_year": "4-digit integer",
  "name_on_card": "string",
  "contact": {
    "postal_code": "string",
    "email": "string",
    "first_name": "string",
    "phone": "string",
    "city": "string",
    "region": "string", // short region name. e.g. "FL" for "Florida"
    "last_name": "string",
    "street_address": "string",
    "country": "string" // two-letter country code e.g. US, CA (Canada)
  }
}
    How to correctly retrieve the billing contact information?

    ⚠️Plaese make sure to use the data under the contact object instead of any other billing information provided by the user.

    ⚠️ It is highly recommended to process the payment directly without filling the on screen/hidden payment input form, however if for some reason you need to fill the hidden payment input form, please ensure the following security guidelines:

    1. Users cannot see the virtual card information displayed on the partner payment input form or in the console. Please validate this by switching the payment options.
    2. If there is any error during payment processing, make sure to use the payment input form to process the payment and validate that you are indeed cleaning the regular payment input form.
    ⚠Token is NULL

    Please review the Response Reason Code details if the token value is NULL.

    Was this article helpful?
    What's Next