B2C

Создание запроса на упрощённую делегированную идентификацию клиента

Песочница
POST https://sandbox.alfabank.ru/api/pp/v1/user-compliance/operations/simplified
Пром
POST https://baas.alfabank.ru/api/pp/v1/user-compliance/operations/simplified
Scope

simple-compliance

Описание

Метод предназначен для асинхронного проведения упрощённой делегированной идентификации и позволяет создать запрос на проведение идентификации клиента по поручению партнёра. Результат запроса Банк отправит с помощью метода партнёра. Подходит организациям, которым необходимо проводить идентификацию клиентов в соответствии с требованиями 115-ФЗ.

Параметры запроса
HEADERS
Атрибут
Описание
Authorization
stringrequired
Accept
stringrequired

application/json

Content-Type
stringrequired

application/json

BODY
Атрибут
Описание
callbackUri
stringrequired

URL, на который будет отправлен результат асинхронной проверки. Необходимо указывать хост, который указывали в качестве redirect_uri при интеграции с Alfa ID. Проверка будет проводиться только на соответствие домена второго уровня

Пример запроса
Язык
1curl --location 'https://baas.alfabank.ru/api/pp/v1/user-compliance/operations/simplified' \
2--header 'Authorization: Bearer {access-token}' \
3--header 'Content-Type: application/json' \
4--header 'Accept: application/json' \
5--data '{
6  "callbackUri": "https://callback.partner.ru/api/v1/callback-events"
7}'
Параметры ответа
Пример ответа 202 (Accepted)
1{
2  "operationId": "22413cd0-11d7-4a1a-826d-a82470c18a83"
3}
BODY
атрибут
описание
operationId
stringoptional

Идентификатор операции по проведению идентификации клиента

Пример ответа 202 (Accepted)
1{
2  "operationId": "22413cd0-11d7-4a1a-826d-a82470c18a83"
3}
BODY
атрибут
описание
error
stringrequired

Код ошибки. Принимает возможные значения:

  • invalid_request - отсутствуют обязательные параметры или тело запроса;
  • invalid_callbackUri - передан некорректный callbackUri
error_description
stringoptional

Описание ошибки

Пример ошибки 400 (Bad Request)
1{
2  "error": "invalid_callbackUri",
3  "error_description": "The required field callbackUri is missing or has an invalid format"
4}
BODY
атрибут
описание
error
stringrequired

Код ошибки. Принимает возможные значения:

  • invalid_token - предоставленный токен просрочен, отозван, имеет неправильный формат или недействителен по другим причинам
error_description
stringoptional

Описание ошибки

Пример ошибки 401 (Unauthorized)
1{
2  "error": "invalid_token",
3  "error_description": "The access token provided is expired, revoked, malformed, or invalid for other reasons"
4}
BODY
атрибут
описание
error
stringrequired

Код ошибки. Принимает возможные значения:

  • insufficient_scope - при запросе кода авторизации не были переданы все необходимые scopes. Необходимо переподписать договор согласия, повторно отправив запрос на получение кода авторизации с указанием всех доступных scopes и параметра prompt=consent
error_description
stringoptional

Описание ошибки

Пример ошибки 403 (Forbidden)
1{
2  "error": "insufficient_scope",
3  "error_description": "The request requires higher privileges than provided by the access token"
4}
BODY
атрибут
описание
error
stringrequired

Код ошибки. Принимает возможные значения:

  • unknown_endpoint - эндпоинт не найден или неактивен
error_description
stringoptional

Описание ошибки

Пример ошибки 404 (Not Found)
1{
2  "error": "unknown_endpoint",
3  "error_description": "Endpoint is not found or not active"
4}
Нет тела ответа
BODY
атрибут
описание
error
stringrequired

Код ошибки. Принимает возможные значения:

  • internal_error - внутренняя ошибка сервиса при выполнении обработки запроса
error_description
stringoptional

Описание ошибки

Пример ошибки 500 (Internal Server Error)
1{
2  "error": "internal_error",
3  "error_description": "Internal server error"
4}
Нет тела ответа