Документы бенефициара

После регистрации передайте документы бенефициара — без них работать с деньгами нельзя. Методы этого раздела работают только для ИП и физлиц и относятся к версии 3, поэтому вызываются по отдельному адресу <Адреса слоёв>/v3/jsonrpc.

Загружайте документы только после того, как бенефициар появился в мастер-системе банка. Проверьте поле is_added_to_ms методом Информация по бенефициару — оно должно быть true.

Добавление документов

Метод add_beneficiary_documents_data добавляет документы бенефициара и обновляет их данные. Каждый документ передаётся отдельным объектом в массиве documents, у каждого типа документа свой набор полей. Поля метода — в разделе Добавить документы бенефициара.

Всегда нужны паспорт и ИНН. Некоторые данные ИНН совпадают с паспортными — ФИО, место рождения, — поэтому для ИНН их указывать не нужно, сервис возьмёт их из паспорта. Достаточно передать сам ИНН и место рождения.

Документы иногда нужно обновить — например, если бенефициар сменил фамилию. Передайте новые данные паспорта и ИНН тем же методом. После успешной проверки старые документы автоматически получат дату окончания действия в поле expired_at. Если новые документы проверку не пройдут, старые перестанут действовать через 7 дней после отрицательного результата.

Документы нерезидента

Нерезидентом может быть только физлицо. Для резидента достаточно паспорта РФ (internal_passport) и ИНН (inn_f). Нерезиденту вместо паспорта РФ нужен иностранный паспорт (foreign_passport), ИНН и ещё один или несколько дополнительных документов: ВНЖ (residence_permit), виза (visa), миграционная карта (migration_card), РВП (temporary_residence_permit), патент (patent), РНР (work_permit) или трудовой договор (employment_contract).

Какие именно дополнительные документы понадобятся, зависит от страны бенефициара, указанной в паспорте. Есть три сценария: визовая страна, безвизовая страна и страна ЕАЭС (Беларусь, Казахстан, Армения, Киргизия). Все страны ЕАЭС безвизовые, но не все безвизовые страны входят в ЕАЭС — если страны нет в списке ЕАЭС, проверьте, действует ли для неё безвизовый режим.

Возможные ошибки

Код	Код текстом	Текст
6001	not_found_beneficiary	Not found beneficiary
6001	beneficiary_inn_does_not_match_in_document	Beneficiary INN does not match INN in document
6001	unsupported_beneficiary_legal_type	Unsupported beneficiary legal type
6001	document_validation_already_in_process	Document validation already in process
6001	documents_already_successfully_validated_today	Documents already successfully validated today
6001	documents_already_unsuccessfully_validated_today	Documents already unsuccessfully validated today
6001	ip_with_provided_inn_is_closed	IP with provided INN is closed
6001	ip_with_provided_inn_and_name_is_not_found	IP with provided INN and name is not found
6001	internal_error_please_again_later_or_contact_with_support_team	Internal error, please again later or contact with support team
6001	migration_card_missing	Migration card missing
6001	work_permit_missing	Work permit missing
6001	employment_contract_missing	Employment contract missing
6001	patent_or_work_permit_missing	Patent or work permit missing
6001	visa_missing	Visa missing
6001	visa_expired	Visa expired
6001	residence_permit_expired	Residence permit expired

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

Метод get_beneficiary_documents_data возвращает данные документов бенефициара и статус их проверки. Поля метода — в разделе Информация о документах бенефициара.

Ответ содержит два массива. valid_documents — документы, которые прошли проверку и признаны актуальными; именно с ними площадка может работать с деньгами. last_documents — документы из последнего запроса с текущим статусом проверки; этот массив приходит, если сервис отработал запрос без ошибок.

Чтобы понять, прошёл ли документ проверку, сначала ищите его в valid_documents. Если он там есть — проверка пройдена. Если нет — смотрите его статус в last_documents. Статусы валидации такие:

• NEW — документ ждёт завершения предыдущих проверок. Когда они закончатся, статус сменится на PENDING
• PENDING — документ готов к отправке в систему проверки
• IN_PROGRESS — идёт проверка
• SUCCESS — процесс проверки завершился. Это не значит, что документ валиден: статус говорит только о том, что ответ получен
• ERROR — при выполнении запроса произошла ошибка, повторите позже или обратитесь в поддержку

Если документа нет в valid_documents, а его статус — SUCCESS, значит проверка не пройдена. Статус IN_PROGRESS может держаться до 36 часов: в это время сервис повторяет запрос каждые 12 часов. Если ответ так и не придёт, процесс перейдёт в статус ошибки.

Возможные ошибки

Код	Код текстом	Текст
6001	unsupported_beneficiary_legal_type	Unsupported beneficiary legal type
6001	not_found_beneficiary	Not found beneficiary