Private
Tokens
Card token obtainment without processing a payment


Getting
Scheme of API getting a token
Forming a request to API for self-integration:
Options for generating data:
Main
Parameter Required Type Description
version Required Number Version API. Current value - 3
public_key Required String Public key - the store identifier. You can get the key in the store settings
action Required String Transaction type. Possible values: token_create - to create a token, token_create_unique- to create a token unique within the store (when the card is re-tokenized, the previous token will be returned)
is_debit Required Boolean Possible values: true - a token will be used to debit funds from a card, false - a token will not be used to debit funds from a card
is_credit Required Boolean Possible values: true - a token will be used for payments to a card, false - a token will not be used for payments to a card
Parameters for tokenization within the Token connect control
pushAccountReceipt Required String A string identifier that is used to tokenize a card in the Mastercard international payment system. It lasts 30 minutes
Parameters for tokenization within the Visa cards enrollment hub (VCEH)
pushdata Required String A string with encrypted data to tokenize a card in the Visa international payment system
customer Required String Unique client identifier on the merchant's website. It is required for tokenization in the Visa international payment system
Parameters for tokenization by card number
card Required String Card number
card_cvv Required String CVV/CVV2
card_exp_month Required String Month of the payer's card expiration date. For example: 08
card_exp_year Required String Year of the payer's card expiration date. For example: 19
Sample response for MasterCard:
  {
    "result": "ok",
    "card_token_info": {
      "tokenSuffix": "1234",
      "tokenExpDate": "0822",
      "status": "ACTIVE",
      "decision": "APPROVED",
      "tokenRef": "DM4MMC0000129713c08c30d279db433584d5b7b0d406c654"
    },
    "card_token": "4F27B5BAA01C1FEC8E695855A53329B6EFCDF176",
    "status": "success"
  }
  
Sample response for Visa:
{
  "result": "ok",
  "card_token_info": {
    "tokenSuffix": "1234",
    "tokenExpDate": "1024",
    "status": "ACTIVE",
    "decision": "APPROVED",
    "tokenRef": "7354755087b7f975e8ed105a769d7802"
  },
  "card_token": "8B3B6147725CAFD4E93DDBAED3FA8D90D1262AC8",
  "status": "success"
}
Response parameters
status String Status of tokenization performance
card_token String A token of the LiqPay system
card_token_info Object Information about a token of Mastercard and Visa payment systems
Parameters card_token_info:
tokenRef String Token reference
tokenSuffix String The last 4 digits of the token
tokenExpDate String Token expiration date
status String Token status. Possible values: INACTIVE, ACTIVE, SUSPENDED, DELETED
decision String Solution by payment system about card digitization. Possible values: APPROVED - approved, REQUIRE_ADDITIONAL_AUTHENTICATION - approved, but additional client authentication desired, DECLINED - rejected, CANCELLED - canceled, ERROR - error