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

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

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

Для использования методов бизнес-карт необходимо произвести соответствующие настройки сервиса на стороне Банка.

Получение выписки по карте

Ресурс /v1/corporated-cards/transactions позволяет получать выписку на последние 10 операций по бизнес-карте.

Шаги

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

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

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

Авторизация

Чтобы получить последние 10 операций по выписке бизнес-карт, необходимо отправить GET-запрос (/v1/corporated-cards/transactions), в котором нужно передать авторизационный токен к данным организации клиента (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://edupirfintech.sberbank.ru:9443 /fintech/api/v1/corporated-cards/transactions?corpCardId=550e8400-e29b-41d4-a716-446655440000'

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

Наименование Описание
corpCardTransactions
date (Date) Дата транзакции
place (String (255)) Место транзакции
description (String (255)) Описание транзакции
amount (Number (19,2)) Сумма транзакции
currencyName (String (3)) Буквенный ISO-код валюты

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

  "corpCardTransactions": [
    {
      "date": "2021-11-01T15:47:14",
      "place": "RUS MOSCOW Cash RUS MOSCOW OSB 6901 1241",
      "description": "Cash",
      "amount": "566.00",
      "currencyName": "RUR"
    }
  ]

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

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

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

Заметили ошибку?

Выделите текст и нажмите Ctrl + Enter, чтобы сообщить нам о ней