Skip to main content

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.

HTTP response 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.
CodeDescriptionWhat you can do
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 a 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_errorExample 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": "По данным ФНС предоставленный паспорт не соответствует предоставленному ИНН"
}
}