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

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

Тестовый контур 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`
	Сервис временно недоступен	Проводятся технические работы

Обновлено 20 апреля 2022

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

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

Популярные