B2C

Генерация QR-кода для привязки счёта/подписки в СБП

Песочница
POST https://sandbox.alfabank.ru/api/sbp/jp/v1/subscriptions
Пром
POST https://baas.alfabank.ru/api/sbp/jp/v1/subscriptions
Scope

c2b-sbp

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

application/json

Content-Type
stringrequired

application/json

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

Номер терминала

subscriptionPurpose
stringrequired

Цель привязки счёта. Максимальное количество символов - 140. При отсутствии параметра будет зарегистрирована обычная одноразовая платёжная ссылка СБП с qrcType = 02 без последующего предоставления плательщику возможности совершить привязку счёта

ttl
integeroptional

Срок жизни платёжной ссылки в минутах

objectrequired

Данные запроса

notificationUrl
stringrequired

Полный URL для получения уведомления о финальном статусе операции по QR-коду

redirectUrl
stringoptional

Ссылка для автоматического возврата в приложение или на сайт торгово-сервисного предприятия (ТСП)

Пример запроса
Язык
1curl --location 'https://baas.alfabank.ru/api/sbp/jp/v1/subscriptions' \
2--header 'Authorization: Bearer {access-token}' \
3--header 'Content-Type: application/json' \
4--header 'Accept: application/json' \
5--data '{
6  "termNo": "30000600",
7  "subscriptionPurpose": "Подписка на оплату интернета 500р./мес.",
8  "ttl": 4320,
9  "queryData": {
10    "notificationUrl": "http://10.8.18.33:9017/sbp-payment/agent/status"
11  },
12  "redirectUrl": "https://exampletsp.io/qwertyui"
13}'
Параметры ответа
Пример ответа 201 (Created)
1{
2  "qrcId": "AS1R0060MBC2CH7R9S79VP0FT4F37KEB",
3  "payload": "https://qr.nspk.ru/AS1R0060MBC2CH7R9S79VP0FT4F37KEB",
4  "payrrn": "000021266185"
5}
BODY
атрибут
описание
qrcId
stringrequired

Идентификатор QR-кода

payload
stringrequired

Платёжная ссылка

payrrn
stringrequired

Референсный идентификатор запроса в системе Банка

Пример ответа 201 (Created)
1{
2  "qrcId": "AS1R0060MBC2CH7R9S79VP0FT4F37KEB",
3  "payload": "https://qr.nspk.ru/AS1R0060MBC2CH7R9S79VP0FT4F37KEB",
4  "payrrn": "000021266185"
5}
BODY
атрибут
описание
error
stringrequired

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

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

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

Пример ошибки 400 (Bad Request)
1{
2  "error": "invalid_request",
3  "error_description": "Authorization header is not present in request headers"
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

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

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

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

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