Проверка паспорта

Метод check

Этот запрос нужен, чтобы провести проверку паспортных данных получателя выплаты (физлица).

В ответе возвращается идентификатор запроса, по нему можно узнать результат проверки.

Адрес для отправки запроса

Для тестирования

POST https://kyc-stage.bank131.ru/api/v1.1/check

При тестировании реальная проверка паспортных данных в СМЭВ не производится, результат проверки будет эмулирован. Не используйте проверку на тестовой среде для идентификации клиентов.

Для реальных операциий

POST https://kyc.bank131.ru/api/v1.1/check

Запрос

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

Данные получателя

Название	Обязательность	Тип	Описание
first_name	+	string	Фамилия
last_name	+	string	Имя
patronymic	-	string	Отчество
birthday	+	string	Дата рождения
birthplace	+	string	Место рождения
inn	+	string	ИНН, 12 цифр

Удостоверение личности (паспорт)

Название	Обязательность	Тип	Описание
identity_document	+	string	Тип документа. Всегда: Паспорт гражданина РФ
passport_number	+	string	Серия и номер паспорта, без пробелов. Пример: 1234567890.
issuer	+	string	Кем выдан
issuer_code	+	string	Код подразделения
issuer_date	+	string	Дата выдачи в формате ДД.ММ.ГГГГ
citizenship	+	string	Гражданство. Всегда РФ

Адрес регистрации

Название	Обязательность	Тип	Описание
postcode	+	string	Индекс
address	+	string	Адрес

Контакты получателя

Название	Обязательность	Тип	Описание
email	+	string	Адрес электронной почты (нужен валидный адрес)
phone_number	+	string	Номер телефона в любом формате

Дополнительные данные

Название	Обязательность	Тип	Описание
agent_contract_number	+	string	Номер агентского договора с получателем
agent_contract_date	+	string	Дата агентского договора с получателем
beneficial_owners	+	string	Всегда БВ отсутствуют
public_officials	+	string	Всегда Нет
migration_card	+	string	Всегда -
right_to_stay_in_rf	+	string	Всегда -

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

curl 'https://kyc.bank131.ru/api/v1/check/' \
   -H 'x-partner-project: test-partner-project' \
   -H 'Content-Type: application/json' \
   -H 'accept: application/json' \
   --data-binary
   '{
   "payload":
       {
           "inn":"065553161159",
           "email":"name@email.com",
           "issuer":"ОТДЕЛОМ УФМС РОССИИ",
           "address":"г. Бобруйск, алл. Прибрежная, д. 53 стр. 9, 365826",
           "birthday":"01.01.1970",
           "postcode":"365826",
           "birthplace":"г. Бобруйск",
           "last_name":"Дмитриев",
           "first_name":"Иван",
           "patronymic":"Герасимович",
           "citizenship":"РФ",
           "issuer_code":"123-000",
           "issuer_date":"01.01.2010",
           "phone_number":"+79000000000",
           "migration_card":"-",
           "passport_number":"0234567890",
           "public_officials":"Нет",
           "beneficial_owners":"БВ отсутствуют",
           "identity_document":"Паспорт гражданина РФ",
           "agent_contract_date":"01.01.2020",
           "right_to_stay_in_rf":"-",
           "agent_contract_number":"123456789-0"
       },
       "signature":"dkQzYwTExRc0RFWk1CY0dBMVVFQnd3UTBMTXVJTkNjMEw3Ug0NCmd..."}' --compressed

Ответ

При тестировании успех проверки (значение поля status в ответе) зависит от последней цифры номера паспорта в поле passport_number в запросе.

Последняя цифра passport_number	Значение status
Четный, включая 0	ok
Нечетный	error

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

Название	Обязательность	Тип	Описание
status	+	string	Статус проверки. Возможные варианты: ok, error
data	-	Data	Объект с данными ответа
id	-	number	Идентификатор запроса check
description	-	string	Описание статуса запроса
error	-	Error	Объект с данными ошибки
code	+	string	Код ошибки
description	+	string	Описание ошибки

Пример успешного ответа

{
    "status": "ok",
    "data":
        {
            "id": "7",
            "description": "запрос добавлен в очередь"
           }
}

Пример ответа с ошибкой

{
    "status": "error",
    "error": {
        "code": "partner_project_not_found",
        "description": "partner project not found"
    }
}