B2C

Завершение формирования заявки

Песочница
POST https://sandbox.alfabank.ru/api/pp/v1/debit-cards/forms/{formId}/confirmation
Пром
POST https://baas.alfabank.ru/api/pp/v1/debit-cards/forms/{formId}/confirmation
Scope

plastic-delivery

Описание

Метод используется для завершения оформления заявки.

В теле запроса должна обязательно присутствовать одна из секций:

  • •
    courierDelivery - была выбрана доставка курьером;
  • •
    officeDelivery - была выбрана доставка в офис Банка.
Параметры запроса
HEADERS
Атрибут
Описание
Authorization
stringrequired
Accept
stringrequired

application/json

Content-Type
stringrequired

application/json

PATH
Атрибут
Описание
formId
stringrequired

Идентификатор заявки

BODY
Атрибут
Описание
isUnnamedCard
booleanrequired

Признак заказа неименной карты

deliveryUuid
stringoptional

Идентификатор доставки

array of objectsoptional

Дополнительные карточные продукты (стикер, детская карта). Повторения означают количество

mpkCardType
stringrequired

Тип дополнительного продукта. Принимает возможные значения:

  • •
    LG - детская карта;
  • •
    LK - стикер
personification
stringrequired

Признак, на кого заказан продукт. Принимает возможные значения:

  • •
    FIRST_PERSON - на самого клиента;
  • •
    THIRD_PERSON - на другого человека
additionalServices
array of stringsoptional

Дополнительные некарточные продукты. Принимает возможные значения:

  • •
    INDIVIDUAL_SALARY_CLIENT - ИЗК;
  • •
    SAVINGS_ACCOUNT - накопительный счёт;
  • •
    ALPHA_SMART - подписка;
  • •
    ALPHA_CHECK - Альфа-чек;
  • •
    COMBO_ACCOUNT - комбо-счёт;
  • •
    BROKERAGE_ACCOUNT - брокерский счёт
objectoptional

Данные для доставки курьером. Тело запроса должно обязательно включать один из объектов: courierDelivery (доставка курьером) или officeDelivery (доставка в офис банка)

address
stringrequired

Адрес доставки

comment
stringoptional

Комментарий для сотрудника

date
stringrequired

Дата доставки

slotFrom
stringrequired

Время начала слота доставки

slotTo
stringrequired

Время окончания слота доставки

express
booleanrequired

Признак экспресс-доставки

objectoptional

Данные для доставки в офис банка. Тело запроса должно обязательно включать один из объектов: courierDelivery (доставка курьером) или officeDelivery (доставка в офис банка)

obtainingOffice
stringrequired

Внутрибанковский цифровой код офиса

currency
stringoptional

Код валюты

Пример запроса
Язык
1curl --location --globoff 'https://baas.alfabank.ru/api/pp/v1/debit-cards/forms/{formId}/confirmation' \
2--header 'Authorization: Bearer {access-token}' \
3--header 'Content-Type: application/json' \
4--header 'Accept: application/json' \
5--data '{
6  "isUnnamedCard": true,
7  "deliveryUuid": "bfef488d-d4be-4542-8399-0f5de89a6566",
8  "additionalProducts": [],
9  "additionalServices": [],
10  "courierDelivery": {
11    "address": "г. Москва, ул. Анохина, д. 9",
12    "date": "2026-05-16",
13    "express": false,
14    "slotFrom": "09:00",
15    "slotTo": "10:00",
16    "comment": "Позвонить"
17  },
18  "currency": "RUR"
19}'
Параметры ответа
Пример ответа 200 (OK)
1{
2  "status": "SUCCESS",
3  "passportBirthDate": "1990-09-15",
4  "payload": {
5    "specialFlow": "onlyBabyCard"
6  }
7}
BODY
атрибут
описание
status
stringrequired

Статус-результат обработки заявки. Принимает возможные значения:

  • •
    SUCCESS - успешное окончание процесса формирования доставки пластика;
  • •
    NEED_SMS - необходимо ввести код подтверждения для завершения процесса формирования доставки пластика (у токена пользователя истёк срок)
passportBirthDate
stringrequired

Дата рождения пользователя

objectoptional

Дополнительные данные

specialFlow
stringoptional

Kлиентский путь

Пример ответа 200 (OK)
1{
2  "status": "SUCCESS",
3  "passportBirthDate": "1990-09-15",
4  "payload": {
5    "specialFlow": "onlyBabyCard"
6  }
7}
BODY
атрибут
описание
error
stringrequired

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

  • •
    invalid_request - неверные входные параметры запроса
error_description
stringoptional

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

Пример ошибки 400 (Bad Request)
1{
2  "error": "invalid_request",
3  "error_description": "The request is missing a required parameter, includes an unsupported parameter or parameter value, repeats the same parameter, uses more than one method for including an access token, or is otherwise malformed"
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
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

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

  • •
    conflict - заявка не является черновиком
error_description
stringoptional

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

Пример ошибки 409 (Conflict)
1{
2  "error": "conflict",
3  "error_description": "The request is valid, but cannot be completed due to some kind of mismatch"
4}
BODY
атрибут
описание
error
stringrequired

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

  • •
    gone - выбранный для бронирования слот недоступен
error_description
stringoptional

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

Пример ошибки 410 (Gone)
1{
2  "error": "gone",
3  "error_description": "The requested resource is no longer available"
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}
Нет тела ответа