Scope
subscriptions
Описание
Метод предназначен для компаний, которые хотят предоставлять своим клиентам – юридическим лицам, информацию о нефинансовых продуктах Альфа-Банка для бизнеса. Он позволяет узнать, в каких подписках клиенту доступен указанный нефинансовый продукт Альфа-Банка, и получить информацию об этих подписках.
Параметры запроса
Bearer {access_token}, полученный по Authorization Code Flow
application/json
Идентификатор продукта. Банк сообщает партнёру API
1curl --location --globoff 'https://baas.alfabank.ru/api/nfs/jp/v1/products/{productId}' \
2--header 'Authorization: Bearer {access-token}' \
3--header 'Accept: application/json'Параметры ответа
1{
2 "isAvailable": true,
3 "services": [
4 {
5 "serviceCode": "ALFA_COURSE_PLUS",
6 "priority": 1,
7 "subscriptionName": "Курс+",
8 "subscriptionExtendedState": "ACTIVE",
9 "serviceFee": 99.99,
10 "serviceFeeCurrency": "RUR",
11 "nextFeeAt": "2025-12-14T00:00:00+03:00",
12 "activatedAt": "2025-11-14T00:00:00+03:00",
13 "disabledAt": "2025-12-14T00:00:00+03:00",
14 "servicePageLink": "https://testlink.alfabank.ru/alfa-course",
15 "trialPeriod": {
16 "isTrial": true,
17 "trialMonths": 2
18 }
19 }
20 ]
21}Признак доступности продукта в подписках
Список данных о подписках, в которых доступен продукт
Код подписки
Приоритет подписки
Название подписки
Статус подписки. Принимает возможные значения:
- •
ACTIVE- активна; - •
DISABLED- отключена; - •
FREE_ACTIVE- активна в бесплатном периоде; - •
PRE_DISABLED- запланировано отключение; - •
FROZEN- заморожена; - •
NONE- отсутствует
Стоимость подписки
Код валюты. Принимает возможные значения:
- •
RUR- российский рубль
Дата следующего платежа в формате ISO 8601
Дата подключения в формате ISO 8601
Дата отключения подписки в формате ISO 8601
URL основной страницы подписки
Информация о бесплатном периоде
Признак наличия бесплатного периода
Длительность бесплатного периода в месяцах
1{
2 "isAvailable": true,
3 "services": [
4 {
5 "serviceCode": "ALFA_COURSE_PLUS",
6 "priority": 1,
7 "subscriptionName": "Курс+",
8 "subscriptionExtendedState": "ACTIVE",
9 "serviceFee": 99.99,
10 "serviceFeeCurrency": "RUR",
11 "nextFeeAt": "2025-12-14T00:00:00+03:00",
12 "activatedAt": "2025-11-14T00:00:00+03:00",
13 "disabledAt": "2025-12-14T00:00:00+03:00",
14 "servicePageLink": "https://testlink.alfabank.ru/alfa-course",
15 "trialPeriod": {
16 "isTrial": true,
17 "trialMonths": 2
18 }
19 }
20 ]
21}Код ошибки. Принимает возможные значения:
- •
invalid_request– неверные входные параметры запроса
Описание ошибки
1{
2 "error": "invalid_request",
3 "error_description": "Authorization header is not present in request headers"
4}Код ошибки. Принимает возможные значения:
- •
invalid_token– предоставленный токен просрочен, отозван, имеет неправильный формат или недействителен по другим причинам
Описание ошибки
1{
2 "error": "unauthorized",
3 "error_description": "Authorization header is not present in request headers"
4}Код ошибки. Принимает возможные значения:
- •
forbidden– доступ к ресурсу запрещён - •
insufficient_scope– недостаточно прав (scope)
Описание ошибки
1{
2 "error": "forbidden",
3 "error_description": "Access to the requested resource is forbidden"
4}Код ошибки. Принимает возможные значения:
- •
not_found– ресурс не найден
Описание ошибки
1{
2 "error": "not_found",
3 "error_description": "Requested resource was not found"
4}Код ошибки. Принимает возможные значения:
- •
too_many_requests– превышен лимит запросов
Описание ошибки
1{
2 "error": "too_many_requests",
3 "error_description": "Too many requests, please try again later"
4}Код ошибки. Принимает возможные значения:
- •
internal_error– внутренняя ошибка сервиса
Описание ошибки
1{
2 "error": "internal_error",
3 "error_description": "Internal server error occurred"
4}Код ошибки. Принимает возможные значения:
- •
service_unavailable– сервис временно недоступен
Описание ошибки
1{
2 "error": "service_unavailable",
3 "error_description": "Service is temporarily unavailable"
4}