ym88659208ym87991671
Выписка по бизнес-карте | Документация SmartMarket
Skip to main content

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

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

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

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

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