Перейти к содержанию

Список корпоративных карт

Метод получения списка корпоративных карт по авторизованной сессии Сбер. Идентификатор карты используется в методах выплат через Сбер как business_card_id.

URL

Метод: GET

  • Production: https://api.baas.kvell.group/v1/sber/corporate-cards
  • Stage: https://api.baas.stage.kvell.group/v1/sber/corporate-cards

Параметры запроса

Название Тип данных Обязательно Описание
session_id string Да Идентификатор авторизованной сессии Сбер
page integer Нет Номер страницы. По умолчанию 1.
size integer Нет Размер страницы. По умолчанию 10.

Пример запроса

GET /v1/sber/corporate-cards?session_id=11111111-1111-1111-1111-111111111111&page=1&size=10 HTTP/1.1
Host: api.baas.kvell.group
X-Api-Key: 00000000-0000-0000-0000-000000000000
X-Signature: signature

Заголовки запроса

Название Тип данных Обязательно Описание
X-Api-Key string Да Уникальный идентификатор магазина
X-Signature string Да Подпись

Подпись X-Signature формируется конкатенацией X-Api-Key, session_id и secret_key. Формируется sha256 от полученной строки:

sha256({X-Api-Key}{session_id}{secret_key})

где secret_key - секретный ключ, который находится в настройках магазина мерчанта.

Ответ запроса

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

{
  "items": [
    {
      "business_card_id": "business-card-id",
      "card_status": "ACTIVE",
      "masked_card_number": "427600******1234",
      "user_is_holder": true,
      "card_expiry_date": "2026-12-31T00:00:00Z"
    }
  ],
  "page": 1,
  "size": 10
}

{
  "errors": [
    {
      "code": 0,
      "message": "Field required",
      "field": "session_id"
    }
  ]
}

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

Название
 Тип данных Описание
items array Список корпоративных карт
∟business_card_id string Идентификатор бизнес-карты, передаётся в методах выплат как business_card_id. До 36 символов.
∟card_status string Статус карты, например ACTIVE
∟masked_card_number string Замаскированный номер карты
∟user_is_holder boolean Признак держателя карты: пользователь сессии является держателем карты
∟card_expiry_date string Дата истечения срока действия карты
page integer Номер страницы из запроса
size integer Размер страницы из запроса

Коды ошибок приведены в разделе Общее.