Cards API | Платежные карточки

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

Авторизация

Авторизация запроса происходит путем формирования и передачи JWS токена запроса в заголовке X-JWS-Signature. JWS это часть токена JWT, которая содержит только header и signature.

Формат передаваемых данных application/json.

Пример формирования подписи

Тело запроса:


{
    "request_id": "828cf71d-a447-4a67-a149-c1df8bc197ca"
}

Заголовок JWT токена:


{
    "uri": "/v5/card-api/request/status",
    "auth_id": "123456",
    "method": "POST",
    "params": "",
    "alg": "HS256"
}

Ключ партнера может быть secret_key. В этом случае может быть сформирован следующий JWT токен:


eyJ1cmkiOiIvdjUvY2FyZC1hcGkvcmVxdWVzdC9zdGF0dXMiLCJhdXRoX2lkIjoiMTIzNDU2IiwibWV0aG9kIjoiUE9TVCIsInBhcmFtcyI6IiIsImFsZyI6IkhTMjU2In0.eyJyZXF1ZXN0X2lkIjoiODI4Y2Y3MWQtYTQ0Ny00YTY3LWExNDktYzFkZjhiYzE5N2NhIn0.5kx_b2FEI0qfCeJDIkhR33I6Oc7fe6y0aIMnxG8elJQ

Эта строка является подписью запроса и должна быть передана в параметре заголовка запроса X-JWS-Signature.


eyJ1cmkiOiIvdjUvY2FyZC1hcGkvcmVxdWVzdC9zdGF0dXMiLCJhdXRoX2lkIjoiMTIzNDU2IiwibWV0aG9kIjoiUE9TVCIsInBhcmFtcyI6IiIsImFsZyI6IkhTMjU2In0..5kx_b2FEI0qfCeJDIkhR33I6Oc7fe6y0aIMnxG8elJQ

Поддерживаемый алгоритм шифрования подписи HS256.

Запрос на выпуск карты

Метод позволяет выпустить карту с выбранным продуктом.

Запрос

URL запроса

POST https://.../v5/card-api/card/issue

request_id required ;;; Уникальный номер запроса в системе партнера (uuid);string/uuid product_id required ;;; Код продукта выпускаемой карты; integer cardholder required ;;; Данные держателя карты; object ;first_name required ;; Имя держателя карты (Латиница); string ;last_name required ;; Фамилия держателя карты (Латиница); string ;middle_name ;; Отчество держателя карты; string ;birthdate ;; Дата рождения держателя карты YYYY-MM-DD; date ;phone required;; Номер телефона держателя карты; integer ;email;; Электронный адрес держателя карты; string ;country required ;; Cтрана резидентства держателя карты (alpha-3) string ;person_id required ;; Идентификатор держателя карты в стране резидентства (для Казахстана ИНН, для РФ ИИН и т.д.); string ;language;; Язык общения держателя карты (alpha-2); string ;document required ;; Скан-копия документа, удостоверяющий личность Формат файла pdf Формат передачи base64 Максимальный размер файла 2 МБ.; string ;external_user_id;; Идентификатор клиента в системе партнера; string ;address1 required ;; Данные адреса регистрации держателя карты; object ;;country required; Страна регистрации (alpha-3); string ;;postal_code required; Индекс; string ;;address_line1 required; Город регистрации; string ;;address_line2 required; Улица регистрации; string ;;address_line3 required; Здание, помещение регистрации; string ;address2 required;; Данные адреса проживания держателя карты; object ;;country required; Страна проживания (alpha-3); string ;;postal_code required; Индекс; string ;;address_line1 required; Город проживания; string ;;address_line2 required; Улица проживания; string ;;address_line3 required; Здание, помещение проживания; string identification_info required;;; Данные идентификации держателя карты;object ;idn_date required;; Дата прохождения идентификации в формате RFC 3339 Формат: YYYY-MM-DDThh:mm:ss±hh:m string ;identified_by required;; Идентификатор пользователя проведший идентификацию клиента; string

Ответ