Данные по бизнес-картам

Обновлено 29 февраля 2024

Для обращения к ресурсу необходимо отправлять запрос на:

• Тестовый контур https://iftfintech.testsbi.sberbank.ru:9443

• Промышленный контур https://fintech.sberbank.ru:9443

Получение информации по карте

Ресурс /v1/corporate-cards/{corpCardId} позволяет получить информацию по открытой бизнес-карте.

Шаги

1. Получить AccessToken.

2. Получить corpCardId.

3. Отправить запрос.

Чтобы получить информацию по бизнес-карте, необходимо отправить GET запрос (/v1/corporate-cards/{corpCardId}), в котором нужно передать авторизационный токен к данным организации клиента (Access Token) и идентификатор бизнес-карты (corpCardId). Авторизационный токен передается в параметре Authorization заголовка запроса.

Чтобы получить доступ к ресурсу, необходимо передать в scope сервис CORPORATE_CARDS.

Модель запроса

Наименование	Описание
Параметры заголовка
Authorization (String)	Access token организации-клиента, полученный через SSO Пример: Bearer c76fb018-27c9-43f7-a751-62646eda7e1a-1
Параметры запроса
corpCardId (String)	Идентификатор бизнес-карты Пример: 550e8400-e29b-41d4-a716-446655440000

Пример запроса

curl -X GET --header 'Accept: application/json' --header
'Authorization: Bearer c76fb018-27c9-43f7-a751-62646eda7e1a-1'
'https://iftfintech.testsbi.sberbank.ru:9443/fintech/api/v1/corporate-cards/550e8400-e29b-41d4-a716-446655440000'

Модель ответа

Наименование	Описание
cardPan (String (22), optional)	Номер карты
cardIssuedDate (Date, optional)	Дата выдачи карты
cardExpiredDate (Date, optional)	Дата окончания
corpCardId (String (40), optional)	Идентификатор бизнес-карты
limit (массив JSON (array))
code (String (60), optional)	Код типа лимита Заполняется значением из справочника СorpCardLimitType
amount (Number (34,4), optional)	Значение лимита

Пример ответа

{
   "cardPan":0000000000000000
   "cardIssuedDate":09-2020
   "cardExpiredDate":09-2023
   "corpCardId":"550e8400-e29b-41d4-a716-446655440000"
   "limit":[
      {
         "code":"T_MN_BUS"
         "amount":100000
      }
   ]
}

Получение информации по всем картам

Ресурс /v1/corporate-cards позволяет получить информацию по всем бизнес-картам клиента.

Шаги

1. Получить AccessToken.

2. Отправить запрос.

Чтобы получить всю информацию по бизнес-картам клиента, необходимо отправить GET запрос (GET /v1/corporate-cards), в котором передать авторизационный токен к данным организации клиента (Access Token). Авторизационный токен передается в параметре Authorization заголовка запроса.

Чтобы получить доступ к ресурсу, необходимо передать в scope сервис CORPORATE_CARDS.

Модель запроса

Наименование	Описание
Параметры заголовка
Authorization (String)	Access token организации-клиента, полученный через SSO Пример: Bearer c76fb018-27c9-43f7-a751-62646eda7e1a-1

Пример запроса

curl -X GET --header 'Accept: application/json' --header
'Authorization: Bearer c76fb018-27c9-43f7-a751-62646eda7e1a-1'
'https://iftfintech.testsbi.sberbank.ru:9443/fintech/api/v1/corporate-cards'

Модель ответа

Наименование	Описание
corpCards
cardPan (String (22), optional)	Номер карты
cardIssuedDate (Date, optional)	Дата выдачи карты
cardExpiredDate (Date, optional)	Дата окончания
corpCardId (String (40), optional)	Идентификатор бизнес-карты
limit (массив JSON (array))
code (String (60), optional)	Код типа лимита
amount (Number (34,4), optional)	Значение лимита

Пример ответа

{
   "cardPan":0000000000000000
   "cardType":"Visa Business Credit"
   "cardIssuedDate":09-2020
   "cardExpiredDate":09-2023
   "corpCardId":"550e8400-e29b-41d4-a716-446655440000"
   "limit":[
      {
         "code":"T_MN_BUS"
         "amount":100000
      }
   ]
}

Дополнительная информация

Коды возврата

Код	Описание	Причина возникновения
200 (GET-запрос)	OK
	Успешный код возврата
201 (POST-запрос)	CREATED
	Создан
204	NO_CONTENT
	Данные о клиенте не найдены
400	DESERIALIZATION_FAULT
	Неверный формат запроса	Неверный формат запроса
	WORKFLOW_FAULT
	Для внешнего сервиса недоступны операции по счету: 40702810ХХХХХХХХХХХХ	Для внешнего сервиса недоступны операции по счету: - счет не добавлен в список разрешенных в оферте; - счет указан неверно. Отсутствует доступный открытый рублевый расчетный счет у организации плательщика
	VALIDATION_FAULT
	Ошибка валидации	Ошибка валидации данных запроса с указанием некорректных значений. Значения полей модели или параметров запроса не соответствуют допустимым и определенным в модели
401	UNAUTHORIZED
	accessToken not found by value =хххххххх-хххх-хххх-хххх-хххххххххххх-х	Указан некорректный или просроченный access_token
403	ACTION_ACCESS_EXCEPTION
	Карта с идентификатором 31663ef5-7975-4016-b0f3-f1d70a4e9c22 недоступна для внешнего сервиса	Для внешнего сервиса недоступны операции по счету: счет, к которому привязана карта, не добавлен в список разрешенных в оферте.
	Операция не может быть выполнена: доступ к ресурсу запрещен	У пользователя нет прав на использование соответствующего сервиса Sber API (Fintech API), доступ к которому не предусмотрен настройками scope
404	NOT_FOUND
	Бизнес-карта с указанным ID не найдена	Невозможно найти бизнес-карту с указанным внешним идентификатором
500	UNKNOWN_EXCEPTION
	Внутренняя ошибка сервера
503	UNAVAILABLE_RESOURCE_EXCEPTION
	Сервис временно недоступен	Проводятся технические работы