Выписка по бизнес-карте
Для обращения к ресурсу необходимо отправлять запрос на:
Тестовый контур
https://iftfintech.testsbi.sberbank.ru:9443Промышленный контур
https://fintech.sberbank.ru:9443
Получение выписки по карте
Ресурс /v1/corporate-cards/{corpCardId}/transactions позволяет получать выписку по последним 10 операциям по бизнес-карте.
Шаги
1. Получить AccessToken.
2. Получить corpCardId.
3. Отправить запрос.
Чтобы получить последние 10 операций по выписке бизнес-карт, необходимо отправить GET-запрос (/v1/corporate-cards/{corpCardId}/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://iftfintech.testsbi.sberbank.ru:9443/fintech/api/v1/corporate-cards/550e8400-e29b-41d4-a716-446655440000/transactions'
Модель ответа
| Наименование | Описание |
|---|---|
| transactions | |
| 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 | |
| Неверный формат запроса | Неверный формат запроса | |
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 | |
| Сервис временно недоступен | Проводятся технические работы |