Проверка карт Альфа-Банка

Методы для проверки соответствия карты и ФИО физлица через сервис Альфа-Банка.

Во всех запросах передавайте заголовки:

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

При формировании подписи используется secret_key - секретный ключ, который находится в настройках магазина мерчанта.

Идентификация по транзакции

Метод: POST

Production: https://api.pay.kvell.group/v1/person/scoring/alfabank/transaction
Stage: https://api.pay.stage.kvell.group/v1/person/scoring/alfabank/transaction

Тело запроса

Название	Тип	Обязательно	Описание
`first_name`	string	Да	Имя ФЛ. Допустимы символы: русские буквы, дефис, пробел
`last_name`	string	Да	Фамилия ФЛ. Допустимы символы: русские буквы, дефис, пробел
`middle_name`	string	Да	Отчество ФЛ. Допустимы символы: русские буквы, дефис, пробел
`verification_type`	string	Да	Тип верификации (`CARDHOLDER`/`ACCOUNT_OWNER`/`ANY`).
`transaction`	string	Да	Номер успешной транзакции на стороне мерчанта.

CARDHOLDER - проверка ФИО с ФИО держателя карты
ACCOUNT_OWNER - проверка ФИО с ФИО владельца счета
ANY - проверка ФИО по обоим вариантам, совпадение хотя бы с одним

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

{
  "first_name": "АРТЁМ",
  "last_name": "АРТЁМОВ",
  "middle_name": "АРТЁМОВИЧ",
  "verification_type": "CARDHOLDER",
  "transaction": "99ad8b11-48b8-41ea-85b7-29136d714fb1"
}

Формирование подписи

sha256({x-api-key}{json <тело запроса>}{secret_key})

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

{
  "result": "FULL_MATCH"
}

Название	Тип	Описание
`result`	string	Результат проверки. Enum: `FULL_MATCH`, `PARTIAL_MATCH`, `MISMATCH`

или

Название	Тип	Описание
`error`	json	Параметр явно характеризующий ответ с ошибкой
∟`code`	string	Код ошибки
∟`message`	string	Описание ошибки

Идентификация по номеру карты

Метод: POST

Production: https://api.pay.kvell.group/v1/person/scoring/alfabank/card
Stage: https://api.pay.stage.kvell.group/v1/person/scoring/alfabank/card

Тело запроса

Название	Тип	Обязательно	Описание
`first_name`	string	Да	Имя ФЛ. Допустимы символы: русские буквы, дефис, пробел
`last_name`	string	Да	Фамилия ФЛ. Допустимы символы: русские буквы, дефис, пробел
`middle_name`	string	Да	Отчество ФЛ. Допустимы символы: русские буквы, дефис, пробел
`verification_type`	string	Да	Тип верификации (`CARDHOLDER`/`ACCOUNT_OWNER`/`ANY`).
`pan`	string	Да	Номер карты.

CARDHOLDER - проверка ФИО с ФИО держателя карты
ACCOUNT_OWNER - проверка ФИО с ФИО владельца счета
ANY - проверка ФИО по обоим вариантам, совпадение хотя бы с одним

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

{
  "first_name": "АРТЁМ",
  "last_name": "АРТЁМОВ",
  "middle_name": "АРТЁМОВИЧ",
  "verification_type": "CARDHOLDER",
  "pan": "4111111111111111"
}

Формирование подписи

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

sha256({x-api-key}{json <тело запроса>}{secret_key})

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

{
  "result": "FULL_MATCH"
}

Название	Тип	Описание
`result`	string	Результат проверки. Enum: `FULL_MATCH`, `PARTIAL_MATCH`, `MISMATCH`

или

Название	Тип	Описание
`error`	json	Параметр явно характеризующий ответ с ошибкой
∟`code`	string	Код ошибки
∟`message`	string	Описание ошибки