openapi: 3.2.0 info: title: Raiffeisen Ru Corpcards Operation API x-refined-note: - x-description-i18n differs across the merged source definitions and was not carried - x-logo differs across the merged source definitions and was not carried version: '1.0' description: 'Operations tagged corpcards-operation-api across 3 of this provider''s published API definitions: raiffeisen-ru-raif-pay-corporate-cards-openapi.json, raiffeisen-ru-corporate-cards-openapi.yml, raiffeisen-ru-raif-pay-corporate-cards-openapi.yml. Each path carries the servers of the definition it was published in.' servers: - url: https://pay-test.raif.ru description: Sandbox - url: https://pay.raif.ru description: Production - url: https://api.raiffeisen.ru/corporate-cards tags: - name: corpcards-operation-api x-displayName: Операции по картам x-x-displayName-i18n: eng: Cards operation description: 'Для просмотра информации и управления картой Райффайзенбанк предоставляет API: * Просмотр списка карт * Подробная информация по карте * История действий * Список операций * Реквизиты карты * Установка лимитов * Блокировка, разблокировка и закрытие карты' x-description-i18n: eng: 'To view and manage cards, Raiffeisenbank provides the following API: * View card list * Card details * Action history * Transaction list * Card details * Set limits * Block, unblock, and close card ' paths: /api/cards/v1/corporate-cards/cards: get: operationId: getCardsWithFilterAndPagination parameters: - $ref: '#/components/parameters/Page' - $ref: '#/components/parameters/Size' - $ref: '#/components/parameters/AccountInQuery' - $ref: '#/components/parameters/ExpiryStartDate' - $ref: '#/components/parameters/ExpiryEndDate' - $ref: '#/components/parameters/Status' - $ref: '#/components/parameters/Product' - $ref: '#/components/parameters/FullNameParam' summary: Список карт x-summary-i18n: eng: List of cards description: Подробная информация о картах с фильтром и пагинацией deprecated: true x-description-i18n: eng: Detailed information about maps with filter and pagination tags: - corpcards-operation-api responses: '200': description: OK content: application/json: schema: type: object description: Страница карт x-description-i18n: eng: Page of cards properties: meta: allOf: - $ref: '#/components/schemas/Meta' data: type: array items: allOf: - $ref: '#/components/schemas/CardDto' '400': $ref: '#/components/responses/400_business_exception' '401': $ref: '#/components/responses/401_without_traceId' '500': $ref: '#/components/responses/500_without_traceId' security: - Authorization: [] servers: - url: https://pay-test.raif.ru description: Sandbox - url: https://pay.raif.ru description: Production /api/cards/v1/corporate-cards/cards/{cardId}: parameters: - $ref: '#/components/parameters/CardId' get: summary: Информация о карте x-summary-i18n: eng: Information about card operationId: getCardById description: Подробная информация по конкретной карте deprecated: true x-description-i18n: eng: Detailed card information tags: - corpcards-operation-api responses: '200': description: OK content: application/json: schema: allOf: - $ref: '#/components/schemas/CardDto' '400': $ref: '#/components/responses/400_invalid_data' '401': $ref: '#/components/responses/401_without_traceId' '500': $ref: '#/components/responses/500_without_traceId' security: - Authorization: [] servers: - url: https://pay-test.raif.ru description: Sandbox - url: https://pay.raif.ru description: Production /api/cards/v1/corporate-cards/cards/{cardId}/actions: get: tags: - corpcards-operation-api summary: История действий по карте x-summary-i18n: eng: Card transaction history description: Метод получения истории действий с картой x-description-i18n: eng: Card transaction history request method operationId: getCardActionHistory deprecated: true parameters: - $ref: '#/components/parameters/CardId' - $ref: '#/components/parameters/Page' - $ref: '#/components/parameters/Size' responses: '200': description: Метод завершил работу x-description-i18n: eng: The method has completed execution content: application/json: schema: type: object properties: data: type: array items: allOf: - $ref: '#/components/schemas/CardActionDto' meta: allOf: - $ref: '#/components/schemas/Meta' '400': $ref: '#/components/responses/400_invalid_data' '401': $ref: '#/components/responses/401_without_traceId' '500': $ref: '#/components/responses/500_without_traceId' security: - Authorization: [] servers: - url: https://pay-test.raif.ru description: Sandbox - url: https://pay.raif.ru description: Production /api/cards/v1/corporate-cards/cards/{cardId}/requisites: get: tags: - corpcards-operation-api summary: Реквизиты карты x-summary-i18n: eng: Card Requisites description: Получение реквизитов по карте. Инфраструктура клиента должна соответствовать стандартам PCI DSS x-description-i18n: eng: Obtaining card requisites. The client's infrastructure must comply with PCI DSS standards. operationId: getCardRequisites parameters: - $ref: '#/components/parameters/CardId' responses: '200': description: Метод завершил работу x-description-i18n: eng: The method has completed execution content: application/json: schema: allOf: - $ref: '#/components/schemas/RequisitesDto' '400': $ref: '#/components/responses/400_invalid_data' '401': $ref: '#/components/responses/401_without_traceId' '403': $ref: '#/components/responses/403' '500': $ref: '#/components/responses/500_without_traceId' security: - Authorization: [] servers: - url: https://pay-test.raif.ru description: Sandbox - url: https://pay.raif.ru description: Production /api/cards/v1/operations/cards/{cardId}/limit: post: tags: - corpcards-operation-api summary: Установка лимита по карте x-summary-i18n: eng: Card limit setup description: 'На данный момент возможна установка следующих лимитов: * суточный лимит на снятие наличных - "period": "DAILY", "type": "CASH" * месячный лимит на все операции (безналичные оплаты и снятие наличных) - "period": "MONTHLY", "type": "AUTH". Данные лимиты устанавливаются как по отдельности, так и оба единовременно' x-description-i18n: eng: 'Currently, the following limits can be set: * Daily cash withdrawal limit - "period": "DAILY", "type": "CASH" * Monthly limit for all transactions (card payments and cash withdrawals) - "period": "MONTHLY", "type": "AUTH" These limits can be configured either individually or both simultaneously." ' operationId: setCardLimit parameters: - $ref: '#/components/parameters/CardId' requestBody: description: Тело сообщения x-description-i18n: eng: Request body required: true content: application/json: schema: $ref: '#/components/schemas/LimitDto' examples: Daily: $ref: '#/components/examples/CardLimitDaily' Monthly: $ref: '#/components/examples/CardLimitMonthly' responses: '200': description: Метод завершил работу x-description-i18n: eng: The method has completed execution content: application/json: schema: $ref: '#/components/schemas/LimitDto' '400': $ref: '#/components/responses/400_invalid_data' '401': $ref: '#/components/responses/401_without_traceId' '500': $ref: '#/components/responses/500_without_traceId' security: - Authorization: [] servers: - url: https://pay-test.raif.ru description: Sandbox - url: https://pay.raif.ru description: Production /api/cards/v1/operations/cards/{cardId}/status: parameters: - $ref: '#/components/parameters/CardId' post: summary: Блокировка, разблокировка и закрытие карты x-summary-i18n: eng: Blocking, unblocking and closing a card description: Метод по закрытию и блокировке/разблокировке карты x-description-i18n: eng: Method for closing and blocking/unblocking a card operationId: changeCardStatus tags: - corpcards-operation-api requestBody: description: Change card status content: application/json: schema: $ref: '#/components/schemas/CardChangeStatusRequestDto' responses: '200': description: OK '400': $ref: '#/components/responses/400_invalid_data' '401': $ref: '#/components/responses/401_without_traceId' '500': $ref: '#/components/responses/500_without_traceId' security: - Authorization: [] servers: - url: https://pay-test.raif.ru description: Sandbox - url: https://pay.raif.ru description: Production /api/cards/v1/transactions/cards/{cardId}: get: tags: - corpcards-operation-api summary: Список операций по карте x-summary-i18n: eng: Card operation history description: 'Метод получения списка операций по карте (период не обязательный, если его не указывать то: toDate = текущая дата, fromDate = минус 7 дней от текущей даты)' x-description-i18n: eng: 'Method for retrieving card transaction list (period is optional; if not specified: toDate = current date, fromDate = current date minus 7 days)' operationId: getCardOperations parameters: - $ref: '#/components/parameters/CardId' - $ref: '#/components/parameters/ToDate' - $ref: '#/components/parameters/FromDate' responses: '200': description: Метод завершил работу x-description-i18n: eng: The method has completed execution content: application/json: schema: type: array items: $ref: '#/components/schemas/OperationDto' '400': $ref: '#/components/responses/400_invalid_data' '401': $ref: '#/components/responses/401_without_traceId' '500': $ref: '#/components/responses/500_without_traceId' security: - Authorization: [] servers: - url: https://pay-test.raif.ru description: Sandbox - url: https://pay.raif.ru description: Production /api/cards/v2/transactions/cards/{cardId}: get: tags: - corpcards-operation-api summary: Список операций по карте description: Метод получения списка операций по карте operationId: getCardOperationsV2 x-raif-api-service: system parameters: - $ref: '#/components/parameters/CardId' - $ref: '#/components/parameters/ToDate' - $ref: '#/components/parameters/FromDate' - $ref: '#/components/parameters/Limit' - $ref: '#/components/parameters/Offset' - $ref: '#/components/parameters/AmountMin' - $ref: '#/components/parameters/AmountMax' - $ref: '#/components/parameters/Sort' - $ref: '#/components/parameters/SortBy' - $ref: '#/components/parameters/MerchantName' responses: '200': description: Метод завершил работу content: application/json: schema: allOf: - $ref: '#/components/schemas/OperationDtoV2' examples: Операции успешно получены: $ref: '#/components/examples/OperationDtoV2Example' '400': $ref: '#/components/responses/400_invalid_data' '401': $ref: '#/components/responses/401_without_traceId' '500': $ref: '#/components/responses/500_without_traceId' security: - Authorization: [] servers: - url: https://pay-test.raif.ru description: Sandbox - url: https://pay.raif.ru description: Production /api/v1/cards: get: tags: - corpcards-operation-api summary: Получение информации о картах компании x-summary-i18n: eng: Getting information about company cards operationId: getCards parameters: - $ref: '#/components/parameters/CardIdParam' - $ref: '#/components/parameters/FullNameParam' - $ref: '#/components/parameters/Product-2' - $ref: '#/components/parameters/AccountInQuery' - $ref: '#/components/parameters/ExpiryStartDate' - $ref: '#/components/parameters/ExpiryEndDate' - $ref: '#/components/parameters/CardStatuses' - $ref: '#/components/parameters/Limit' - $ref: '#/components/parameters/Offset' - $ref: '#/components/parameters/LimitSelectionType' responses: '200': description: Успешный ответ x-description-i18n: eng: Successful response content: application/json: schema: allOf: - $ref: '#/components/schemas/CardInfoPageableBff' examples: CardInfoPageable: $ref: '#/components/examples/CardInfoExampleBff' CardInfoPageableEmpty: $ref: '#/components/examples/CardInfoPageableEmptyExample' '401': $ref: '#/components/responses/401' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' security: - Authorization: [] servers: - url: https://pay-test.raif.ru description: Sandbox - url: https://pay.raif.ru description: Production /api/v1/cards/{cardId}: get: tags: - corpcards-operation-api summary: Получение информации о карте x-summary-i18n: eng: Getting information about company cards operationId: getSingleCardByCardId parameters: - $ref: '#/components/parameters/CardId' - $ref: '#/components/parameters/LimitSelectionType' responses: '200': description: Успешный ответ x-description-i18n: eng: Successful response content: application/json: schema: allOf: - $ref: '#/components/schemas/CardInfoDtoBff' examples: CardInfo: $ref: '#/components/examples/CardInfoExampleBff' '401': $ref: '#/components/responses/401' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' security: - Authorization: [] servers: - url: https://pay-test.raif.ru description: Sandbox - url: https://pay.raif.ru description: Production components: schemas: Meta: type: object properties: page: allOf: - $ref: '#/components/schemas/Page' size: allOf: - $ref: '#/components/schemas/Size' hasNext: allOf: - $ref: '#/components/schemas/HasNext' count: allOf: - $ref: '#/components/schemas/Count' EmployeeId: type: string description: Табельный номер сотрудника example: 3012345633 MerchantCountry: type: string description: Страна торговой точки. example: RU LimitDto: type: array items: required: - type - period - value type: object properties: type: allOf: - $ref: '#/components/schemas/LimitType' period: allOf: - $ref: '#/components/schemas/Period' value: allOf: - $ref: '#/components/schemas/LimitValue' CardProduct: type: object properties: id: type: string example: '12345' name: type: string example: MIR_CORPORATE value: type: string example: Универсальная imageUrl: type: string example: http://raif.ru/example/{id} required: - id - name - value CardType: type: string description: Тип карты (именная/мгновенная) x-description-i18n: eng: Card type (named/instant) rus: Тип карты (именная/мгновенная) enum: - NAMED - INSTANT example: NAMED IsActivated: type: boolean description: Признак активации карты x-description-i18n: eng: Card activation sign example: true OperationDtoV2: type: object required: - offset - limit - totalCount - data properties: offset: type: integer description: Смещение для пагинации limit: type: integer description: Кол-во возвращаемых элементов example: 25 totalCount: type: integer description: Общее количество доступных операций, без учёта offset и limit example: 3 data: type: array items: type: object required: - id - accountMovementType - extendedNarrative - authorization - status - transaction - card - merchant properties: id: type: string description: Порядковый номер accountMovementType: allOf: - $ref: '#/components/schemas/AccountMovementType' extendedNarrative: type: string description: Описание операции (назначение платежа) authorization: allOf: - $ref: '#/components/schemas/AuthorizationDto' status: allOf: - $ref: '#/components/schemas/StatusDto' transaction: allOf: - $ref: '#/components/schemas/TransactionDto' card: allOf: - $ref: '#/components/schemas/TransactionsCardDto' merchant: allOf: - $ref: '#/components/schemas/MerchantDto' CardActionStatusDto: type: object properties: oldStatus: type: string description: Старое значение статуса x-description-i18n: eng: Old status status: type: string description: Новое значение статуса x-description-i18n: eng: New status reason: allOf: - $ref: '#/components/schemas/Reason' EmbossedName: type: string description: Имя на карте x-description-i18n: eng: Embossed name example: TEST TESTOV MaskedNumber: type: string description: Маскированный номер карты x-description-i18n: eng: Masked card number example: 1***56 Page: type: integer description: Номер страницы x-description-i18n: eng: Page number example: 1 DateTime: type: string description: Дата и время обновления format: date-time example: '2025-08-29T07:29:26.795033' Amount: type: string description: Сумма операции в рублях example: '1000.00' ExpiryDateWithMmYy: type: string description: Срок действия карты x-description-i18n: eng: Card expiry date example: 12/12 Pan: type: string description: Номер карты x-description-i18n: eng: Primary Account Number example: '2200000000000000' Status: type: string enum: - ACTIVE - CLOSED - BLOCKED description: Статус карты x-description-i18n: eng: Card Status example: CLOSED LimitPeriod: type: string description: Период лимита x-description-i18n: eng: Limit period rus: Название лимита enum: - MONTHLY - DAILY - ANNUAL Name: type: string description: Имя x-description-i18n: eng: Name example: Тест OperationStatus: type: string description: Статус операции enum: - HOLD - CANCEL - CAPTURE CardStatusValue: type: object description: Объект, описывающий текущий статус карты и время последнего его обновления required: - value - updatedDate properties: value: allOf: - $ref: '#/components/schemas/Status' updatedDate: allOf: - $ref: '#/components/schemas/UpdatedDateTime' CardInfoPageableBff: type: object properties: data: type: array items: allOf: - $ref: '#/components/schemas/CardInfoDtoBff' offset: type: integer example: 125 limit: type: integer example: 25 count: type: integer example: 200 required: - data - offset - limit - count CardStatus: type: string description: Статус для установки x-description-i18n: eng: Status for installation enum: - CLOSED - BLOCKED - ACTIVE LimitEntityType: type: string description: Тип сущности лимита x-description-i18n: eng: Limit entity type rus: Тип сущности лимита enum: - CARD - ACCOUNT - CLIENT AccountMovementType: type: string enum: - DEBIT - CREDIT CardActivationStatusValue: type: object description: Объект, описывающий текущий статус активации карты и время последнего его обновления required: - value properties: value: allOf: - $ref: '#/components/schemas/ActivationStatus' updatedDate: allOf: - $ref: '#/components/schemas/UpdatedDateTime' Label: type: string description: Расшифровка MCC. example: Различные продовольственные магазины LimitCounterType: type: string description: Тип счётчика лимита x-description-i18n: eng: Limit counter type rus: Тип счётчика лимита enum: - QUANTITY - AMOUNT AccountOwnerResponseDtoV1: type: object properties: account: allOf: - $ref: '#/components/schemas/Account' cnum: allOf: - $ref: '#/components/schemas/Cnum' balance: allOf: - $ref: '#/components/schemas/AvailableBalance' required: - account - cnum MCC: type: string description: Код категории товара или услуги (MCC) example: '1000' Created: type: string description: Дата и время обработки операции. x-description-i18n: eng: Transaction processing date and time example: '2020-01-15T16:01:49.043924+03:00' Phone: type: string description: Номер телефона 3ds x-description-i18n: eng: Phone number 3ds CardActionPhone3dsDto: type: object properties: oldValue: type: string value: type: string holderCnum: type: string required: - oldValue - value - holderCnum AvailableLimit: type: number description: Доступный лимит x-description-i18n: eng: Available limit example: 70.76 CardLimitResponseDto: type: object description: DTO, представляющий лимит по карте x-description-i18n: eng: DTO representing card limit rus: DTO, представляющий лимит по карте properties: name: allOf: - $ref: '#/components/schemas/LimitNameType' period: allOf: - $ref: '#/components/schemas/LimitPeriod' entityType: allOf: - $ref: '#/components/schemas/LimitEntityType' counterType: allOf: - $ref: '#/components/schemas/LimitCounterType' value: type: number format: decimal description: Значение x-description-i18n: eng: Value example: 100000 available: type: - number - 'null' format: decimal description: Остаток по лимиту x-description-i18n: eng: Limit remaining value rus: Остаток по лимиту example: 20000 required: - name - period - entityType - counterType - value Reason: type: string description: Комментарий x-description-i18n: eng: Comment CreatedDate: type: string description: Дата выпуска x-description-i18n: eng: Issue date format: YYYY-MM-DD example: '2020-02-01' LimitValue: type: string description: Значение x-description-i18n: eng: Value example: '100' pattern: '[0-9]+' MerchantCity: type: string description: Город, в котором находится торговая точка example: Gorod Moskva Surname: type: string description: Фамилия x-description-i18n: eng: Surname example: Тестов TransactionsCardDto: type: object description: Данные карты required: - id - maskedNumber properties: id: allOf: - $ref: '#/components/schemas/TransactionsCardDtoId' maskedNumber: allOf: - $ref: '#/components/schemas/TransactionsCardDtoMaskedNumber' Cnum: type: string description: Уникальный банковский идентификатор держателя x-description-i18n: eng: Unique bank identifier of the holder example: CNUM CardChangeStatusRequestDto: type: object required: - cardStatus properties: cardStatus: allOf: - $ref: '#/components/schemas/CardStatus' reason: allOf: - $ref: '#/components/schemas/Reason' PersonDto: type: object description: Информация по держателю карты x-description-i18n: eng: Information about card owner properties: name: allOf: - $ref: '#/components/schemas/Name' surname: allOf: - $ref: '#/components/schemas/Surname' patronymic: allOf: - $ref: '#/components/schemas/Patronymic' cnum: allOf: - $ref: '#/components/schemas/Cnum' Currency: type: string description: Валюта карты example: RUB TransactionsCardDtoId: type: string description: Уникальный банковский идентификатор карты example: '1' OperationDto: type: object properties: id: type: string description: Порядковый номер x-description-i18n: eng: Ordinal number accountMovementType: allOf: - $ref: '#/components/schemas/AccountMovementType' extendedNarrative: type: string description: Общая информация о карте x-description-i18n: eng: Card details authorization: allOf: - $ref: '#/components/schemas/AuthorizationDto' status: allOf: - $ref: '#/components/schemas/StatusDto' transaction: allOf: - $ref: '#/components/schemas/TransactionDto' card: allOf: - $ref: '#/components/schemas/TransactionsCardDto' merchant: allOf: - $ref: '#/components/schemas/MerchantDto' CardLimit: type: array items: required: - type - period - value type: object properties: type: allOf: - $ref: '#/components/schemas/LimitType' period: allOf: - $ref: '#/components/schemas/Period' value: allOf: - $ref: '#/components/schemas/LimitValue' available: allOf: - $ref: '#/components/schemas/AvailableLimit' CardActionType: type: string description: Тип операции x-description-i18n: eng: Operation type enum: - LIMIT - STATUS_CHANGE - PHONE_CHANGE example: STATUS_CHANGE CardStatusState: type: object properties: newValue: type: string currentState: type: string required: - newValue - currentState StatusDto: type: object description: Данные о совершенной операции required: - value - dateTime properties: value: allOf: - $ref: '#/components/schemas/OperationStatus' dateTime: allOf: - $ref: '#/components/schemas/DateTime' captureDateTime: allOf: - $ref: '#/components/schemas/CaptureDateTime' OldValue: type: string description: Старое значение x-description-i18n: eng: Old value example: '100' pattern: '[0-9]+' Product: type: string description: Карточный продукт x-description-i18n: eng: Card product enum: - MIR_CORPORATE - MIR_CORPORATE_VIRTUAL - CASH_IN&OUT ActivationStatus: type: string enum: - ACTIVATED - NOT_ACTIVATED description: Статус активации карты x-description-i18n: eng: Card activation Status example: ACTIVATED IsVirtual: type: boolean description: Признак вирутальной карты example: true CardId: type: string description: Уникальный банковский идентификатор карты x-description-i18n: eng: Unique bank card identifier Type: type: string description: Тип карты x-description-i18n: eng: Card type enum: - DEBIT - CREDIT example: DEBIT AuthorizationDto: type: object description: Данные о предварительной авторизации операции required: - amount - currency properties: amount: allOf: - $ref: '#/components/schemas/Amount' currency: allOf: - $ref: '#/components/schemas/Currency' TransactionDto: type: object description: Данные о финальной транзакции (проведённой сумме) required: - amount - currency properties: amount: allOf: - $ref: '#/components/schemas/Amount' currency: allOf: - $ref: '#/components/schemas/Currency' description: Валюта x-description-i18n: eng: Currency CardActionDto: type: object properties: id: type: string description: Порядковый номер x-description-i18n: eng: Ordinal number cardId: allOf: - $ref: '#/components/schemas/CardId' example: '123' createdDate: allOf: - $ref: '#/components/schemas/Created' type: allOf: - $ref: '#/components/schemas/CardActionType' author: allOf: - $ref: '#/components/schemas/Name' action: allOf: - $ref: '#/components/schemas/CardActionLimitDto' HasNext: type: boolean description: Наличие следующей страницы x-description-i18n: eng: Availability of next page TransactionsCardDtoMaskedNumber: type: string description: 'Маскированный номер карты. Формат: первые 6 и последние 4 цифры, середина скрыта символами "*". ' example: 553496******0091 CardInfoDtoBff: type: object properties: id: type: string example: string maskedNumber: type: string example: 220000******1111 status: allOf: - $ref: '#/components/schemas/CardStatusValue' activationStatus: allOf: - $ref: '#/components/schemas/CardActivationStatusValue' createdDate: type: string format: date-time example: '' mediaType: type: string enum: - VIRTUAL - PLASTIC cardType: allOf: - $ref: '#/components/schemas/CardType' pinSetDate: type: string example: '2025-08-29T07:29:26.795033' format: date-time expiryDate: type: string format: date example: '2030-12-05' accountOwner: allOf: - $ref: '#/components/schemas/AccountOwnerResponseDtoV1' currency: allOf: - $ref: '#/components/schemas/Currency' embossedName: allOf: - $ref: '#/components/schemas/EmbossedName' employeeId: allOf: - $ref: '#/components/schemas/EmployeeId' phone3DS: allOf: - $ref: '#/components/schemas/Phone' type: type: string example: DEBIT product: allOf: - $ref: '#/components/schemas/CardProduct' cardOwner: allOf: - $ref: '#/components/schemas/CardOwner' limits: type: array items: allOf: - $ref: '#/components/schemas/CardLimitResponseDto' limitAdjustedBalance: allOf: - $ref: '#/components/schemas/LimitAdjustedBalance' usageProfileId: type: string description: Идентификатор профиля использования example: profile-001 paymentSystem: allOf: - $ref: '#/components/schemas/PaymentSystem' required: - id - maskedNumber - status - activationStatus - createdDate - mediaType - cardType - expiryDate - accountOwner - currency - embossedName - phone3DS - type - product - cardOwner - paymentSystem CardOwner: type: object properties: firstName: type: string example: Тест lastName: type: string example: Тестов patronymic: type: string example: Тестович cnum: type: string example: CNUM required: - firstName - lastName - cnum LimitNameType: type: string description: Название лимита x-description-i18n: eng: Limit name rus: Название лимита enum: - AUTH_CASH - AUTH_DEBIT - UNKNOWN CardDto: type: object required: - id - maskedNumber - status - createdDate - isActivated - expiryDate - product - account - type - currency - embossedName - person - limits properties: id: allOf: - $ref: '#/components/schemas/CardId' maskedNumber: allOf: - $ref: '#/components/schemas/MaskedNumber' status: allOf: - $ref: '#/components/schemas/Status' cardStatusState: allOf: - $ref: '#/components/schemas/CardStatusState' createdDate: allOf: - $ref: '#/components/schemas/CreatedDate' isActivated: allOf: - $ref: '#/components/schemas/IsActivated' expiryDate: allOf: - $ref: '#/components/schemas/ExpiryDate' product: allOf: - $ref: '#/components/schemas/Product' isVirtual: allOf: - $ref: '#/components/schemas/IsVirtual' account: allOf: - $ref: '#/components/schemas/Account' type: allOf: - $ref: '#/components/schemas/Type' currency: allOf: - $ref: '#/components/schemas/Currency' embossedName: allOf: - $ref: '#/components/schemas/EmbossedName' person: allOf: - $ref: '#/components/schemas/PersonDto' limits: type: array items: $ref: '#/components/schemas/CardLimit' processingType: allOf: [] LimitType: type: string description: Тип лимита (Общерасходный (AUTH) / Снятие наличных (CASH)) x-description-i18n: eng: Limit type (General spending (AUTH) / Cash withdrawal (CASH)) enum: - AUTH - CASH example: CASH RequisitesDto: type: object properties: pan: allOf: - $ref: '#/components/schemas/Pan' expiryDate: allOf: - $ref: '#/components/schemas/ExpiryDateWithMmYy' cvv: allOf: - $ref: '#/components/schemas/CVV' Size: type: integer description: Количество отображаемых элементов x-description-i18n: eng: Count of pageable elements example: 20 CardActionLimitDto: type: object properties: limits: type: array items: type: object properties: type: allOf: - $ref: '#/components/schemas/LimitType' period: allOf: - $ref: '#/components/schemas/Period' oldValue: allOf: - $ref: '#/components/schemas/OldValue' value: allOf: - $ref: '#/components/schemas/LimitValue' status: allOf: - $ref: '#/components/schemas/CardActionStatusDto' phone3ds: allOf: - $ref: '#/components/schemas/CardActionPhone3dsDto' MerchantName: type: string description: Название торговой точки example: YANDEX.TAXI PaymentSystem: type: string description: Тип платежной системы enum: - MIR - VISA - MASTERCARD example: MASTERCARD Patronymic: type: string description: Отчество x-description-i18n: eng: Patronymic example: Тестович MerchantDto: type: object description: Данные торговой точки required: - mcc - label - name - city - country properties: mcc: allOf: - $ref: '#/components/schemas/MCC' label: allOf: - $ref: '#/components/schemas/Label' name: allOf: - $ref: '#/components/schemas/MerchantName' city: allOf: - $ref: '#/components/schemas/MerchantCity' country: allOf: - $ref: '#/components/schemas/MerchantCountry' UpdatedDateTime: type: string description: Дата обновления x-description-i18n: eng: Update date format: date-time example: '2025-08-29T07:29:26.795033' ExpiryDate: type: string description: Срок действия карты x-description-i18n: eng: Card validity period format: YYYY-MM-DD example: '2024-02-01' Account: type: string description: Номер счета x-description-i18n: eng: Account number example: '40702810603000060801' AvailableBalance: type: number description: Доступный баланс x-description-i18n: eng: Available balance example: 70.76 CaptureDateTime: type: string description: Дата и время фиксации транзакции format: date-time example: '2025-08-29T07:29:26.795033' Count: type: integer description: Общее количество элементов x-description-i18n: eng: Total count of elements example: 34 LimitAdjustedBalance: type: number description: Баланс счёта с учётом доступного лимита x-description-i18n: eng: Balance including limit example: 13.37 CVV: type: string description: Код CVV x-description-i18n: eng: CVV code example: '123' Period: type: string description: Периодичность x-description-i18n: eng: Periodicity enum: - MONTHLY - DAILY example: DAILY TransactionsCardDto_2: type: object description: Данные карты, по который была совершена транзакция required: - id - maskedNumber properties: id: allOf: - $ref: '#/components/schemas/TransactionsCardDtoId' maskedNumber: allOf: - $ref: '#/components/schemas/TransactionsCardDtoMaskedNumber' TransactionDto_2: type: object description: Данные о финальной транзакции (проведённой сумме) required: - amount - currency properties: amount: allOf: - $ref: '#/components/schemas/Amount' currency: allOf: - $ref: '#/components/schemas/Currency' description: Валюта parameters: Offset: name: offset in: query example: 60 description: Количество записей для смещения required: false schema: type: integer default: 0 FromDate: name: fromDate in: query example: '2025-11-18' description: 'Начальное время (YYYY-MM-DD). По умолчанию текущая дата - 7 дней ' schema: type: string format: date ExpiryEndDate: in: query name: expiryEndDate description: Конец срока действия карты x-description-i18n: eng: Ending of the card validity period allowEmptyValue: true schema: type: string format: YYYY-MM-DD ToDate: name: toDate in: query description: 'Конечное время (YYYY-MM-DD) По умолчанию текущая дата ' example: '2025-11-25' schema: type: string format: date MerchantName: name: merchantName in: query description: Имя мерчанта schema: type: string AmountMin: name: amountMin in: query description: Сумма минимальная в рублях example: 0 schema: type: integer SortBy: name: sortBy in: query description: Поля для сортировки. Передаётся повторяющимися параметрами query. style: form explode: true schema: type: array items: type: string example: - createTime Status: in: query name: status description: Статусы x-description-i18n: eng: Statuses allowEmptyValue: true schema: type: array items: type: string enum: - ACTIVE - CLOSED - BLOCKED Size: in: query name: size description: Количество отображаемых карт x-description-i18n: eng: Count of pageable cards schema: type: integer format: int32 default: 20 ExpiryStartDate: in: query name: expiryStartDate description: Начало срока действия карты x-description-i18n: eng: Beginning of the card validity period schema: type: string format: YYYY-MM-DD Page: in: query name: page description: Номер страницы x-description-i18n: eng: Page number schema: type: integer format: int32 default: 1 Product-2: name: product in: query example: MIR_CORPORATE description: Название продукта required: false schema: type: array items: type: string CardId: name: cardId in: path required: true description: Уникальный банковский идентификатор карты schema: type: string FullNameParam: name: fullName in: query example: Петров Пётр Петрович description: ФИО держателя карты required: false schema: type: string Sort: name: sort in: query description: 'Направление сортировки для всех полей, указанных в sortBy. По умолчанию DESC. ' example: DESC schema: type: string enum: - DESC - ASC default: DESC Product: in: query name: product description: Карточный продукт x-description-i18n: eng: Card product schema: type: string enum: - MIR_CORPORATE - MIR_CORPORATE_VIRTUAL - CASH_IN&OUT LimitSelectionType: in: query name: limitSelectionType description: Тип выборки x-description-i18n: eng: Limit selection type schema: type: string enum: - WITH_LIMIT, - WITH_BALANCE CardStatuses: name: statuses in: query description: Статус карты x-description-i18n: eng: Card status required: false example: ACTIVE schema: type: array items: type: string enum: - CLOSED - BLOCKED - ACTIVE CardIdParam: name: cardId in: query example: 123456 description: Идентификатор карты в банке required: false schema: type: string Limit: name: limit in: query example: 30 description: Количество записей для запроса required: false schema: type: integer default: 30 AmountMax: name: amountMax in: query description: Сумма максимальная в рублях example: 0 schema: type: integer AccountInQuery: in: query name: account description: Номер счета x-description-i18n: eng: Account number allowEmptyValue: true schema: type: string AuthorizationHeader: name: Authorization in: header description: Токен доступа required: true schema: type: string format: byte example: Bearer QXV0aG9yaXphdGlvbiBIZWFkZXIgRm9yIFRlc3Rpbmc= IdTokenHeader: name: Id-Token in: header description: Идентификационный токен пользователя required: true schema: type: string format: byte example: SUQgVE9LRU4gRk9SIFRFU1RJTkc= examples: OperationDtoV2Example: summary: Страница операций value: data: - id: ZR00000001AAA0A4 accountMovementType: DEBIT extendedNarrative: Cash Advance Fee. CARD **0000 01NOV RUR 100 ATM 00000000 MOSCOW authorization: amount: '1.50' currency: RUB status: value: CAPTURE dateTime: '2025-11-01T12:06:35.525227' captureDateTime: '2025-11-01T10:18:12.085968' transaction: amount: '1.50' currency: RUB card: id: '00000000' maskedNumber: 220030******0111 merchant: mcc: null label: null name: Thresholds commission city: Pilo country: null - id: ZR00000001AAA0A3 accountMovementType: DEBIT extendedNarrative: CARD **0000 01NOV RUR 100 ATM 00000000 MOSCOW authorization: amount: '100.00' currency: RUB status: value: CAPTURE dateTime: '2025-11-01T12:06:35.515954' captureDateTime: '2025-11-03T10:18:12.041783' transaction: amount: '100.00' currency: RUB card: id: '00000000' maskedNumber: 220030******0111 merchant: mcc: '6011' label: Финансовые учреждения – снятие/внесение наличных автоматически name: ATM 00000000 city: MOSCOW country: RUS - id: ZR00000001AAA0A2 accountMovementType: CREDIT extendedNarrative: CARD **0000 01NOV RUR 100 ATM 00000000 MOSCOW authorization: amount: '100.00' currency: RUB status: value: CAPTURE dateTime: '2025-11-01T12:05:11.262242' captureDateTime: '2025-11-01T12:05:11.262242' transaction: amount: '100.00' currency: RUB card: id: '00000000' maskedNumber: 220030******0111 merchant: mcc: '6012' label: Финансовые учреждения – торговля и услуги name: ATM 00000000 city: MOSCOW country: RUS - id: ZR00000001AAA0A1 accountMovementType: DEBIT extendedNarrative: CARD **0000 01NOV RUR 59.99 SHOP 0000 MOSCOW authorization: amount: '59.99' currency: RUB status: value: CAPTURE dateTime: '2025-11-01T12:03:39.88291' captureDateTime: '2025-11-04T06:01:46.93287' transaction: amount: '59.99' currency: RUB card: id: '00000000' maskedNumber: 220030******0111 merchant: mcc: '5411' label: Бакалейные магазины, супермаркеты name: SHOP 0000 city: MOSCOW country: RUS - id: ZR00000001AAA0A0 accountMovementType: CREDIT extendedNarrative: CARD **0000 01NOV RUR 100 ATM 00000000 MOSCOW authorization: amount: '100.00' currency: RUB status: value: CAPTURE dateTime: '2025-11-01T12:01:36.099693' captureDateTime: '2025-11-01T12:01:36.099693' transaction: amount: '100.00' currency: RUB card: id: '00000000' maskedNumber: 220030******0111 merchant: mcc: '6012' label: Финансовые учреждения – торговля и услуги name: ATM 00000000 city: MOSCOW country: RUS offset: 0 limit: 30 totalCount: 5 CardInfoPageableEmptyExample: summary: Список информации о карте value: data: [] limit: 25 offset: 0 count: 0 CardLimitMonthly: value: period: MONTHLY type: AUTH value: '10000' CardNotFoundExample: summary: Карта не найдена value: code: ERROR.CARD_NOT_FOUND message: Карта не найдена CardInfoExampleBff: summary: Список информации о карте value: data: - id: string maskedNumber: 220000******1111 status: value: ACTIVE updatedDate: '2020-02-01T00:00:00' activationStatus: value: ACTIVATED updatedDate: '2020-02-01T00:00:00' createdDate: '2020-02-01T00:00:00' mediaType: VIRTUAL cardType: NAMED pinSetDate: '2025-05-05T23:43:43' expiryDate: '2030-12-31' accountOwner: account: '40702810603000060801' cnum: CNUM123 balance: 500000 currency: RUB usageProfileId: profile-001 embossedName: TEST TESTOV employeeId: EMP123456 phone3DS: '79131442314' type: DEBIT product: id: '123456' name: MIR_CORPORATE value: Универсальная imageUrl: https://example.com/1.png cardOwner: firstName: Тест lastName: Тестов patronymic: Тестович cnum: CNUM123 limits: - name: AUTH_CASH period: DAILY counterType: AMOUNT value: 100000 entityType: CARD available: 50000 limitAdjustedBalance: 500000 paymentSystem: MIR limit: 25 offset: 125 count: 200 CardLimitDaily: value: period: DAILY type: CASH value: '1000' responses: 401_without_traceId: description: Неверный токен аутентификации content: application/json: schema: type: object description: Объект ошибки properties: timestamp: type: string description: Дата и время операции example: '2021-01-01T12:00:27.87+00:20' format: date-time status: type: integer description: HTTP-код example: 401 error: type: string description: Ошибка example: Unauthorized message: type: string description: Описание ошибки example: some exception path: type: string description: URL, по которому была вызвана ошибка. 500_without_traceId: description: Внутренняя ошибка content: application/json: schema: type: object properties: timestamp: type: string description: Дата и время операции example: '2021-01-01T12:00:27.87+00:20' format: date-time status: type: integer description: HTTP-код example: 500 error: type: string description: Ошибка example: Internal Server Error message: type: string description: Описание ошибки example: Internal Server Error path: type: string description: URL, по которому была вызвана ошибка 400_business_exception: description: Бизнес-ошибка x-description-i18n: eng: Business-error content: application/json: schema: type: object properties: code: type: string description: Код ошибки x-description-i18n: eng: Error code example: ERROR.INVALID_DATA message: type: string description: Текст ошибки x-description-i18n: eng: Error text example: Некорректные данные '401': description: Неверный токен аутентификации x-description-i18n: eng: Invalid authentication token content: application/json: schema: type: object properties: code: type: string description: Код ошибки x-description-i18n: eng: Error code example: Unauthorized message: type: string description: Описание ошибки x-description-i18n: eng: Error description example: some exception traceId: type: string description: Trace id запроса x-description-i18n: eng: Trace id request required: - code - message '404': description: Информация не найдена content: application/json: schema: type: object properties: code: type: string description: Код ошибки example: Not Found message: type: string description: Описание ошибки example: Информация не найдена traceId: type: string description: Trace id запроса required: - code - message '403': description: Среда клиента не соответствует стандартам PCI DSS x-description-i18n: eng: The client environment does not comply with PCI DSS standards." content: application/json: schema: type: object description: Объект ошибки x-description-i18n: eng: Error object properties: timestamp: type: string description: Дата и время операции x-description-i18n: eng: Transaction date and time example: '2021-01-01T12:00:27.87+00:20' format: date-time status: type: integer description: HTTP-код x-description-i18n: eng: HTTP-code example: 403 error: type: string description: Ошибка x-description-i18n: eng: Error example: Forbidden message: type: string description: Описание ошибки x-description-i18n: eng: Error description example: some exception path: type: string description: URL, по которому была вызвана ошибка. x-description-i18n: eng: Transaction date and time example: /api/cards/v1/corporate-cards/cards/1/requisites 400_invalid_data: description: Бизнес-ошибка content: application/json: schema: type: object properties: code: type: string description: Код ошибки example: ERROR.INVALID_DATA message: type: string description: Текст ошибки example: Некорректные данные examples: Карта не найдена: $ref: '#/components/examples/CardNotFoundExample' InternalError: description: Внутренняя ошибка Unauthorized: description: Аутентификация не пройдена securitySchemes: Authorization: type: http scheme: bearer bearerFormat: JWT description: Bearer secret key x-internal: false x-refined-from: - raiffeisen-ru-raif-pay-corporate-cards-openapi.json - raiffeisen-ru-corporate-cards-openapi.yml - raiffeisen-ru-raif-pay-corporate-cards-openapi.yml