ym88659208ym87991671
Выписка по бизнес-карте - интеграция для партнеров | Документация для разработчиков

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

Обновлено 20 декабря 2023

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

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

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