Перейти к основному содержимому

MandarinID песочница

Общая информация​

Для подключения на тестовом аккаунте продукта MandarinID (УПРИД) необходимо обратиться в службу технической поддержки.

Для работы с тестовым окружением MandarinID используются параметры запроса боевого окружения.

Основные условия для тестового окружения, наличие проекта в статусе "Песочница" (Данную информацию можно проверить в Личном кабинете вкладка Настройки, Общие настройки проекта) и подключение продукта MandarinID службой технической поддержки.

MandarinID песочница

Аутентификация запросов происходит за счет авторизационной строки, которая передается в параметре заголовка X-Auth. Так же возможна авторизация с помощью Basic auth.

Данные для аутентификации запросов используются данные от тестового проекта с подключенным продуктом MandarinID. Подробнее о аутентификации запросов.

При работе с тестовым окружением СМС-сообщение с кодом для подтверждения номера телефона не отправляется. Необходимо использовать код 000000. В некоторых случаях количество цифр в СМС-коде может отличаться.

Для получения статуса верификации персоны (personVerified) - true необходимо передавать следующие параметры:

    "firstName": "Полиграф",
    "lastName": "Шариков",
    "patronymic": "Полиграфович",

При указании других данных, в ответе на запрос будет получен personVerified - false.

ВАЖНО!

Это не отменяет необходимость отправлять паспорт и другие данные, согласно документации. На тестовом окружении верификация производится по указанным ФИО.

Примеры запросов​

Запрос на идентификацию по СНИЛС​

POST https://secure.mandarinpay.com/api/personidentification
{
    "firstName": "Полиграф",
    "lastName": "Шариков",
    "patronymic": "Полиграфович",
    "passportSeries": "1111",
    "passportNumber": "111111",
    "snils": "19033603123",
    "phone": "+79506236517"
}

Запрос на идентификацию по ИНН​

ВАЖНО!

Параметр snils обязателен так же для запроса на идентификацию по ИНН, но в данном случае передается значение NULL.

POST https://secure.mandarinpay.com/api/personidentification
{
    "firstName": "Полиграф",
    "lastName": "Шариков",
    "patronymic": "Полиграфович",
    "passportSeries": "1111",
    "passportNumber": "111111",
    "snils": "",
    "inn": "501716749325",
    "phone": "+79506122517"
}

Ответ в случае успешного создания запроса (200 ОК)

{
    "id": "794d3cc7-a2b4-4579-9173-bafc7d7dc29d"
}

Запрос с передачей СМС-кода на проверку​

PUT https://secure.mandarinpay.com/api/personidentification/{id}
{
    "smsCode": "000000"
}

Ответ в случае успешного создания запроса (200 ОК)

{
    "id": "794d3cc7-a2b4-4579-9173-bafc7d7dc29d"
}

Запрос статуса идентификации​

GET https://secure.mandarinpay.com/api/personidentification/{id}

Ответ в случае успешного завершения запроса (200 ОК)

{
    "id": "485fc237-a8b8-45f9-816d-fb7de3715e2b",
    "phoneVerified": null,
    "phoneVerificationFinished": false,
    "personVerified": true,
    "personVerificationFinished": true,
    "personVerificationError": "Sandbox mode"
}

Указаны данные Шариков Полиграф Полиграфович. Еще не произведен запрос с передачей кода на проверку.

{
    "id": "485fc237-a8b8-45f9-816d-fb7de3715e2b",
    "phoneVerified": true,
    "phoneVerificationFinished": true,
    "personVerified": true,
    "personVerificationFinished": true,
    "personVerificationError": "Sandbox mode"
}

Указаны данные Шариков Полиграф Полиграфович. Произведена отправка кода на проверку.

{
    "id": "d3552b7c-80a6-4e0e-bf1f-ad0c7ff2d705",
    "phoneVerified": true,
    "phoneVerificationFinished": true,
    "personVerified": false,
    "personVerificationFinished": true,
    "personVerificationError": "Sandbox mode"
}

Указаны данные отличные от Шариков Полиграф Полиграфович. Произведена отправка кода на проверку.

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

код ошибки 401:

Не пройдена авторизация запроса.

{
    "error": "Authentication error: "
}

код ошибки 400:

{
    "sessionId": [
        "The value '{id}\n' is not valid."
    ]
}

Значение id не указано для запроса статуса идентификации.

{
    "snils": [
        "Required property 'snils' not found in JSON. Path '', line 9, position 1."
    ]
}

В запросе на идентификацию не указан параметр snils

{
    "snils": [
        "The field Snils must match the regular expression '[0-9]{11}'."
    ]
}

Параметр snils содержит не допустимые символы или превышает размер поля.

Ошибки 5xx:

Ошибка на стороне сервера. (Встречается крайне редко)

Содержание