Skip to main content

Identification request

Check method​

You should use this method to send a beneficiary questionnaire to Bank 131 for identification.

Request v 2.0 allows you to send profiles of individuals, residents and non-residents of the Russian Federation, for verification. Request v 1.1 allows you to submit profiles only for residents of the Russian Federation for verification.

The response includes the request ID by which you can learn the verification result.

Endpoint​

For testing​

POST https://kyc-stage.bank131.ru/api/v2.0/check

When testing, no real ID verification is performed, and answer will be emulated. Do not take these results to verify your customers' IDs.

For live testing​

POST https://kyc.bank131.ru/api/v2.0/check

Request​

Non-resident individuals can sign their requests using RSA Keys (example). To enable this functionality, contact your manager in Bank 131.

Request parameters (recipient details)​

NameMandatoryTypeDescription
type+stringRecipient type. Possible values:
FL_RESIDENT - resident individual;
FL_NONRESIDENT - non-resident individual
last_name+stringLast name
first_name+stringFirst Name
patronymic-stringPatronymic name (if any)
birthday+stringDate of Birth as DD.MM.YYYY. Must be 18 years old or older
birthplace+stringPlace of Birth
citizenship+stringCitizenship in ISO 3166-1 alpha-2 format
inn+stringTaxpayer Identification Number (INN in Russia), 6 to 14 characters
phone_number+stringPhone number (any format)
e-mail+stringValid email address
documents+arrayMandatory documents. The set of mandatory documents may vary depending on the beneficiary type and their citizenship according to the following rules:
for individuals residents of the Russian Federation - only a Russian passport PASSPORT_RF is required;
for individuals non-residents of the Russian Federation - a foreign passport FOREIGN_PASSPORT and any other type of document other than the Russian passport PASSPORT_RF is required;
for citizens of the Republic of Belarus - only a foreign passport FOREIGN_PASSPORT is required
  type+stringDocument type. Possible values:
PASSPORT_RF – Russian passport;
FOREIGN_PASSPORT – non-Russian passport;
MIGRATION_CARD - migration card;
RESIDENT_CARD – resident card;
REFUGEE_CERTIFICATE – refugee certificate;
VISA – visa;
ARRIVAL_NOTICE – arrival notice;
TEMPORARY_RESIDENCE_PERMIT – temporary residence permit;
PATENT – patent
  issuer_code- (Mandatory only for PASSPORT_RF)stringIssuing division code
  issuer+stringIssuing division
  issuer_date+stringIssuing date as DD.MM.YYYY
postcode-stringZIP Code
address+stringAddress
agent_contract_number+stringAgency Agreement No.
agent_contract_date+stringAgency Agreement Date
beneficial_owners+stringAlways: No BO
public_officials+stringAlways No

Request example​

curl -X POST 'https://kyc.bank131.ru/api/v2.0/check/' \
   -H 'x-partner-project: test-partner-project' \
   -H 'Content-Type: application/json' \
   -H 'accept: application/json' \
   --data-binary
   '{
   "payload":{
      "type":"FL_RESIDENT",
      "last_name":"Dmitriev",
      "first_name":"Ivan",
      "patronymic":"Ivanovich",
      "birthday":"01.01.1970",
      "birthplace":"Novgorod",
      "citizenship":"RU",
      "inn":"065553161159",
      "phone_number":"+79000000000",
      "email":"name@email.com",
      "documents":[
         {
            "type":"PASSPORT_RF ",
            "number":"0234567890",
            "issuer":"UFMS Russia",
            "issuer_date":"01.01.2010",
            "issuer_code":"123-000"
         }
      ],
      "address":"Novgorod, Pribrezhnaya str., 53",
      "postcode":"365826",
      "agent_contract_number":"123456789-0",
      "agent_contract_date":"01.01.2020",
      "beneficial_owners":"No BO",
      "public_officials":"No"
   },
       "signature":"dkQzYwTExRc0RFWk1CY0dBMVVFQnd3UTBMTXVJTkNjMEw3Ug0NCmd..."}' --compressed

Response​

For testing, the value of the status field sent in the response strictly depends on the last digit in ID number of the passport_number field sent in the request.

Last digit of passport_number fieldstatus field value
Even, including 0ok
Unevenerror

Response parameters​

NameMandatoryTypeDescription
status+stringIdentification status. Possible options: ok, error
data-DataResponse details object
  id-numberCheck request ID
  description-stringRequest status description
error-ErrorError details object
  code+stringError code
  description+stringError description
Successful response example​
    {
        "status": "ok",
        "data":
            {
                "id": "7",
                "description": "request added to queue"
               }
    }
Example of a response with an error​
    {
        "status": "error",
        "error": {
            "code": "partner_project_not_found",
            "description": "partner project not found"
        }
    }