Приватний
Токени
Отримання токена картки без проведення платежу


Отримання
Схема роботи API отримання токена
Формування запиту до API при самостійній інтеграції:
Параметри для формування data:
Основні
Parameter Required Type Description
version Required Number Версія API. Поточне значення - 3
public_key Required String Публічний ключ - ідентифікатор магазину. Отримати ключ можна в налаштуваннях магазину
action Required String Тип операції. Можливі значення: token_create - створити токен, token_create_unique- створити токен, унікальний у рамках магазину (під час повторної токенізації картки буде повернено колишній токен)
is_debit Required Boolean Можливі значення: true - токен буде використовуватися для списання коштів з картки, false - токен не буде використовуватися для списання коштів з картки
is_credit Required Boolean Можливі значення: true - токен буде використовуватися для виплат на картку, false - токен не буде використовуватися для виплат на картку
Параметри для токенізації в рамках Token connect control
pushAccountReceipt Required String Строковий ідентифікатор, який використовується для токенізації картки в міжнародній платіжній системі Mastercard. Діє 30 хвилин
Параметри для токенізації в рамках Visa cards enrollment hub (VCEH)
pushdata Required String Рядок із зашифрованими даними для токенізації картки в міжнародній платіжній системі Visa
customer Required String Унікальний ідентифікатор клієнта на сайті мерчанта. Обов’язковий при токенізації в міжнародній платіжній системі Visa
Параметри для токенізації за номером картки
card Required String Номер картки
card_cvv Required String CVV/CVV2
card_exp_month Required String Місяць терміну дії картки платника. Наприклад: 08
card_exp_year Required String Рік терміну дії картки платника. Наприклад: 19
Приклад відповіді по Mastercard:
  {
    "result": "ok",
    "card_token_info": {
      "tokenSuffix": "1234",
      "tokenExpDate": "0822",
      "status": "ACTIVE",
      "decision": "APPROVED",
      "tokenRef": "DM4MMC0000129713c08c30d279db433584d5b7b0d406c654"
    },
    "card_token": "4F27B5BAA01C1FEC8E695855A53329B6EFCDF176",
    "status": "success"
  }
  
Приклад відповіді по Visa:
{
  "result": "ok",
  "card_token_info": {
    "tokenSuffix": "1234",
    "tokenExpDate": "1024",
    "status": "ACTIVE",
    "decision": "APPROVED",
    "tokenRef": "7354755087b7f975e8ed105a769d7802"
  },
  "card_token": "8B3B6147725CAFD4E93DDBAED3FA8D90D1262AC8",
  "status": "success"
}
Параметри відповіді
status String Статус виконання токенізації
card_token String Токен системи LiqPay
card_token_info Object Інформація про токен платіжних систем Mastercard та Visa
Параметри card_token_info:
tokenRef String Референс токена
tokenSuffix String Останні 4 цифри токена
tokenExpDate String Термін дії токена
status String Статус токена. Можливі значення: INACTIVE, ACTIVE, SUSPENDED, DELETED
decision String Рішення платіжної системи щодо оцифрування картки. Можливі значення: APPROVED - схвалено, REQUIRE_ADDITIONAL_AUTHENTICATION - схвалено, але бажана додаткова автентифікація клієнта, DECLINED - відхилено, CANCELLED - скасовано, ERROR - помилка