Response and errors

Response processing

Analyze the response's HTTP code first.

If the response code is 200, check the status field.

If the status is ok, the request was a success. See more in data.

Response HTTP codes

200: Correct request, check status.

422: Request error. See more in error.description:

• request_body_validation_error — Error in the request body
• request_header_validation_error — x-partner-project header is missing

500 — Error on Bank 131's side. Please send the request again later.

Status

Response statuses are passed in the status field.

ok: Request processed successfully. See more in data.

pending: Request is being processed. To find out the result, send the same request later.

error: Request processing error. See more in Error.

Error codes

Errors are passed in Error:

• code — an error code,
• description — an error description.

code	description	Error description
invalid_sign	Запрос с указанным идентификатором подписан некорректно	Incorrect check request signature
passport_validation_failure	По данным МДВ предоставленный паспорт признан недействительным	The passport is invalid
passport_validation_failure	В базе данных МВД отсутствуют сведения о предоставленном паспорте	No information about the passport was found
inn_validation_failure	По данным ФНС предоставленный паспорт не соответствует предоставленному ИНН	The INN value is not linked to the passport specified
already_exists	Запрос на проверку с теми же данными был направлен ранее	You have already submitted these data for identification. To see the result, send the check{id} request with the previous verification's ID that you received in the data.id field
request_not_found	Не найден запрос с указанным идентификатором	The request with the given ID was not found
partner_project_not_found	Не найден проект с указанным в заголовке идентификатором	The project ID sent in the X-PARTNER-PROJECT header does not exist
birthday_validation_failure	Возраст проверяемого лица ниже допустимого порога	Minor applicant must be an adult. If you receive this error when working with a nominal account, contact your manager
validation_error	Example of the description field body: 1 validation error for Request.body -> payload -> documents -> 2 -> expire_date. Document MIGRATION_CARD is expired (type=value_error)	Invalid formats and/or controls in values. For detailed information see description

Response examples

Passport is not valid

{
    "status": "error",
    "error": {
        "code": "passport_validation_failure",
        "description": "По данным МДВ предоставленный паспорт признан недействительным"
    }
}

No passport information available

{
    "status": "error",
    "error": {
        "code": "passport_validation_failure",
        "description": "В базе данных МВД отсутствуют сведения о предоставленном паспорте"
    }
}

Passport and INN do not match

{
    "status": "error",
    "error": {
        "code": "inn_validation_failure",
        "description": "По данным ФНС предоставленный паспорт не соответствует предоставленному ИНН"
    }
}