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


Получение
Схема работы 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 - ошибка