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

Получение информации по бизнес-картам

Обновлено 21 августа 2026

Запрос позволяет получить информацию по всем бизнес-картам пользователя, чей access_token используется для запроса. Отправьте POST-запрос с токеном доступа (access_token) пользователя в параметре Authorization заголовка и объектом пагинации pagination в теле запроса.

В параметре scope ссылки авторизации пользователя должен быть указан сервис CORPORATE_CARDS для получения доступа к этому запросу.

Особенности интеграции:

  • Валидация запроса строгая: additionalProperties: false для GetCardsRq и PaginationRq.
  • Обязательные поля запроса: pagination.offset (integer >= 0), pagination.count (integer в диапазоне [1, 10000]).
  • Поля businessCardId, cardStatus, embossedName, holderName, accountNumber, limits — необязательные (nullable).
  • Обязательные поля каждого объекта CorporateCard: maskedCardNumber, cardOpenDate, cardExpiryDate.
  • Формат cardExpiryDate: MM/YY (например, 12/28).
  • maskedCardNumber: показывает первые 6 и последние 4 цифры карты (формат 220220******0358).
Рекомендации по тестированию в песочнице

1. Успешный запрос: Отправьте POST-запрос с корректным pagination для получения списка карт.

\{
  "pagination": \{
    "offset": 0,
    "count": 10
  \}
\}

Ответ: 200 OK, массив cards с данными по картам. Если count > 100, hasNextPage будет true.

2. Валидация запроса: Любое нарушение структуры запроса вернет 400 VALIDATION_ERROR с кодом 428-001.

Недопустимые поля: Любые поля кроме pagination в теле запроса и кроме offset/count в pagination вызовут ошибку.

Запрос

Ответы

Успешный ответ

Loading...
Заметили ошибку?
Выделите текст и нажмите
Ctrl
+
Enter
, чтобы сообщить нам об ошибке