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

Получение карты

Метод для получения токена карты по проведенной транзакции.

URL

Метод: GET

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

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

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

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

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

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

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

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

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

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

Название Тип данных Описание
customer_key string Идентификатор покупателя в системе продавца
customer_card_token string Токен привязанной карты
pan_mask string Маска карты
holder string Имя держателя карты
transaction string Уникальный номер транзакции на стороне мерчанта

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

{
  "customer_key": "bind_card_test",
  "customer_card_token": "4VNSbS7nF410G8WLEhUUUnflH2UKvWlHxIzN3Jr9JJs",
  "pan_mask": "411111******1111",
  "holder": "IVAN IVANOV",
  "transaction": "563bb54d-ed4c-4ca1-84a3-6a35c0178cf5"
}

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