Перейти к содержанию

Токенизация

Метод для токенизации ПАНа карты без передачи срока действия.

URL

Метод: POST

  • Production: https://api.pay.kvell.group/v1/customers/{customer_key}/cards
  • Stage: https://api.pay.stage.kvell.group/v1/customers/{customer_key}/cards

Параметры запроса

Название Тип данных Обязательно Описание
customer_key string Да Идентификатор покупателя в системе продавца

Параметры в теле запроса

Название Тип данных Обязательно Описание
pan string Да 16-ти значный номер карты

Пример запроса

{
  "pan": "string"
}

Заголовки запроса

Название Тип данных Обязательно Описание
X-Api-Key string Да Уникальный идентификатор магазина
X-Signature string Да Подпись

Подпись X-Signature формируется конкатенацией X-Api-Key, customer_key, pan и secret_key. Формируется sha256 от полученной строки:

sha256({x-api-key}{customer_key}{pan}{secret_key})

где secret_key - секретный ключ, который находится в настройках магазина мерчанта;

Ответ запроса

Пример ответа

{
  "customer_id": 0,
  "pan_mask": "string",
  "token": "string",
  "created_at": "2022-07-07T17:55:21.759Z"
}

{
  "errors": [
    {
      "message": "string",
      "code": 0
    }
  ]
}