openapi: 3.2.0
info:
  title: Raiffeisen Ru White Label API
  version: '1.0'
  contact:
    name: Support e-mail
    email: ecom@raiffeisen.ru
    x-team-id: 178
    x-short-team-name: PAPAS
  license:
    name: Proprietary
    url: https://www.raiffeisen.ru/
  x-description-i18n:
    eng: "# Connection to acquiring\nTo connect, fill out an application in [the online bank](https://www.rbo.raiffeisen.ru/sign-form/internet-acquiring) or [the mobile application.](https://rbo.page.link/internet)\n\nFor questions about working with the API, please contact Raiffeisenbank support service:\n- email: ecom@raiffeisen.ru\n\n### Preparatory activities\nTo accept payments:\n* Fill out the [application](https://www.rbo.raiffeisen.ru/sign-form/internet-acquiring) to connect acquiring\n* Choose an integration method and implement it\n* Make test payments\n\n# Operation scheme\n## Payment on the merchant's form\n\n<a href='images/WLEcom_en.svg' target='_blank'><img src='images/WLEcom_en.svg'></a>\n\n## Create payment with subscription\n\n<a href='images/WLEcom-sub-and-payment_en.svg' target='_blank'><img src='images/WLEcom-sub-and-payment_en.svg'></a>\n\n## Bind card\n`IN DEVELOPMENT` <br>\n\n<a href='images/WLEcom-bind-card_en.svg' target='_blank'><img src='images/WLEcom-bind-card_en.svg'></a>\n\n### Payment scenario\n`This workflow requires your company to have PCI DSS certification`<br><br>\nTo make a payment using your own payment form, you must support integration with the [Bank's API](#tag/white-label) methods.\n\n**1. Creating a payment or binding a bank card**\n\nTo make a payment or bind a bank card, you must first create a payment using the [[Create payment]](#operation/post-payments-v1-merchants-publicId-payments) method, specifying the required 'flow' parameter:\n- `flow: CARD` — Card payment\n- `flow: CARD_BINDING` — Card binding\n\nAs a result of executing the method, the payment will be generated in the Bank's system.\nThe method response will return a payment object with the status `NEW`.\n\n- Together with the payment object, additional parameters required for performing an additional [[3DS Method]](#operation/post3DSMethod) step may be returned.\n\n**2. Continuing the payment**\n\nAfter the payment or bind bank card has been created, you must continue processing the payment using the [[Continue payment]](#operation/put-payments-v1-merchants-publicId-payments-id) method.\n- In some cases, the method can complete the payment (transfer it to the final status `SUCCESS`) if the payment passes via 3DS v.2 frictionless flow.\n\n**3. Calling the issuer's ACS for 3DS authentication and OTP code entry by the user**\n\nIf, as a result of executing the [[Continue payment]](#operation/put-payments-v1-merchants-publicId-payments-id) method, the status `3DS_PENDING` is returned,\nthe merchant must redirect the payer to the issuing bank's authorization page, and also send a POST request to the issuer's authentication service.\n\n- The issuing bank's address will be returned in the `acsUrl` parameter\n- The parameters required to send in the request depend on the 3DS version\n\n**3DS v.1**:\n  | Parameter           | Description             |\n  |---------------------|-------------------------|\n  | `MD`                | Information for payment identification. The parameter is returned in the response of the [[Continue payment]](#operation/put-payments-v1-merchants-publicId-payments-id) method. |\n  | `PaReq`             | The parameter required for payer authentication. The parameter is returned in the response of the [[Continue payment]](#operation/put-payments-v1-merchants-publicId-payments-id) method. |\n  | `TermUrl`           | The URL on the merchant's side, to which the ACS will return the response after passing 3DS. The payer will also be redirected to this address after successful OTP code entry.|\n\n**3DS v.2**:\n  | Parameter         | Description             |\n  |-------------------|-------------------------|\n  | `creq`            | Payment session data required for 3DS authentication. The parameter is returned in the response of the [[Continue payment]](#operation/put-payments-v1-merchants-publicId-payments-id) method. |\n\nExample of sending a POST request to the issuer's ACS to continue 3DS v.2:\n```js\n  export function createContinuePayment3ds2Iframe(acsUrl, creq) {\n    const container = document.getElementById('otp-page');\n    const iframe = window.document.createElement('iframe');\n    iframe.id = 'threeDs-2-iframe';\n    iframe.style = 'height: 100%; width: 100%; overflow: hidden; position: absolute; top: 0; left: 0; background: white; z-index: 1000; border: none;';\n    const html = `\n      <body onload=\"document.forms[0].submit()\">\n        <div>\n          <form name=\"form\" action=\"${acsUrl}\" method=\"post\">\n            <input type=\"hidden\" name=\"creq\" value=\"${creq}\">\n          </form>\n        </div>\n      </body>\n    `;\n    container.appendChild(iframe);\n    iframe.contentWindow.document.open();\n    iframe.contentWindow.document.write(html);\n  }\n```\n\nAfter calling the ACS and successful OTP code entry by the user, the merchant's `termUrl` will receive an incoming request from the issuer with the `cres` parameter (in case of 3DS v.2 challenge), or `pares` and `md` in case of 3DS v.1.\n\nExample of obtaining pares via subscription and post-message listening:\n```js\n  window.addEventListener('message', (event) => {\n    try {\n      if (typeof event.data !== 'string') return;\n      const { pares } = JSON.parse(event.data);\n      // Call the required 3DS confirmation method to complete the payment\n    } catch (error) {\n      console.error('Error processing message:', error);\n    }\n  });\n```\n\n**4. 3DS confirmation and payment completion**\n\nTo complete the payment, you must finish processing the payment using the\n[[3DS v.1 Confirmation]](#operation/put-payments-v1-merchants-publicId-payments-id-3ds1-confirm) or\n[[3DS v.2 Confirmation]](#operation/put-api-payments-v1-merchants-publicId-payments-id-3ds2-confirm) methods.\n\nExample of completing the payment via 3DS v.1:\n  ```js\n  window.parent.postMessage(JSON.stringify({\n    pares: paRes\n  }), '*');\n  ```\n\nExample of completing the payment via 3DS v.2:\n  ```js\n  window.parent.postMessage(JSON.stringify({\n    cres: document.getElementById('data').dataset.cres,\n  }), '*');\n  ```\n\n**Payment status model**:\n\n<div style=\"text-align: center;\">\n  <img src=\"images/wl-ecom-payment-status-model.png\" alt=\"Payment status model\">\n</div>\n\n# Integration\nInteraction is carried out via the HTTP protocol using the `POST` `GET` `PUT` `DELETE` methods.\n\nWhen sending requests to open a payment form and create an order with opening a payment form, the API returns a response in the HTML document format, responses to other requests are returned in JSON format.\n\n## Authorization\nTo authorize requests, you need:\n* `publicId` - The identifier that is used to open the payment form and is public.\n* `secretKey` - A secret key that is used for inter-service interaction. It is private, must be stored in a secure place and must not be transferred to third parties.\n\n| Circuit          | URL address             |\n|------------------|-------------------------|\n| Production       |https://pay.raif.ru      |\n| Test             |https://pay-test.raif.ru |\n\nInter-service requests are authorized using the secret key `secretKey`. The authorization parameter is passed in the `Authorization` header, the value of which is formed as `Bearer + secretKey`\n\nYou can view the production `publicId` and generate a `secretKey` in the [Online Bank](https://www.rbo.raiffeisen.ru/acquiring/mcp#/), or [Personal Account](https://pay.raif.ru/account/#/auth).\n\nInstructions for generating `secretKey` can be found in the Help Center:\n* [Generate a secret key in Online Banking](https://help.pay.raif.ru/sbp/rbo/secretkey)\n* [Generate a secret key in your Personal Account](https://help.pay.raif.ru/sbp/lk/secretkey)\n\nTo generate a `secretKey` in the test circuit, you must contact the support service ecom@raiffeisen.ru\n\n# Testing\nFor a full payment testing cycle, you must specify a payment amount greater than 10 rubles.\n\n`Test cards for payment scenarios`\n| Card PAN          | Card validity period| CVV | OTP code| 3DS Scenario       |\n|-------------------|---------------------|-----|---------|--------------------|\n| 2201382000000039  | 12/35               | 880 |         | 3DS2 Frictionless  |\n| 2201382000000021  | 12/35               | 880 |   1234  | 3DS2 Challenge     |\n| 4000001000000018  | 12/35               | 880 |   1234  | 3DS1 Flow          |\n\n## Negative testing\n\nThe amounts listed below can be used to trigger errors for payments or subscription debits.\n\n| Scenario | Amount | Error type |\n|----------|--------|------------|\n|* Card payment <br> * Card subscription debit | 99.51 | Insufficient funds to perform the operation |\n|* Card payment | 99.61 | Authorization amount exceeded the card spending limit |"
  x-logo:
    url: images/raifflogo.png
    backgroundColor: '#FFFFFF'
    altText: Raiff logo
  description: 'Operations tagged white-label across 2 of this provider''s published API definitions: raiffeisen-ru-raif-pay-whitelabel-ecom-openapi.json, raiffeisen-ru-raif-pay-whitelabel-ecom-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://pay-test.raif.ru/api
  description: Sandbox
- url: https://pay.raif.ru/api
  description: Production
tags:
- name: white-label
  x-displayName: Платежная форма клиента
  x-x-displayName-i18n:
    eng: Merchant's payment form
  description: Для работы с карточными платежами с вашей формой, потребуется PCI DSS сертификация вашей организации.
  x-description-i18n:
    eng: 'To work with card payments with your payment form, your organization will need PCI DSS certification.


      PCI DSS is an information security standard adopted in the Visa and MasterCard payment card industry. All companies that accept card payments on their own payment form are required to comply with the standard''s requirements.<br>

      For fiscalization of payments, you can use [Bank fiscalization API](https://pay.raif.ru/api/doc/fiscal.html)

      Before starting work, it is recommended that you familiarize yourself with the payment scenario: [Payment scenario](#section/Shema-raboty/Provedenie-platezha-na-forme-klienta).


      **The API for this scenario may be extensible**.

      '
paths:
  /payments/v1/merchants/{publicId}/payments:
    parameters:
    - $ref: '#/components/parameters/publicId'
    post:
      summary: Создание платежа
      x-summary-i18n:
        eng: Create payment
      operationId: post-payments-v1-merchants-publicId-payments
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Payment'
            examples:
              Привязка карты:
                $ref: '#/components/examples/WL.CREATE_CARD_BINDING_REQUEST'
              Платёж картой:
                $ref: '#/components/examples/WL.CREATE_PAYMENT_REQUEST'
              Платёж картой с оформлением подписки:
                $ref: '#/components/examples/WL.CREATE_CARD_PAYMENT_WITH_SUBSCRIPTION_REQUEST'
              Платёж картой со сплитованием:
                $ref: '#/components/examples/WL.CREATE_CARD_PAYMENT_WITH_SPLITS_REQUEST'
              Платёж картой с подпиской и сплитованием:
                $ref: '#/components/examples/WL.CREATE_CARD_PAYMENT_WITH_SUBSCRIPTION_AND_SPLITS_REQUEST'
              Списание по подписке:
                $ref: '#/components/examples/WL.CREATE_SUBSCRIPTION_PAYMENT_REQUEST'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreatedPayment'
              examples:
                Привязка карты, 3DS v.1 сценарий:
                  $ref: '#/components/examples/WL.CARD_BINDING_RESPONSE_3DS1'
                Привязка карты, 3DS v.2 сценарий:
                  $ref: '#/components/examples/WL.CARD_BINDING_RESPONSE_3DS2'
                Оплата картой, 3DS v.1 сценарий:
                  $ref: '#/components/examples/WL.CREATED_WL_PAYMENT'
                Оплата картой, 3DS v.2 сценарий:
                  $ref: '#/components/examples/WL.REQUIRED_3DS_METHOD'
                Списание по подписке:
                  $ref: '#/components/examples/WL.SUBSCRIPTION_PAYMENT_RESPONSE'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GeneralError'
              examples:
                Ошибка формирования платежа:
                  $ref: '#/components/examples/WL_ERROR_400_ERROR_CREATE_PAYMENT'
                Ошибка валидации:
                  $ref: '#/components/examples/WL_ERROR_400_ERROR_VALID_TO_CREATE_PAYMENT'
        '401':
          description: Unauthorized
          content: {}
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GeneralError'
              examples:
                Доступ запрещен:
                  $ref: '#/components/examples/WL_ERROR_403_FORBIDDEN'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GeneralError'
              examples:
                Внутренняя ошибка сервиса:
                  $ref: '#/components/examples/GENERAL_INTERNAL_ERROR_500'
      description: '`Для мерчантов с наличием сертификата PCI DSS`


        Метод позволяет сформировать платеж в системе Банка, выполнить списание по подписке, привязать карту с автоматическим возвратом фиксированной суммы.


        **Сценарии использования:**

        - `flow: CARD` — Оплата картой

        - `flow: SUBSCRIPTION` — Оплата по подписке

        - `flow: CARD_BINDING` — Привязка карты


        **Примечания:**

        - Если в ответе метода вернулись дополнительные параметры `acsUrl`, `threeDSMethodData`, необходимо выполнить шаг [[Прохождение 3DS Method]](#operation/post3DSMethod).

        - Если дополнительные данные в ответе не вернулись, необходимо продолжать обработку платежа, используя метод [[Продолжение платежа]](#operation/put-payments-v1-merchants-publicId-payments-id).'
      x-description-i18n:
        eng: '`For merchants with PCI DSS certificate` <br> <br>

          This method allows you to generate a payment in the Bank''s system, perform a subscription debit, and bind a card with an automatic refund of a fixed amount.


          **Use cases:**

          - `flow: CARD` — Card payment

          - `flow: SUBSCRIPTION` — Subscription payment

          - `flow: CARD_BINDING` — Bank card binding


          **Card binding:**

          To create a binding, pass `flow: CARD_BINDING`.

          The request does not require `amount`, `order`, `extra`, or `splits`.

          The `id` parameter is optional; if not passed, it will be generated by the bank.


          **Notes:**

          - If the method response returned additional parameters `acsUrl`, `threeDSMethodData`, you must perform the [[Pass 3DS Method]](#operation/post3DSMethod) step.

          - If no additional data is returned in the response, you must continue processing the payment using the [[Continue payment]](#operation/put-payments-v1-merchants-publicId-payments-id) method.

          '
      tags:
      - white-label
      security:
      - secretKey: []
      parameters: []
    servers:
    - url: https://pay-test.raif.ru/api
      description: Sandbox
    - url: https://pay.raif.ru/api
      description: Production
  /3DSMethod:
    post:
      summary: Прохождение 3DS Method
      x-summary-i18n:
        eng: 3DS Method processing
      description: '`Для мерчантов с наличием сертификата PCI DSS`


        Метод используется для выполнения шага 3DS Method в процессе аутентификации.

        Браузер плательщика должен отправить POST-запрос на `acsUrl`, предоставленный системой, с передачей параметра `threeDSMethodData`.


        **Примечания:**

        - Данный запрос выполняется **только из браузера плательщика**.

        - `acsUrl` - Полный адрес, который необходимо вызвать из браузера плательщика. Параметр будет получен в результате выполнения метода [[Создание платежа]](#operation/post-payments-v1-merchants-publicId-payments).

        - `threeDSMethodData` - JSON объект, закодированный в base64, содержащий информацию о транзакции, будет получен в результате выполнения метода [[Создание платежа]](#operation/post-payments-v1-merchants-publicId-payments).

        - После выполнения метода необходимо продолжать обработку платежа, используя метод [[Продолжение платежа]](#operation/put-payments-v1-merchants-publicId-payments-id).'
      x-description-i18n:
        eng: '`For merchants with PCI DSS certificate` <br> <br>

          The method is used to perform the 3DS Method step in the authentication process.

          The payer browser must send a POST request to the `acsUrl` provided by the system, passing the `threeDSMethodData` parameter.


          **Notes:**

          - This request is executed **only from the payer browser**.

          - `acsUrl` - The full address that must be called from the payer browser. The parameter will be obtained as a result of executing the [[Create payment]](#operation/post-payments-v1-merchants-publicId-payments) method.

          - `threeDSMethodData` - A base64 encoded JSON object containing transaction information that will be returned as a result of executing the [[Create Payment]](#operation/post-payments-v1-merchants-publicId-payments) method.

          - After executing the method, you must continue processing the payment using the [[Continue payment]](#operation/put-payments-v1-merchants-publicId-payments-id) method.

          '
      operationId: post3DSMethod
      security: []
      servers:
      - url: https://3ds-ds1.mirconnect.ru/ma
        description: Адрес для вызова вернется в параметре `acsUrl` метода [[Создание платежа]](#operation/post-payments-v1-merchants-publicId-payments).
        x-description-i18n:
          eng: The address to call will be returned in the `acsUrl` parameter of the [[Create payment]](#operation/post-payments-v1-merchants-publicId-payments) method.
      tags:
      - white-label
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                threeDSMethodData:
                  type: string
                  description: JSON, закодированный в base64, содержащий информацию о транзакции
                  x-description-i18n:
                    eng: Base64 encoded JSON containing transaction information
                  example: eyJ0aHJlZURTQ29tcEluZm8iOiAiZXhhbXBsZSJ9
              required:
              - threeDSMethodData
            example:
              threeDSMethodData: eyJ0aHJlZURTQ29tcEluZm8iOiAiZXhhbXBsZSJ9
      responses:
        '200':
          description: OK
        '400':
          description: Bad Request
      x-codeSamples:
      - lang: JavaScript
        source: "function executeThreeDSMethodInIframe(acsUrl, threeDSMethodData) {\n  const iframe = window.document.createElement('iframe');\n  iframe.id = 'call-3ds-method';\n  iframe.style.display = 'none';\n  document.body.appendChild(iframe);\n  const html = `\n    <body onload=\"document.forms[0].submit()\">\n      <div>\n        <form name=\"form\" action=\"${acsUrl}\" method=\"post\">\n          <input type=\"hidden\" name=\"threeDSMethodData\" value=\"${threeDSMethodData}\">\n        </form>\n      </div>\n    </body>\n  `;\n  iframe.contentWindow.document.open();\n  iframe.contentWindow.document.write(html);\n  iframe.contentWindow.document.close();\n}\n"
    servers:
    - url: https://pay-test.raif.ru/api
      description: Sandbox
    - url: https://pay.raif.ru/api
      description: Production
  /payments/v1/merchants/{publicId}/payments/{id}:
    parameters:
    - $ref: '#/components/parameters/publicId'
    - schema:
        type: string
        pattern: ^[A-Za-z0-9-_.]+$
      name: id
      in: path
      required: true
      description: Идентификатор платежа
      x-description-i18n:
        eng: Payment ID
    get:
      summary: Получение информации по платежу
      x-summary-i18n:
        eng: Receiving payment information
      tags:
      - white-label
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaymentInfo'
              examples:
                Оплата картой, 3DS v.1 сценарий:
                  $ref: '#/components/examples/WL.CREATED_WL_PAYMENT'
                Оплата картой, 3DS v.2 сценарий:
                  $ref: '#/components/examples/WL.REQUIRED_3DS_METHOD'
                Необходимо подтверждение 3DS v.1:
                  $ref: '#/components/examples/WL.REQUIRED_CONFIRMATION_3DS1'
                Необходимо подтверждение 3DS v.2:
                  $ref: '#/components/examples/WL.REQUIRED_CONFIRMATION_3DS2'
                Успешная оплата:
                  $ref: '#/components/examples/WL.SUCCESS_PAYMENT'
                Неуспешная оплата:
                  $ref: '#/components/examples/WL.DECLINED_PAYMENT'
        '401':
          description: Unauthorized
          content: {}
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GeneralError'
              examples:
                Доступ запрещен:
                  $ref: '#/components/examples/WL_ERROR_403_FORBIDDEN'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GeneralError'
              examples:
                Платеж не найден:
                  $ref: '#/components/examples/WL_ERROR_404_PAYMENT_NOT_FOUND'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GeneralError'
              examples:
                Внутренняя ошибка сервиса:
                  $ref: '#/components/examples/GENERAL_INTERNAL_ERROR_500'
      operationId: get-payments-v1-merchants-publicId-payments-id
      security:
      - secretKey: []
      description: '`Для мерчантов с наличием сертификата PCI DSS`


        Метод позволяет получить состояние платежа, а также необходимые данные для прохождения 3DS аутентификации на любом этапе оплаты.'
      x-description-i18n:
        eng: '`For merchants with PCI DSS certificate` <br> <br>

          The method allows you to get the payment status, as well as the necessary data for passing 3DS authentication at any stage of payment.

          '
    put:
      summary: Продолжение платежа
      x-summary-i18n:
        eng: Continue payment
      operationId: put-payments-v1-merchants-publicId-payments-id
      responses:
        '200':
          $ref: '#/components/responses/ContinueWLPaymentResponse'
        '401':
          description: Unauthorized
          content: {}
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GeneralError'
              examples:
                Доступ запрещен:
                  value:
                    code: ERROR.FORBIDDEN
                    message: Доступ запрещен
                    traceId: abb066c61a7c8b74af83f245c7706813
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GeneralError'
              examples:
                Платеж не найден:
                  value:
                    code: ERROR.PAYMENT_NOT_FOUND
                    message: Платеж не найден
                    traceId: 3af319058c62903432219dd24ed304d1
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GeneralError'
              examples:
                Внутренняя ошибка сервиса:
                  value:
                    code: ERROR.INTERNAL_ERROR
                    message: Внутренняя ошибка сервиса
                    traceId: abb066c61a7c8b74af83f245c7706813
      description: '`Для мерчантов с наличием сертификата PCI DSS`


        Метод используется для продолжения платежа. Метод также может завершить платеж в случае прохождения платежа по frictionless flow (3DS2).


        **Примечания:**

        - В случае получения статуса `3DS_PENDING` в ответе метода, необходимо отправить POST-запрос и перенаправить плательщика на ACS эмитента, подробнее данный шаг описан в [[Сценарии проведения платежа]](#section/Shema-raboty/Provedenie-platezha-na-forme-klienta).

        - После перенаправления плательщика на ACS эмитента, необходимо завершить платеж, используя методы [[Подтверждение 3DS v.1]](#operation/put-payments-v1-merchants-publicId-payments-id-3ds1-confirm), либо [[Подтверждение 3DS v.2]](#operation/put-api-payments-v1-merchants-publicId-payments-id-3ds2-confirm) с параметрами, полученными от эмитента.'
      x-description-i18n:
        eng: '`For merchants with PCI DSS certificate` <br> <br>

          The method is used to continue the payment. The method can also complete the payment in case of payment through frictionless flow (3DS2).


          **Notes:**

          - If the `3DS_PENDING` status is received in the method response, it is necessary to send a POST request and redirect the payer to the issuer''s ACS. This step is described in more detail in the [[Payment Scenarios]](#section/Shema-raboty/Provedenie-platezha-na-forme-klienta).

          - After the payer is redirected to the issuer''s ACS, it is necessary to complete the payment using the [[3DS v.1 Confirmation]](#operation/put-payments-v1-merchants-publicId-payments-id-3ds1-confirm) or [[3DS v.2 Confirmation]](#operation/put-api-payments-v1-merchants-publicId-payments-id-3ds2-confirm) methods with the parameters received from the issuer.

          '
      security:
      - secretKey: []
      tags:
      - white-label
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                cresNotificationUrl:
                  type: string
                  description: URL-адрес на стороне мерчанта, на который ACS вернет ответ после прохождения 3DS. Также на данный адрес будет перенаправлен плательщик после успешного ввода OTP-кода. **Только для платежей, которые будут обработаны по 3DS v.2**.
                  x-description-i18n:
                    eng: The URL on the merchant side to which ACS will return a response after passing 3DS. The payer will also be redirected to this address after successfully entering the OTP code. **Only for payments that will be processed via 3DS v.2**.
            examples:
              '3DS v.2 ':
                value:
                  cresNotificationUrl: https://myscore.ru/succes-page-example
    servers:
    - url: https://pay-test.raif.ru/api
      description: Sandbox
    - url: https://pay.raif.ru/api
      description: Production
  /payments/v1/merchants/{publicId}/payments/{id}/3ds1-confirm:
    parameters:
    - $ref: '#/components/parameters/publicId'
    - schema:
        type: string
        pattern: ^[A-Za-z0-9-_.]+$
      name: id
      in: path
      required: true
      description: Идентификатор платежа
      x-description-i18n:
        eng: Payment ID
    put:
      summary: Подтверждение 3DS v.1
      x-summary-i18n:
        eng: 3DS v.1 confirmation
      operationId: put-payments-v1-merchants-publicId-payments-id-3ds1-confirm
      responses:
        '200':
          $ref: '#/components/responses/ConfirmWLPaymentResponse'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GeneralError'
              examples:
                Некорректный запрос:
                  value:
                    code: ERROR.BAD_REQUEST
                    message: Тело запроса некорректно
                    traceId: 4e9104961b33e654763b1b7a1da70d43
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GeneralError'
              examples:
                Доступ запрещен:
                  value:
                    code: ERROR.FORBIDDEN
                    message: Доступ запрещен
                    traceId: abb066c61a7c8b74af83f245c7706813
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GeneralError'
              examples:
                Платеж не найден:
                  value:
                    code: ERROR.PAYMENT_NOT_FOUND
                    message: Платеж не найден
                    traceId: 3af319058c62903432219dd24ed304d1
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GeneralError'
              examples:
                Внутренняя ошибка сервиса:
                  value:
                    code: ERROR.INTERNAL_ERROR
                    message: Внутренняя ошибка сервиса
                    traceId: abb066c61a7c8b74af83f245c7706813
      description: '`Для мерчантов с наличием сертификата PCI DSS`


        Метод используется для подтверждения 3DS v.1 и завершения платежа.


        Вызывать метод необходимо при получении статуса `3DS_PENDING` с передачей параметра `pares`, который будет получен от Банка-Эмитента через браузер плательщика.'
      x-description-i18n:
        eng: '`For merchants with PCI DSS certificate` <br> <br>

          The method is used to confirm 3DS v.1 and complete the payment.


          The method must be called upon receiving the `3DS_PENDING` status with the `pares` parameter passed, which will be received from the Issuing Bank via the payer browser.

          '
      tags:
      - white-label
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                pares:
                  type: string
                  description: Зашифрованный ответ от ACS эмитента с результатами 3DS авторизации, необходимыми для завершения платежа. Параметр должен быть получен браузером плательщика и передан в Райффайзенбанк.
                  x-description-i18n:
                    eng: Encrypted response from the issuers ACS with the 3DS authorization results required to complete the payment. The parameter must be received by the payer browser and transmitted to Raiffeisenbank.
                  example: eJzNWVmvo0iy/iutnkdUzW6bketImew2YLMaeGkBxixmM4tZfv3gc6qqq2tq5va9uiMNL0CQGRmRsXwRyd5K2zjmzDga2vhtr8ZdFyTxL9n186/Z9XfmFjLrh
              required:
              - pares
            examples:
              Example 1:
                value:
                  pares: eJzNWVmvo0iy/iutnkdUzW6bketImew2YLMaeGkBxixmM4tZfv3gc6qqq2tq5va9uiMNL0CQGRmRsXwRyd5K2zjmzDga2vhtr8ZdFyTxL9n186/Z9XfmFjLrh
      security:
      - secretKey: []
    servers:
    - url: https://pay-test.raif.ru/api
      description: Sandbox
    - url: https://pay.raif.ru/api
      description: Production
  /payments/v1/merchants/{publicId}/payments/{id}/3ds2-confirm:
    parameters:
    - name: publicId
      in: path
      required: true
      schema:
        type: string
      description: Идентификатор мерчанта в системе Банка
      x-description-i18n:
        eng: Merchant ID in the Bank system
    - schema:
        type: string
        pattern: ^[A-Za-z0-9-_.]+$
      name: id
      in: path
      required: true
      description: Идентификатор платежа
      x-description-i18n:
        eng: Payment ID
    put:
      summary: Подтверждение 3DS v.2
      x-summary-i18n:
        eng: 3DS v.2 confirmation
      operationId: put-api-payments-v1-merchants-publicId-payments-id-3ds2-confirm
      responses:
        '200':
          $ref: '#/components/responses/ConfirmWLPaymentResponse'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GeneralError'
              examples:
                Некорректный запрос:
                  value:
                    code: ERROR.BAD_REQUEST
                    message: Тело запроса некорректно
                    traceId: 4e9104961b33e654763b1b7a1da70d43
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GeneralError'
              examples:
                Доступ запрещен:
                  value:
                    code: ERROR.FORBIDDEN
                    message: Доступ запрещен
                    traceId: abb066c61a7c8b74af83f245c7706813
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GeneralError'
              examples:
                Платеж не найден:
                  value:
                    code: ERROR.PAYMENT_NOT_FOUND
                    message: Платеж не найден
                    traceId: 3af319058c62903432219dd24ed304d1
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GeneralError'
              examples:
                Внутренняя ошибка сервиса:
                  value:
                    code: ERROR.INTERNAL_ERROR
                    message: Внутренняя ошибка сервиса
                    traceId: abb066c61a7c8b74af83f245c7706813
      description: '`Для мерчантов с наличием сертификата PCI DSS`


        Метод используется для подтверждения 3DS v.2 и завершения платежа.


        Вызывать метод необходимо при получении статуса `3DS_PENDING` с передачей параметра `cres`, который будет получен от Банка-Эмитента через браузер плательщика.'
      x-description-i18n:
        eng: '`For merchants with PCI DSS certificate` <br> <br>

          The method is used to confirm 3DS v.2 and complete the payment.


          The method must be called upon receiving the `3DS_PENDING` status with the `cres` parameter passed, which will be received from the Issuing Bank via the payer browser.

          '
      tags:
      - white-label
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                cres:
                  type: string
                  description: Зашифрованный ответ от ACS эмитента с результатами 3DS авторизации, необходимыми для завершения платежа. Параметр должен быть получен браузером плательщика и передан в Райффайзенбанк.
                  x-description-i18n:
                    eng: Encrypted response from the issuers ACS with the 3DS authorization results required to complete the payment. The parameter must be received by the payer browser and transmitted to Raiffeisenbank.
                  example: eJzNWVmvo0iy/iutnkdUzW6bketImew2YLMaeGkBxixmM4tZfv3gc6qqq2tq5va9uiMNL0CQGRmRsXwRyd5K2zjmzDga2vhtr8ZdFyTxL9n186/Z9XfmFjLrh
              required:
              - cres
            examples:
              Example 1:
                value:
                  cres: eJzNWVmvo0iy/iutnkdUzW6bketImew2YLMaeGkBxixmM4tZfv3gc6qqq2tq5va9uiMNL0CQGRmRsXwRyd5K2zjmzDga2vhtr8ZdFyTxL9n186/Z9XfmFjLrh
      security:
      - secretKey: []
    servers:
    - url: https://pay-test.raif.ru/api
      description: Sandbox
    - url: https://pay.raif.ru/api
      description: Production
components:
  schemas:
    ClearingStatus:
      title: ClearingStatus
      type: string
      enum:
      - PENDING
      - COMPLETED
      - FAILED
    PaymentDeclineReason:
      type: string
      description: Код причины отклонения платежа. Описание значений приведено в разделе [Справочник ошибок](#tag/Errors).
      x-description-i18n:
        eng: Payment decline reason code. Values are described in [List of errors](#tag/Errors).
      enum:
      - PAYMENT_DECLINED
      - INSUFFICIENT_FUNDS
      - LIMIT_EXCEEDED
      - PAYER_LIMIT_EXCEEDED
      - CARD_UNAVAILABLE
      - FRAUD_SUSPECTED
      - TIMEOUT
      - INVALID_DATA
      - OPERATION_NOT_SUPPORTED
      - ACCOUNT_NOT_FOUND
      - AUTHENTICATION_FAILED
      - PROCESSING_ERROR
      - USER_CANCELLED
      - SUBSCRIPTION_TERMINATED
    SubscriptionAutoCharge:
      title: SubscriptionAutoCharge
      type: object
      description: Данные автоматического списания по подписке. Объект передается, если по подписке необходимо взимать деньги на регулярной основе.
      x-description-i18n:
        eng: Automatic subscription debit data. This item is passed if the subscription requires recurring payments.
      properties:
        frequency:
          type: string
          description: 'Периодичность списания по подписке<br>

            Если параметр передан, то банк будет автоматически проводить ежемесячное списание средств.'
          x-description-i18n:
            eng: 'Subscription debit frequency<br>

              If this parameter is passed, the bank will automatically debit funds monthly.'
          enum:
          - MONTHLY
        firstChargeDate:
          type: string
          format: date
          description: 'Дата первого списания по подписке<br>

            Списание в указанную дату произойдет автоматически, далее – с заданной периодичностью начиная с этой даты. Переданное значение должно быть не меньше 7 дней от текущей даты. Например, при создании подписки 1 января firstChargeDate может быть 8 января или позже.<br>

            Если параметр не передан, то при `frequency` равен `MONTHLY` первое списание по подписке произойдет через месяц после привязки счета клиентом.'
          x-description-i18n:
            eng: 'Date of first subscription charge<br>

              The debit will be automatically debited on the specified date. Then, it will be debited at the specified frequency starting from that date. The value passed must be at least 7 days old. For example, if you create a subscription on January 1st, firstChargeDate could be January 8th or later.

              If the parameter is not passed, then if `frequency` is equal to `MONTHLY`, the first subscription charge will occur one month after the client links the account.'
        amount:
          type: number
          description: Сумма платежа в рублях. Для копеек доступно два знака после точки.
          x-description-i18n:
            eng: Payment amount in rubles. For kopecks, two decimal places are allowed.
          minimum: 1
      required:
      - frequency
      - amount
    GeneralWLPayment:
      type: object
      x-examples: {}
      properties:
        id:
          type: string
          description: Идентификатор платежа. Если не передан будет сформирован на стороне Банка. Рекомендуем использовать [UUID v4](https://ru.wikipedia.org/wiki/UUID)
          x-description-i18n:
            eng: Payment id
          maxLength: 40
          pattern: ^[A-Za-z0-9-_.]+$
        amount:
          type: number
          description: Сумма платежа в рублях. Для копеек доступно два знака после точки.
          x-description-i18n:
            eng: Payment amount in rubles. For kopecks, two signs after the dot are available.
          exclusiveMinimum: 0
        order:
          type: object
          description: Заказ
          x-description-i18n:
            eng: Order
          properties:
            id:
              type: string
              description: Идентификатор заказа. Если не передан будет сформирован на стороне Банка. Рекомендуем использовать [UUID v4](https://ru.wikipedia.org/wiki/UUID)
              x-description-i18n:
                eng: Order id
              maxLength: 40
              pattern: ^[A-Za-z0-9-_.]+$
            comment:
              $ref: '#/components/schemas/OrderComment'
        extra:
          $ref: '#/components/schemas/Extra'
        status:
          type: object
          description: Статус платежа
          x-description-i18n:
            eng: Payment status
          required:
          - value
          - date
          properties:
            value:
              $ref: '#/components/schemas/WLPaymentStatus'
            date:
              type: string
              description: Дата и время создания платежа
              x-description-i18n:
                eng: Date and time of payment update
              format: date-time
            declineReason:
              $ref: '#/components/schemas/PaymentDeclineReason'
        splits:
          $ref: '#/components/schemas/Split'
      required:
      - id
      - amount
      - status
    CreatedPayment:
      title: CreatedPayment
      properties:
        stage:
          $ref: '#/components/schemas/PaymentStage'
      oneOf:
      - $ref: '#/components/schemas/PostCreatedSubscriptionPayment'
      - $ref: '#/components/schemas/CreatedWLPayment3DS1'
      - $ref: '#/components/schemas/CreatedWLPayment3DS2'
      discriminator:
        propertyName: stage
        mapping:
          CREATED_SUBSCRIPTION_PAYMENT: '#/components/schemas/PostCreatedSubscriptionPayment'
          CREATED_PAYMENT_3DS1: '#/components/schemas/CreatedWLPayment3DS1'
          CREATED_PAYMENT_3DS2: '#/components/schemas/CreatedWLPayment3DS2'
      x-examples:
        Example 1:
          value:
            id: payment-test
            amount: 540
            order:
              id: order-test
              comment: Оплата молока
            extra:
              email: pavel@mail.ru
            flow: SUBSCRIPTION
            status:
              value: SUCCESS
              date: '2025-11-29T19:43:54+03:00'
            stage: CREATED_SUBSCRIPTION_PAYMENT
            paymentDetails: Оплата молока на Фрунзе 1
            subscriptionId: subscription-test
            recurringType: UNSCHEDULED
            parameters:
              paymentMethod: ACQUIRING
              eci: '02'
              rrn: '935014591810'
              authCode: 259AA
    OrderComment:
      title: OrderComment
      type: string
      description: 'Комментарий. Доступен в реестрах и Онлайн-Банке. Не может быть пустым или содержать только пробелы. Может содержать:<br>

        • Символы латиницы (A–Z и a–z) <br>

        • Символы кириллицы (А-Я и а-я) <br>

        • Цифры 0-9 <br>

        • Спецсимволы: пробел и `!`, `"`, `#`, `$`, `%`, `''`, `(`, `)`, `*`, `+`, `,`, `-`, `.`, `/`, `:`, `;`, `=`, `>`, `?`, `@`, `[`, `\`, `]`, `^`, `_`, `{`, `|`, `}`, `~`<br>

        • Спецсимвол `№`'
      x-description-i18n:
        eng: 'Comment. Cannot be empty or contain only spaces. May contain:<br>

          • Latin symbols (A–Z и a–z); <br>

          • Cyrillic symbols (А-Я и а-я); <br>

          • Digits 0-9;<br>

          • Special symbols: spaces and `!`, `"`, `#`, `$`, `%`, `''`, `(`, `)`, `*`, `+`, `,`, `-`, `.`, `/`, `:`, `;`, `=`, `>`, `?`, `@`, `[`, `\`, `]`, `^`, `_`, `{`, `|`, `}`, `~`<br>

          • Special symbol №

          '
      maxLength: 140
      pattern: ^(?=.*\S)[A-Za-zА-Яа-яЁё0-9 !"#$%''()*+,\-./:;=>?@\[\\\]\^_`{\|}~№]+$
      example: Тестовый комментарий
    FinalWLCardPayment:
      title: Успешный / неуспешный платеж
      allOf:
      - $ref: '#/components/schemas/GeneralWLPayment'
      - type: object
        properties:
          stage:
            $ref: '#/components/schemas/PaymentStage'
          flow:
            $ref: '#/components/schemas/PaymentFlow'
          clearing:
            $ref: '#/components/schemas/Clearing'
          parameters:
            type: object
            description: Данные платежа
            x-description-i18n:
              eng: Payment details
            properties:
              rrn:
                type: string
                description: Идентификатор транзакции в системе Банка
                x-description-i18n:
                  eng: Transaction ID in the Bank system
              authCode:
                type: string
                description: Код авторизации, полученный от Банка-эмитента
                x-description-i18n:
                  eng: Authorization code received from the Issuing Bank
              eci:
                type: string
                description: Уровень и тип риска операции в процессе обработки онлайн-платежа
                x-description-i18n:
                  eng: The level and type of risk of the transaction during the online payment processing process
        required:
        - stage
        - flow
    FiscalReceiptBasic:
      title: Receipt
      type: object
      x-description-i18n:
        eng: Receipt data
      description: Данные чека. Объект должен быть передан, если подключена фискализация чеков. При отсутствии объекта receipt чек не будет создан. Если объект receipt был передан, но заполнен некорректно, сервис вернет ошибку.
      properties:
        customer:
          type: object
          description: Данные покупателя
          x-description-i18n:
            eng: Buyer details
          properties:
            email:
              type: string
              description: '`Тег ФФД — 1008` <br>

                E-mail покупателя для отправки чека. Если объект customer не передан, то чек отправляется на электронную почту мерчанта'
              x-description-i18n:
                eng: '`Tag FFD - 1008` <br>

                  Buyer''s email for sending a receipt. If the customer object is not passed, the receipt is sent to the merchant''s email

                  '
              example: customer@test.ru
              maxLength: 64
              format: email
            name:
              type: string
              description: '`Тег ФФД — 1227` <br>

                ФИО покупателя (ФФД 1.05)'
              x-description-i18n:
                eng: '`Tag FFD - 1227` <br>

                  Full name of the buyer (FFD 1.05)

                  '
              example: Иванов Иван Иванович
              maxLength: 256
            inn:
              type: string
              description: '`Тег ФФД — 1228` <br>

                ИНН покупателя. Может содержать только 10 или 12 цифр'
              x-description-i18n:
                eng: '`Tag FFD - 1228` <br>

                  Buyer''s tax identification number of 10 or 12 digits'
              pattern: ^(?:[0-9]{10}|[0-9]{12})$
              example: '7707083893'
            extra:
              type: object
              description: Дополнительная информация о покупателе (ФФД 1.2)<br>Объект свободного наполнения, передается в ОФД без изменений. Если Вам необходимо передать доп. данные покупателя в extra, то сверьтесь с протоколом Вашего ОФД
              x-description-i18n:
                eng: Additional information about the buyer (FFD 1.2)<br>An object of free filling, transferred to the OFD without changes. If you need to transfer additional buyer data to extra, then check with the protocol of your OFD
              additionalProperties:
                type: string
          required:
          - email
        timezone:
          type: string
          description: '`Тег ФФД — 1011` <br/>

            Часовая зона (+02:00, +03:00... +11:00). Только для ФФД 1.2'
          x-description-i18n:
            eng: '`Tag FFD - 1011` <br>

              Time zone (+02:00, +03:00... +11:00). Only for FFD 1.2

              '
        onlinePayment:
          type: boolean
          description: '`Тег ФФД — 1125` <br/>

            Признак расчета в Интернете'
          x-description-i18n:
            eng: '`Tag FFD - 1125` <br>

              Internet settlement flag

              '
        items:
          type: array
          uniqueItems: true
          minItems: 1
          maxItems: 100
          description: Позиции чека
          x-description-i18n:
            eng: Receipt items
          items:
            $ref: '#/components/schemas/receiptItem'
        payments:
          type: array
          uniqueItems: true
          minItems: 1
          description: Данные об оплате<br>Объект заполняется только для чеков с зачетом аванса или частичной предоплаты. Если чек содержит только безналичный вид оплаты (без зачета аванса/частичной предоплаты), то объект payments не заполняется.<br>Если payments не передан, то по умолчанию заполняется безналичным видом оплаты и ее суммой, которая равна сумме чека
          x-description-i18n:
            eng: Payment types info. Object must be passed only for receipts that include prepaid amount (either advance or partial prepayment receipts)<br> If null, then value E_PAYMENT is set by default, with the total receipt amount
          items:
            $ref: '#/components/schemas/payments'
        additionalUserProperty:
          $ref: '#/components/schemas/additionalUserProperty'
      required:
      - items
    CreatedSubscriptionPayment:
      title: CreatedSubscriptionPayment
      allOf:
      - $ref: '#/components/schemas/GeneralPayment'
      - type: object
        properties:
          status:
            type: object
            description: Статус платежа
            x-description-i18n:
              eng: Payment status
            required:
            - value
            - date
            properties:
              value:
                $ref: '#/components/schemas/SubscriptionPaymentStatus'
              date:
                type: string
                description: Дата и время создания платежа
                x-description-i18n:
                  eng: Date and time of payment update
                format: date-time
              declineReason:
                $ref: '#/components/schemas/PaymentDeclineReason'
          stage:
            $ref: '#/components/schemas/PaymentStage'
          flow:
            $ref: '#/components/schemas/PaymentFlow'
          paymentDetails:
            type: string
            description: Назначение платежа. Используется для оплаты по подписке СБП.
            x-description-i18n:
              eng: Payment purpose. Used for payment under the SBP subscription.
            maxLength: 140
          subscriptionId:
            type: string
            description: Идентификатор подписки
            x-description-i18n:
              eng: Subscription ID
            pattern: ^[A-Za-z0-9-_.]+$
          recurringType:
            $ref: '#/components/schemas/SubscriptionRecurringType'
          parameters:
            $ref: '#/components/schemas/SubsriptionPaymentParameters'
          splits:
            $ref: '#/components/schemas/Split'
          clearing:
            $ref: '#/components/schemas/Clearing'
        required:
        - status
        - stage
        - flow
    PaymentInfo:
      title: PaymentInfo
      properties:
        stage:
          $ref: '#/components/schemas/PaymentStage'
      oneOf:
      - $ref: '#/components/schemas/CreatedWLPayment3DS1'
      - $ref: '#/components/schemas/CreatedWLPayment3DS2'
      - $ref: '#/components/schemas/ContinueWLPayment3DS1'
      - $ref: '#/components/schemas/ContinueWLPayment3DS2'
      - $ref: '#/components/schemas/FinalWLCardPayment'
      - $ref: '#/components/schemas/CreatedSubscriptionPayment'
      discriminator:
        propertyName: stage
        mapping:
          CREATED_SUBSCRIPTION_PAYMENT: '#/components/schemas/CreatedSubscriptionPayment'
          CREATED_PAYMENT_3DS1: '#/components/schemas/CreatedWLPayment3DS1'
          CREATED_PAYMENT_3DS2: '#/components/schemas/CreatedWLPayment3DS2'
          CONTINUE_PAYMENT_3DS1: '#/components/schemas/ContinueWLPayment3DS1'
          CONTINUE_PAYMENT_3DS2: '#/components/schemas/ContinueWLPayment3DS2'
          FINAL_CARD_PAYMENT: '#/components/schemas/FinalWLCardPayment'
    ContinueWLPayment:
      title: ContinueWLPayment
      allOf:
      - $ref: '#/components/schemas/GeneralWLPayment'
      - type: object
        properties:
          stage:
            type: string
    Order:
      title: Order
      type: object
      description: Заказ
      x-description-i18n:
        eng: Order
      properties:
        id:
          type: string
          pattern: ^[A-Za-z0-9-_.]+$
          description: Идентификатор заказа. Если не передан будет сформирован на стороне Банка. Рекомендуем использовать [UUID v4](https://ru.wikipedia.org/wiki/UUID)
          x-description-i18n:
            eng: Order ID. If not provided, it will be generated by the Bank. We recommend using [UUID v4](https://ru.wikipedia.org/wiki/UUID)
          maxLength: 40
        comment:
          $ref: '#/components/schemas/OrderComment'
    Extra:
      title: Extra
      type: object
      description: Дополнительные поля в формате key-value. Отображаются в реестрах.
      x-description-i18n:
        eng: Additional fields in key-value format. Displayed in registries
      additionalProperties:
        type: string
    SubsriptionPaymentParameters:
      title: SubsriptionParameters
      properties:
        paymentMethod:
          $ref: '#/components/schemas/SubscriptionPaymentMethod'
      oneOf:
      - $ref: '#/components/schemas/CardPaymentParameters'
      - $ref: '#/components/schemas/SbpPaymentParameters'
      discriminator:
        propertyName: paymentMethod
        mapping:
          ACQUIRING: '#/components/schemas/CardPaymentParameters'
          SBP: '#/components/schemas/SbpPaymentParameters'
    WLPaymentStatus:
      title: WhitelabelPaymentStatus
      type: string
      description: "Статус платежа\n  - `NEW` - Платеж создан успешно, необходимо продолжение платежа\n  - `3DS_PENDING` - Требуется подтверждение аутентификации 3DS\n  - `SUCCESS` - Платеж проведен\n  - `DECLINED` - Платеж отклонен"
      x-description-i18n:
        eng: 'Payment status

          - `NEW` - Payment created successfully, payment continuation required

          - `3DS_PENDING` - 3DS authentication confirmation required

          - `SUCCESS` - Payment completed

          - `DECLINED` - Payment declined

          '
      enum:
      - NEW
      - 3DS_PENDING
      - SUCCESS
      - DECLINED
    PaymentStage:
      title: PaymentStage
      type: string
      enum:
      - CREATED_PAYMENT_3DS1
      - CREATED_PAYMENT_3DS2
      - CONTINUE_PAYMENT_3DS1
      - CONTINUE_PAYMENT_3DS2
      - FINAL_CARD_PAYMENT
      - CREATED_SUBSCRIPTION_PAYMENT
    PaymentFlow:
      title: PaymentFlow
      type: string
      description: 'Сценарий проведения платежа<br>

        * `SUBSCRIPTION` - [Только для сценария оплата по подписке](./ecom.html#tag/subscriptions)<br>

        * `CARD` - [Только для клиентов с PCI DSS](./wl-ecom.html#section/Shema-raboty/Provedenie-platezha-na-forme-klienta)<br>

        * `CARD_BINDING` - [Привязка карты](./wl-ecom.html#section/Shema-raboty/Privyazka-karty)'
      x-description-i18n:
        eng: 'Payment scenario<br>

          * `SUBSCRIPTION` - [Only for the subscription payment scenario](./ecom.html#tag/subscriptions)<br>

          * `CARD` - [Only for clients with PCI DSS](./wl-ecom.html#section/Shema-raboty/Provedenie-platezha-na-forme-klienta)<br>

          * `CARD_BINDING` - [Card binding](./wl-ecom.html#section/Shema-raboty/Privyazka-karty)'
      enum:
      - CARD
      - SUBSCRIPTION
      - CARD_BINDING
    ContinueWLPayment3DS2:
      title: Необходимо подтверждение 3DS v.2
      allOf:
      - $ref: '#/components/schemas/ContinueWLPayment'
      - type: object
        properties:
          flow:
            $ref: '#/components/schemas/PaymentFlow'
          stage:
            $ref: '#/components/schemas/PaymentStage'
          parameters:
            type: object
            description: Данные, необходимые для проведения платежа
            x-description-i18n:
              eng: Data required to make a payment
            properties:
              threeDSVersion:
                $ref: '#/components/schemas/ThreeDSVersion'
              threeDS:
                type: object
                description: Данные для проведения 3DS
                x-description-i18n:
                  eng: Data for conducting 3DS
                properties:
                  acsUrl:
                    type: string
                    description: Адрес Банка-Эмитента для прохождения 3DS аутентификации
                    x-description-i18n:
                      eng: Issuing Bank address for 3DS authentication
                  creq:
                    type: string
                    description: Параметр, необходимый для продолжения платежа по 3DS2
                    x-description-i18n:
                      eng: Parameter required to proceed with 3DS2 payment
                  cresNotificationUrl:
                    type: string
                    description: URL-адрес на стороне мерчанта, на который ACS вернет ответ после прохождения 3DS. Также на данный адрес будет перенаправлен плательщик после успешного ввода OTP-кода.
                    x-description-i18n:
                      eng: The URL on the merchant side to which ACS will return a response after passing 3DS. The payer will also be redirected to this address after successfully entering the OTP code.
        required:
        - flow
        - stage
    CardPayment:
      title: CardPayment
      allOf:
      - $ref: '#/components/schemas/GeneralPayment'
      - type: object
        properties:
          flow:
            $ref: '#/components/schemas/PaymentFlow'
          subscription:
            $ref: '#/components/schemas/Subscription'
          splits:
            $ref: '#/components/schemas/Split'
          parameters:
            type: object
            description: Данные плательщика
            x-description-i18n:
              eng: Payer details
            required:
            - pan
            - month
            - year
            - browserData
            properties:
              cvv:
                type: string
                description: Трехзначный защитный код
                x-description-i18n:
                  eng: Three-digit security code
                example: '880'
              pan:
                type: string
                description: Номер карты
                x-description-i18n:
                  eng: Card number
                example: '4000001000000018'
              month:
                type: integer
                description: Срок действия карты, месяц, MM
                x-description-i18n:
                  eng: Card validity period, month, MM
                example: 1
              year:
                type: integer
                description: Срок действия карты, год, YYYY
                x-description-i18n:
                  eng: Card validity period, year, YYYY
                example: 2030
              cardHolder:
                type: string
                description: Фамилия и имя держателя карты
                x-description-i18n:
                  eng: Cardholder's first and last name
                example: Ivan Ivanov
              browserData:
                type: object
                description: Данные браузера плательщика
                x-description-i18n:
                  eng: Payer browser data
                required:
                - userAgent
                - colorDepth
                - javaEnabled
                - javaScriptEnabled
                - language
                - screenHeight
                - screenWidth
                - timezone
                - ipAddress
                properties:
                  userAgent:
                    type: string
                    description: Содержимое http заголовкa User-Agent
                    x-description-i18n:
                      eng: Content of the HTTP User-Agent header
                  colorDepth:
                    type: string
                    description: Глубина цвета палитры для отображения изображений в битах. Допустимые значения 1-99.
                    x-description-i18n:
                      eng: The color depth of the palette for displaying images in bits. Valid values ​are 1-99.
                    example: '24'
                    maxLength: 2
                    minLength: 1
                    pattern: ^[1-9][0-9]?$
                  javaEnabled:
                    type: boolean
                    description: Параметр указывает, включена ли в браузере плательщика поддержка Java
                    x-description-i18n:
                      eng: The parameter specifies whether Java support is enabled in the payer browser.
                  javaScriptEnabled:
                    type: boolean
                    description: Параметр указывает, включена ли в браузере плательщика поддержка JavaScript
                    x-description-i18n:
                      eng: The parameter specifies whether JavaScript support is enabled in the payer browser.
                  language:
                    type: string
                    description: Язык браузера
                    x-description-i18n:
                      eng: Browser language
                    enum:
                    - ru
                    - en
                    - zh
                    example: ru
                  screenHeight:
                    type: string
                    description: Высота экрана браузера плательщика в пикселях
                    x-description-i18n:
                      eng: Payer browser screen height in pixels
                    example: '1760'
                  screenWidth:
                    type: string
                    description: Ширина экрана браузера плательщика в пикселях
                    x-description-i18n:
                      eng: Payer browser screen width in pixels
                    example: '1800'
                  timezone:
                    type: string
                    description: 'Смещение временной зоны

                      браузера держателя карты по сравнению с

                      зоной UTC в минутах. <br> • Со знаком "плюс", если локальное время отстает от UTC <br> • Со знаком "минус", если локальное время опережает UTC <br> Например 300, если UTC-5'
                    x-description-i18n:
                      eng: 'The offset of the cardholder''s

                        browser time zone from the UTC zone in minutes. <br> • With a plus sign if local time is behind UTC <br> • With a minus sign if local time is ahead of UTC <br> For example 300 if UTC-5

                        '
                    example: '300'
                  ipAddress:
                    type: string
                    description: IP-адрес плательщика
                    x-description-i18n:
                      eng: Payer IP address
                    example: 77.77.77.77
        required:
        - flow
        - parameters
    CardPaymentParameters:
      title: CardPaymentParameters
      type: object
      properties:
        paymentMethod:
          $ref: '#/components/schemas/SubscriptionPaymentMethod'
        eci:
          type: string
          description: Уровень и тип риска операции в процессе обработки онлайн-платежа
          x-description-i18n:
            eng: The level and type of risk of the transaction during the online payment processing process
        rrn:
          type: string
          description: Идентификатор транзакции в системе Банка
          x-description-i18n:
            eng: Transaction ID in the Bank system
        authCode:
          type: string
          description: Код авторизации, полученный от Банка-эмитента
          x-description-i18n:
            eng: Authorization code received from the Issuing Bank
    ThreeDSVersion:
      title: threeDSVersion
      type: string
      enum:
      - V1
      - V2
      description: Версия 3DS
      x-description-i18n:
        eng: 3DS version
    SbpPaymentParameters:
      title: SbpPaymentParameters
      type: object
      properties:
        paymentMethod:
          $ref: '#/components/schemas/SubscriptionPaymentMethod'
        sbpTransactionId:
          type: string
          description: Уникальный идентификатор операции на уровне всей системы СБП
          x-description-i18n:
            eng: Unique transaction ID at the entire SBP system level
    Split:
      title: Split
      type: array
      description: 'Набор параметров для сплитования платежа.<br>

        Сплитование позволяет ТСП передавать параметры распределения суммы платежа или возврата между контрагентами.<br>

        Сумма всех объектов сплита должна быть равна сумме операции.<br>

        При взаиморасчетах суммы платежей, указанные в сплите, увеличивают суммы к перечислению контрагентам, а суммы возвратов — уменьшают их.<br>

        Сплитование доступно только при агрегированной схеме взаиморасчетов. Чтобы настроить агрегированную схему, обратитесь в техническую поддержку банка: ecom@raiffeisen.ru. Подробнее см. в разделе [Схема взаиморасчетов](#tag/SettlementSchemes).'
      x-description-i18n:
        eng: 'Set of parameters for payment splitting.<br>

          Payment splitting allows the merchant to pass parameters for distributing a payment or refund amount among counterparties.<br>

          The total amount of all split objects must be equal to the operation amount.<br>

          In settlements, payment amounts specified in the split increase the amounts to be transferred to counterparties, while refund amounts decrease them.<br>

          Payment splitting is available only with the aggregated settlement scheme. To set up the aggregated scheme, contact bank technical support: ecom@raiffeisen.ru. See [Settlement schemes](#tag/SettlementSchemes).'
      items:
        type: object
        properties:
          accountId:
            type: string
            description: "\t\nstring\nИдентификтор реквизитов, которые были получены от поддержки."
            x-description-i18n:
              eng: ID of the bank account details obtained from support
          amount:
            type: number
            description: Сумма зачисления
            x-description-i18n:
              eng: Crediting amount
            format: float
            exclusiveMinimum: 0
        required:
        - accountId
        - amount
    payments:
      type: object
      title: платежи
      x-title-i18n:
        eng: payments
      required:
      - type
      - amount
      description: Данные об оплате и ее видах
      x-description-i18n:
        eng: Info on payment and its types
      properties:
        type:
          type: string
          description: Вид оплаты. Возможные значения:<br/>• E_PAYMENT – безналичная оплата<br/>• PREPAID – предварительная оплата (зачет аванса и/или предыдущих платежей)
          x-description-i18n:
            eng: Payment type. Valid values:<br/>• E_PAYMENT – electronic payment<br/>• PREPAID – prepaid amount (advance payment and/or previous payments)
          example: PREPAID
          enum:
          - E_PAYMENT
          - PREPAID
        amount:
          type: number
          description: '`Тег ФФД — 1081. Сумма по чеку безналичными` <br/>

            `Тег ФФД — 1251. Сумма по чеку предоплатой (зачетом аванса и(или) предыдущих платежей)` <br/>

            Сумма оплаты<br/>Сумма всех переданных amount должна равняться итоговой сумме чека'
          x-description-i18n:
            eng: '`The tag FDF — 1081. Receipt amount non-cash payment` <br/>

              `The tag FDF — 1251. Receipt amount prepayment (advance payment and(or) previous payment)` <br/>

              Amount paid'
          example: 1200
    receiptItem:
      type: object
      title: ФФД 1.05 | ФФД 1.2
      properties:
        name:
          type: string
          maxLength: 128
          description: '`Тег ФФД — 1030` <br/>

            Наименование товара, работы, услуги, иного предмета расчета'
          x-description-i18n:
            eng: '`The tag FDF — 1030` <br/>

              Name of goods, work, service, other payment objects'
          example: Шоколадный торт
        price:
          type: number
          description: '`Тег ФФД — 1079` <br/>

            Цена за единицу товара, работы, услуги, иного предмета расчета в рублях (8 символов на целую часть, 2 на дробную)'
          x-description-i18n:
            eng: '`The tag FDF — 1079` <br/>

              Price per unit of goods, work, services, other payment objects in rubles (8 characters for a whole part, 2 for a fractional part)'
          example: 1200
        quantity:
          type: number
          description: '`Тег ФФД — 1023` <br/>

            Количество/вес (5 символов на целую часть, 3 на дробную)'
          x-description-i18n:
            eng: '`The tag FDF — 1023` <br/>

              Quantity / weight (5 characters for a whole part, 3 for a fractional part)'
          example: 1
        amount:
          type: number
          description: '`Тег ФФД — 1043` <br/>

            Сумма в рублях. Должна равняться произведению цены на количество (price * quantity). 8 символов на целую часть, 2 на дробную'
          x-description-i18n:
            eng: '`The tag FDF — 1023` <br/>

              Amount in rubles. Must be equal to price * quantity (8 characters for a whole part, 2 for a fractional part)'
          example: 1200
        paymentObject:
          type: string
          description: '`Тег ФФД — 1212` <br/>

            Признак предмета расчёта. Возможные значения:

            <br/>• COMMODITY – товар, который не является подакцизным и не подлежит маркировке (ФФД 1.05 и ФФД 1.2)

            <br/>• EXCISE – подакцизный товар, который не подлежит маркировке (ФФД 1.05 и ФФД 1.2)

            <br/>• JOB – работа (ФФД 1.05 и ФФД 1.2)

            <br/>• SERVICE – услуга (ФФД 1.05 и ФФД 1.2)

            <br/>• PAYMENT – платеж (ФФД 1.05 и ФФД 1.2)

            <br/>• ANOTHER – иной предмет расчета (ФФД 1.05 и ФФД 1.2)<br/>

            <br/>• COMMODITY_MARKING_NO_CODE – товар, который не является подакцизным, подлежит маркировке, но не имеет кода маркировки (ФФД 1.2)

            <br/>• COMMODITY_MARKING_WITH_CODE – товар, который не является подакцизным, подлежит маркировке и имеет код маркировки (ФФД 1.2)

            <br/>• EXCISE_MARKING_NO_CODE – подакцизный товар, который подлежит маркировке, но не имеет кода маркировки (ФФД 1.2)

            <br/>• EXCISE_MARKING_WITH_CODE – подакцизный товар, который подлежит маркировке и имеет код маркировки (ФФД 1.2)<br/>

            <br/>Для авансовых чеков и чеков частичной предоплаты должен заполняться значением PAYMENT. Если параметр не передан, то заполняется значением COMMODITY по умолчанию'
          x-description-i18n:
            eng: '`The tag FDF — 1212` <br/>

              Payment object type. Valid values:

              <br/>• COMMODITY – good (FFD 1.05 and FFD 1.2)

              <br/>• EXCISE – excisable good (FFD 1.05 and FFD 1.2)

              <br/>• JOB – job (FFD 1.05 and FFD 1.2)

              <br/>• SERVICE – service (FFD 1.05 and FFD 1.2)

              <br/>• PAYMENT – payment (FFD 1.05 and FFD 1.2)

              <br/>• ANOTHER – another payment object (FFD 1.05 and FFD 1.2)

              <br/>• COMMODITY_MARKING_NO_CODE – marked good that has no marking code (FFD 1.2)

              <br/>• COMMODITY_MARKING_WITH_CODE – marked good that has a marking code (FFD 1.2)

              <br/>• EXCISE_MARKING_NO_CODE – excisable good that has no marking code (FFD 1.2)

              <br/>• EXCISE_MARKING_WITH_CODE – excisable good that has a marking code (FFD 1.2)<br/>

              <br/>For advance payments and prepayments value PAYMENT must be passed. If null, value COMMODITY will be set by default'
          enum:
          - COMMODITY
          - EXCISE
          - JOB
          - SERVICE
          - PAYMENT
          - ANOTHER
          - COMMODITY_MARKING_NO_CODE
          - COMMODITY_MARKING_WITH_CODE
          - EXCISE_MARKING_NO_CODE
          - EXCISE_MARKING_WITH_CODE
          example: COMMODITY_MARKING_WITH_CODE
        paymentMode:
          type: string
          description: '`Тег ФФД — 1214` <br/>

            Способ расчета. Возможные значения:<br/>

            • FULL_PREPAYMENT – 100% предоплата до момента передачи предмета расчета<br/>

            • FULL_PAYMENT – полная оплата в момент передачи предмета расчета<br/>

            • ADVANCE – аванс<br/>

            • PREPAYMENT – частичная предоплата до момента передачи предмета расчета<br/>

            • CREDIT – Передача в кредит<br/>

            • CREDIT_PAYMENT – Оплата кредита<br/>

            Если параметр не передан, по умолчанию устанавливается значение FULL_PREPAYMENT'
          x-description-i18n:
            eng: '`The tag FDF — 1214` <br/>

              Payment mode. Valid values:<br/>

              • FULL_PREPAYMENT – 100% prepayment<br/>

              • FULL_PAYMENT – full payment<br/>

              • ADVANCE – advance payment<br/>

              • PREPAYMENT – partial prepayment<br/>

              • CREDIT – credit<br/>

              • CREDIT_PAYMENT – credit payment<br/>

              If null, the value FULL_PREPAYMENT is set dy default'
          enum:
          - FULL_PREPAYMENT
          - FULL_PAYMENT
          - ADVANCE
          - PREPAYMENT
          - CREDIT
          - CREDIT_PAYMENT
          example: FULL_PREPAYMENT
        measurementUnit:
          type: string
          description: '`Тег ФФД — 2108` <br/>

            Единица измерения товара, работы, услуги, иного предмета расчета.

            <br/> Для ФФД 1.05 передавать строковое значение до 16 символов включительно.

            <br/> Для ФФД 1.2 передавать значения из списка:

            <br/>• PIECE – штука/единица/дробный товар

            <br/>• GRAM – грамм

            <br/>• KILOGRAM – килограмм

            <br/>• TON – тонна

            <br/>• CENTIMETER – сантиметр

            <br/>• DECIMETER – дециметр

            <br/>• METER – метр

            <br/>• SQUARE_CENTIMETER – кв. сантиметр

            <br/>• SQUARE_DECIMETER – кв. дециметр

            <br/>• SQUARE_METER – кв. метр

            <br/>• MILLILITER – миллилитр

            <br/>• LITER – литр

            <br/>• CUBIC_METER – куб. метр

            <br/>• KILOWATT_HOUR – киловатт-час

            <br/>• GIGACALORIE – гигакалория

            <br/>• DAY – сутки/день

            <br/>• HOUR – час

            <br/>• MINUTE – минута

            <br/>• SECOND – секунда

            <br/>• KILOBYTE – килобайт

            <br/>• MEGABYTE – мегабайт

            <br/>• GIGABYTE – гигабайт

            <br/>• TERABYTE – терабайт

            <br/>• OTHER – иное

            <br/>Если передано значение не из списка выше, то в ОФД автоматически будет передано OTHER

            '
          x-description-i18n:
            eng: '`The tag FDF — 2108` <br/>

              Unit of measurement of goods, work, services, other payment objects

              <br/> If FFD 1.05, string value up to 16 symbols has to be passed.

              <br/> If FFD 1.2, value from the list is accepted:

              <br/>• PIECE – a piece

              <br/>• GRAM – gram

              <br/>• KILOGRAM – kilogram

              <br/>• TON – ton

              <br/>• CENTIMETER – centimeter

              <br/>• DECIMETER – decimeter

              <br/>• METER – meter

              <br/>• SQUARE_CENTIMETER – sq. centimeter

              <br/>• SQUARE_DECIMETER – sq. decimeter

              <br/>• SQUARE_METER – sq. meter

              <br/>• MILLILITER – milliliter

              <br/>• LITER – liter

              <br/>• CUBIC_METER – c. meter

              <br/>• KILOWATT_HOUR – kilowatt-hour

              <br/>• GIGACALORIE – gigacalorie

              <br/>• DAY – day or 24 hours

              <br/>• HOUR – an hour

              <br/>• MINUTE – a minute

              <br/>• SECOND – a second

              <br/>• KILOBYTE – a kilobyte

              <br/>• MEGABYTE – a megabyte

              <br/>• GIGABYTE – a gigabyte

              <br/>• TERABYTE – a terabyte

              <br/>• OTHER – other

              <br/>If passed value in off the list, value OTHER will passed automatically to OFD'''
          example: PIECE
        nomenclatureCode:
          type: string
          description: '`Тег ФФД — 1162` <br/>

            Номенклатурный код товара в 16-ричном представлении с пробелами или в формате GS1 DataMatrix. Только для ФФД 1.05.

            <br/>Примеры: ''''00 00 00 01 00 21 FA 41 00 23 05 41 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 12 00 AB 00'''' или ''''010463003407001221CMK45BrhN0WLf''''

            <br/>Если вы используете БИФИТ или Чек-Онлайн, номенклатурный код должен быть передан строго в 16-ричном представлении с пробелами. Если LIFE PAY или Эвотор – строго в формате GS1 DataMatrix'
          x-description-i18n:
            eng: '`The tag FDF — 1162` <br/>

              Product code in hexadecimal divided by spaces or in GS1 DataMatrix format. For FFD 1.05 only.

              <br/>For example, "00 00 00 01 00 21 FA 41 00 23 05 41 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 12 00 AB 00" or "010463003407001221CMK45BrhN0WLf"

              <br/>If you use BIFIT or Chekonline, the nomenclature code must be passed strictly in hexadecimal (hex) notation with spaces.

              <br/>If you use LIFE PAY or Evotor, the nomenclature code must be passed strictly in GS1 DataMatrix format'
          pattern: ^([a-fA-F0-9]{2}$)|(^([a-fA-F0-9]{2}\s){1,31}[a-fA-F0-9]{2}|01(?<gtin>\d{14})21(?<serial>[a-zA-Z0-9!" % &'()*+\/\-.,:;=<>?_]{13})([a-zA-Z0-9!" % &'()*+\/\- .,:;=<>?_]{1,119})?|(?<gtin1>\d{14})(?<serial1>[a-zA-Z0-9!" %&'()*+\/\-.,:;=<>?_]{11})[a-zA-Z0-9!" %&'()*+\/\-.,:;=<>?_]{4})$
          maxLength: 150
          example: 00 00 00 01 00 21 FA 41 00 23 05 41 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 12 00 AB 00
        vatType:
          type: string
          description: '`Тег ФФД — 1199` <br/>

            Ставка НДС на позицию чека. Возможные значения:<br/>

            • NONE – без НДС<br/>• VAT0 – НДС по ставке 0%<br/>

            • VAT10 – НДС чека по ставке 10%<br/>

            • VAT110 – НДС чека по расчетной ставке 10/110<br/>

            • VAT20 – НДС чека по ставке 20%<br/>

            • VAT120 – НДС чека по расчетной ставке 20/120<br/>

            • VAT5 – НДС чека по ставке 5%<br/>

            • VAT105 – НДС чека по расчетной ставке 5/105<br/>

            • VAT7 – НДС чека по ставке 7%<br/>

            • VAT107 – НДС чека по расчетной ставке 7/107<br/>

            • VAT22 – НДС чека по ставке 22%<br/>

            • VAT122 – НДС чека по расчетной ставке 22/122'
          x-description-i18n:
            eng: '`The tag FDF — 1199` <br/>

              VAT rate on each receipt item. Valid values:<br/>

              • NONE – no VAT<br/>

              • VAT0 – 0% VAT<br/>

              • VAT10 – 10% VAT<br/>

              • VAT110 – 10/110 VAT<br/>

              • VAT20 – 20% VAT<br/>

              • VAT120 – 20/120 VAT<br/>

              • VAT5  – 5% VAT<br/>

              • VAT105 – 5/105 VAT<br/>

              • VAT7 – 7% VAT<br/>

              • VAT107 – 7/107 VAT<br/>

              • VAT22 – 22% VAT<br/>

              • VAT122 – 22/122 VAT'
          enum:
          - NONE
          - VAT0
          - VAT10
          - VAT110
          - VAT20
          - VAT120
          - VAT5
          - VAT105
          - VAT7
          - VAT107
          - VAT22
          - VAT122
          example: VAT20
        agentType:
          type: string
          description: '`Тег ФФД — 1222` <br/>

            Признак агента по предмету расчета. Опциональный параметр, который заполняется только для операций через агента. Возможные значения:<br/>

            • BANK_PAYING_AGENT – банковский платежный агент<br/>

            • BANK_PAYING_SUBAGENT – банковский платежный субагент<br/>

            • PAYING_AGENT – платежный агент<br/>

            • PAYING_SUBAGENT – платежный субагент<br/>

            • ATTORNEY – поверенный<br/>

            • COMMISSION_AGENT – комиссионер<br/>

            • ANOTHER – другой тип агента'
          x-description-i18n:
            eng: '`The tag FDF — 1222` <br/>

              Agent type. Optional parameter which is required for agent operations only.<br/>

              Valid values:<br/>• BANK_PAYING_AGENT – bank paying agent<br/>

              • BANK_PAYING_SUBAGENT – bank paying subagent<br/>

              • PAYING_AGENT – paying agent<br/>

              • PAYING_SUBAGENT – paying subagent<br/>

              • ATTORNEY – attorney<br/>

              • COMMISSION_AGENT – commission agent<br/>

              • «ANOTHER» – another agent type'
          enum:
          - BANK_PAYING_AGENT
          - BANK_PAYING_SUBAGENT
          - PAYING_AGENT
          - PAYING_SUBAGENT
          - ATTORNEY
          - COMMISSION_AGENT
          - ANOTHER
          example: ANOTHER
        supplierInfo:
          type: object
          description: Данные о поставщике. Обязательно к заполнению, если заполнен параметр agentType
          x-description-i18n:
            eng: Supplier information. Required if agentType is filled in
          properties:
            phone:
              type: string
              description: '`Тег ФФД — 1171` <br/>

                Телефон поставщика. Заполняется по формату "+79991234567", после кода +7 должно быть указано 10 цифр'
              x-description-i18n:
                eng: '`The tag FDF — 1171` <br/>

                  Supplier phone number. Filled in with Russian country code in format "+79991234567". The country code +7 must be followed by 10 digits'
              format: +7XXXXXXXXXX
              example: '+79991234567'
            name:
              type: string
              description: '`Тег ФФД — 1225` <br/>

                Наименование поставщика'
              x-description-i18n:
                eng: '`The tag FDF — 1225` <br/>

                  Supplier name'
              example: ООО «Ромашка»
            inn:
              type: string
              description: '`Тег ФФД — 1226` <br/>

                ИНН поставщика. Может содержать только цифры в количестве 10 или 12 символов'
              x-description-i18n:
                eng: '`The tag FDF — 1226` <br/>

                  Supplier tax code of 10 or 12 digits'
              maxLength: 12
              example: '287381373424'
          required:
          - inn
        marking:
          type: object
          description: 'Данные маркировки. Только для ФФД 1.2

            <br/>Обязательно к заполнению, если предметом расчета является маркированный товар, который имеет код маркировки''

            '
          x-description-i18n:
            eng: 'Marking data. Relevant for FFD 1.2 only

              <br/>Must be passed for marked goods that have marking codes

              '
          properties:
            quantity:
              type: object
              description: '`Тег ФФД — 1291` <br/>

                Дробное количество маркированного товара

                <br/>Обязательно к заполнению, если предметом расчета является дробный маркированный товар, который имеет код маркировки.

                В таком случае параметр measurementUnit должен иметь значение PIECE

                '
              x-description-i18n:
                eng: '`The tag FDF — 1291` <br/>

                  Fractional amount of marking goods

                  <br/>Must be passed for marked goods that have marking codes. If so, value PIECE must be passed in measurementUnit

                  '
              properties:
                numerator:
                  type: integer
                  description: '`Тег ФФД — 1293` <br/>

                    Числитель дробной части'
                  x-description-i18n:
                    eng: '`The tag FDF — 1293` <br/>

                      Fraction numerator'
                  example: 1
                denominator:
                  type: integer
                  description: '`Тег ФФД — 1294` <br/>

                    Знаменатель дробной части'
                  x-description-i18n:
                    eng: '`The tag FDF — 1294` <br/>

                      Fraction denominator'
                  example: 3
              required:
              - numerator
              - denominator
            code:
              type: object
              description: Код маркировки
              x-description-i18n:
                eng: Marking code data
              required:
              - format
              - value
              properties:
                format:
                  type: string
                  description: Формат кода маркировки
                  x-description-i18n:
                    eng: Marking code format
                  enum:
                  - UNKNOWN
                  - EAN8
                  - EAN13
                  - ITF14
                  - GS1M
                  - SHORT
                  - FUR
                  - EGAIS20
                  - EGAIS30
                  example: GS1M
                value:
                  type: string
                  description: '`Тег ФФД — 1300. Нераспознанный код товара` <br/>

                    `Тег ФФД — 1301. КТ EAN-8` <br/>

                    `Тег ФФД — 1302. КТ EAN-13` <br/>

                    `Тег ФФД — 1303. КТ ITF-14` <br/>

                    `Тег ФФД — 1305. КТ GS1.М` <br/>

                    `Тег ФФД — 1306. КТ КМК, (SHORT)` <br/>

                    `Тег ФФД — 1307. КТ Меховые изделия, (FUR)` <br/>

                    `Тег ФФД — 1308. КТ ЕГАИС-3.0, (EGAIS20)` <br/>

                    `Тег ФФД — 1309. КТ ЕГАИС-3.0, (EGAIS30)` <br/>

                    Код маркировки. Должен соответствовать формату, переданному в параметре format'
                  x-description-i18n:
                    eng: '`The tag FDF — 1300. Undefined item code` <br/>

                      `The tag FDF — 1301. Item code EAN-8` <br/>

                      `The tag FDF — 1302. Item code EAN-13` <br/>

                      `The tag FDF — 1303. Item code ITF-14` <br/>

                      `The tag FDF — 1305. Item code GS1.М` <br/>

                      `The tag FDF — 1306. Item code SHORT` <br/>

                      `The tag FDF — 1307. Item code FUR` <br/>

                      `The tag FDF — 1308. Item code EGAIS20` <br/>

                      `The tag FDF — 1309. Item code EGAIS30` <br/>

                      Marking code. Value must match the format'
                  example: MDEwNDYwNzQyODY3OTA5MDIxNmVKSWpvV0g1NERkVSA5MWZmZDAgOTJzejZrU1BpckFwZk1CZnR2TGJvRTFkbFdDLzU4aEV4UVVxdjdCQmtabWs0PQ==
                plannedStatus:
                  type: integer
                  minimum: 1
                  maximum: 6
                  description: '`Тег 2003 — планируемый статус маркированного торвара` <br/>

                    Только маркировок вида GS1M и SHORT<br/>

                    1 - Штучный товар, подлежащий обязательной маркировке

                    средством идентификации, реализован<br/>

                    2 - Мерный товар, подлежащий обязательной маркировке

                    средством идентификации, в стадии реализации<br/>

                    3 - Штучный товар, подлежащий обязательной маркировке

                    средством идентификации, возвращен<br/>

                    4 - Часть товара, подлежащего обязательной маркировке

                    средством идентификации, возвращена<br/>

                    5 - Штучный товар, подлежащий обязательной маркировке

                    средством идентификации, в стадии реализации<br/>

                    6 - Мерный товар, подлежащий обязательной маркировке

                    средством идентификации, реализован<br/>'
          required:
          - code
        sectoralProperties:
          type: array
          minItems: 1
          maxItems: 5
          description: '`Тег ФФД — 1260` <br/>

            Отраслевые реквизиты предмета расчета. Только для ФФД 1.2 <br/>

            Большинство ОФД поддерживают обработку только 1 элемента в массиве. Если Вам необходимо передавать более 1 элемента в массиве, то сверьтесь с протоколом Вашего ОФД

            '
          x-description-i18n:
            eng: '`The tag FDF — 1260` <br/>

              Sectoral properties. Relevant for FFD 1.2 only <br/>

              Most OFD support processing of only 1 element in an array. If you need to transfer more than 1 element in an array, then check with the protocol of your OFD

              '
          items:
            type: object
            properties:
              federalId:
                type: string
                description: '`Тег ФФД — 1262` <br/>

                  Идентификатор Федерального органа исполнительной власти. Должно принимать одно из значений справочника в соответствии с [приказом ФНС России](https://www.nalog.gov.ru/rn77/about_fts/docs/10020801/)'
                x-description-i18n:
                  eng: '`The tag FDF — 1262` <br/>

                    Identifier of the Federal Executive Authority. Must take one of the directory values in accordance with [the order of the Federal Tax Service of Russia](https://www.nalog.gov.ru/rn77/about_fts/docs/10020801/)'
                example: '030'
              documentDate:
                type: string
                format: date
                description: '`Тег ФФД — 1263` <br/>

                  Дата нормативного акта федерального органа исполнительной власти, регламентирующего порядок заполнения поля «значение отраслевого реквизита»'
                x-description-i18n:
                  eng: '`The tag FDF — 1263` <br/>

                    Date of the normative act of the federal executive body regulating the procedure for filling in the field "value of the sectoral property"'
                example: '2023-11-21'
              documentNumber:
                type: string
                description: '`Тег ФФД — 1264` <br/>

                  Номер нормативного акта федерального органа исполнительной власти, регламентирующего порядок заполнения поля «значение отраслевого реквизита»'
                x-description-i18n:
                  eng: '`The tag FDF — 1264` <br/>

                    Number of the normative act of the federal executive body, regulating the procedure for filling in the field "value of the sectoral property"'
                example: '1944'
              value:
                type: string
                description: '`Тег ФФД — 1265` <br/>

                  Значение отраслевого реквизита. Заполнение регламентируется нормативным актом федерального органа исполнительной власти'
                x-description-i18n:
                  eng: '`The tag FDF — 1265` <br/>

                    The value of the sectoral property. Filling is regulated by the normative act of the federal executive authority'
                example: UUID=2ce10bdb-6515-4d37-be04-dd475b98c728&Time=1692691702067
            required:
            - federalId
            - documentDate
            - documentNumber
            - value
      required:
      - name
      - price
      - quantity
      - amount
      - vatType
    SubscriptionPaymentMethod:
      description: '- `SBP` - Оплата привязанному счету СБП

        - `ACQUIRING` - Оплата по привязанной карте'
      x-description-i18n:
        eng: '- `SBP` - Payment from a linked SBP account

          - `ACQUIRING` - Payment from a linked card'
      type: string
      enum:
      - ACQUIRING
      - SBP
    SubscriptionRecurringType:
      title: SubscriptionRecurringType
      type: string
      enum:
      - SCHEDULED
      - UNSCHEDULED
      description: "Тип повторяющегося платежа<br>\n * `SCHEDULED` - плата за подписку на услугу / сервис, инициированная ТСП на регулярной основе<br>\n * `UNSCHEDULED` - покупка без графика"
      x-description-i18n:
        eng: 'Recurring payment type<br>

          * `SCHEDULED` - a subscription fee for a service initiated by the merchant on a regular basis<br>

          * `UNSCHEDULED` - a purchase without a schedule, initiated by the payer'
    WlPaymentInfo:
      title: WlPaymentInfo
      properties:
        stage:
          $ref: '#/components/schemas/PaymentStage'
      oneOf:
      - $ref: '#/components/schemas/ContinueWLPayment3DS1'
      - $ref: '#/components/schemas/ContinueWLPayment3DS2'
      - $ref: '#/components/schemas/FinalWLCardPayment'
      discriminator:
        propertyName: stage
        mapping:
          CONTINUE_PAYMENT_3DS1: '#/components/schemas/ContinueWLPayment3DS1'
          CONTINUE_PAYMENT_3DS2: '#/components/schemas/ContinueWLPayment3DS2'
          FINAL_CARD_PAYMENT: '#/components/schemas/FinalWLCardPayment'
      x-examples:
        Необходимо подтверждение 3DS v.1:
          value:
            id: payment-test
            amount: 534.31
            order:
              id: order-test
              comment: Оплата товаров и услуг за заказ №1
            stage: CONTINUE_PAYMENT_3DS1
            extra:
              email: pavel@mail.ru
            flow: CARD
            status:
              value: 3DS_PENDING
              date: '2024-12-31T10:00:00+03:00'
            parameters:
              threeDSVersion: V1
              threeDS:
                acsUrl: https://example.com/acs
                pareq: eNqdmU9P2zAQhu+L7U
                md: M139anFAI94ana93)a3=
        Необходимо подтверждение 3DS v.2:
          value:
            id: payment-test
            amount: 534.31
            order:
              id: order-test
              comment: Оплата товаров и услуг за заказ №1
            stage: CONTINUE_PAYMENT_3DS2
            extra:
              email: pavel@mail.ru
            flow: CARD
            status:
              value: 3DS_PENDING
              date: '2024-12-31T10:00:00+03:00'
            parameters:
              threeDSVersion: V2
              threeDS:
                acsUrl: https://example.com/acs
                creq: eyJ0aHJlZURTU2VydmVyVHJhbnNJRCI6IjZkMjMxM2UyMC0xN2Q0LTQwOGEtYTE2Ni00ZWZjYTNjNTVhODQiLCJhY3NUcmFuc0lEIjoiM2NkMjIzZDYtZTcwYy00czY1LTg0N2ItZGUwZDViZTU0ODBiIiwiY2hhbGxlbmdlV2luZG93U2l6ZSI6IjA1IiwibWVzc2FnZVR5cGUiOiJDUmVxIiwibWVzc2FnZVZlcnNpb24iOiIyLjEuMCJ9
                cresNotificationUrl: https://myscore.ru/succes-page-example
        Успешная оплата:
          value:
            id: payment-test
            amount: 534.31
            order:
              id: order-test
              comment: Оплата товаров и услуг за заказ №1
            stage: FINAL_CARD_PAYMENT
            extra:
              email: pavel@mail.ru
            flow: CARD
            status:
              value: SUCCESS
              date: '2025-12-31T10:00:00+03:00'
            parameters:
              rrn: '935014591810'
              authCode: 259AA
              eci: '02'
    PostCreatedSubscriptionPayment:
      title: PostCreatedSubscriptionPayment
      allOf:
      - $ref: '#/components/schemas/CreatedSubscriptionPayment'
      - type: object
        properties:
          receipt:
            allOf:
            - type: object
              properties:
                receiptNumber:
                  type: string
                  description: Идентификатор чека
                  x-description-i18n:
                    eng: Receipt ID
                  pattern: ^[A-Za-z0-9-_.]+$
            - $ref: '#/components/schemas/FiscalReceiptBasic'
    GeneralPayment:
      title: GeneralPayment
      type: object
      properties:
        id:
          type: string
          description: Идентификатор платежа. Если не передан будет сформирован на стороне Банка. Рекомендуем использовать [UUID v4](https://ru.wikipedia.org/wiki/UUID)
          x-description-i18n:
            eng: Payment identifier. If not transmitted, it will be generated on the Bank side. We recommend using UUID v4.
          maxLength: 40
          pattern: ^[A-Za-z0-9-_.]+$
        amount:
          type: number
          description: 'Сумма платежа в рублях. Для копеек доступно два знака после точки. Для сценария `flow: CARD_BINDING` используется фиксированная сумма, которая автоматически возвращается на карту клиента после успешной оплаты.'
          x-description-i18n:
            eng: 'Payment amount in rubles. For kopecks, two signs after the dot are available. For the `flow: CARD_BINDING` scenario, a fixed amount is used, which is automatically refunded to the customer''s card after a successful payment.'
          example: 540
          exclusiveMinimum: 0
        order:
          $ref: '#/components/schemas/Order'
        extra:
          $ref: '#/components/schemas/Extra'
      required:
      - amount
    CardBinding:
      title: CardBinding
      description: Запрос на привязку банковской карты.
      x-description-i18n:
        eng: 'Card binding request.

          '
      allOf:
      - properties:
          id:
            type: string
            description: 'Идентификатор платежа. Если не передан, будет сформирован на стороне Банка.

              Рекомендуем использовать [UUID v4](https://ru.wikipedia.org/wiki/UUID)'
            x-description-i18n:
              eng: Payment identifier. If not transmitted, it will be generated on the Bank side. We recommend using UUID v4.
            maxLength: 40
            pattern: ^[A-Za-z0-9-_.]+$
            example: payment-binding-123
          flow:
            $ref: '#/components/schemas/PaymentFlow'
          subscription:
            $ref: '#/components/schemas/Subscription'
          parameters:
            type: object
            description: Данные карты плательщика
            x-description-i18n:
              eng: Payer card details
            required:
            - pan
            - month
            - year
            - browserData
            properties:
              cvv:
                type: string
                description: CVV-код карты
                x-description-i18n:
                  eng: Three-digit security code
                example: '880'
              pan:
                type: string
                description: Номер карты
                x-description-i18n:
                  eng: Card number
                example: '4000001000000018'
              month:
                type: integer
                description: Месяц срока действия карты
                x-description-i18n:
                  eng: Card validity period, month, MM
                example: 1
              year:
                type: integer
                description: Год срока действия карты
                x-description-i18n:
                  eng: Card validity period, year, YYYY
                example: 2030
              cardHolder:
                type: string
                description: Фамилия и имя держателя карты
                x-description-i18n:
                  eng: Cardholder's first and last name
                example: Ivan Ivanov
              browserData:
                type: object
                description: Данные браузера плательщика
                x-description-i18n:
                  eng: Payer browser data
                required:
                - userAgent
                - colorDepth
                - javaEnabled
                - javaScriptEnabled
                - language
                - screenHeight
                - screenWidth
                - timezone
                - ipAddress
                properties:
                  userAgent:
                    type: string
                    description: Содержимое http заголовка User-Agent
                    x-description-i18n:
                      eng: Content of the HTTP User-Agent header
                  colorDepth:
                    type: string
                    description: Глубина цвета палитры для отображения изображений в битах. Допустимые значения 1-99.
                    x-description-i18n:
                      eng: The color depth of the palette for displaying images in bits. Valid values are 1-99.
                    example: '24'
                    maxLength: 2
                    minLength: 1
                    pattern: ^[1-9][0-9]?$
                  javaEnabled:
                    type: boolean
                    description: Параметр указывает, включена ли в браузере плательщика поддержка Java
                    x-description-i18n:
                      eng: The parameter specifies whether Java support is enabled in the payer browser.
                  javaScriptEnabled:
                    type: boolean
                    description: Параметр указывает, включена ли в браузере плательщика поддержка JavaScript
                    x-description-i18n:
                      eng: The parameter specifies whether JavaScript support is enabled in the payer browser.
                  language:
                    type: string
                    description: Язык браузера
                    x-description-i18n:
                      eng: Browser language
                    example: ru
                    enum:
                    - ru
                    - en
                    - zh
                  screenHeight:
                    type: string
                    description: Высота экрана браузера плательщика в пикселях
                    x-description-i18n:
                      eng: Payer browser screen height in pixels
                    example: '1760'
                  screenWidth:
                    type: string
                    description: Ширина экрана браузера плательщика в пикселях
                    x-description-i18n:
                      eng: Payer browser screen width in pixels
                    example: '1800'
                  timezone:
                    type: string
                    description: 'Смещение временной зоны браузера держателя карты по сравнению с зоной UTC в минутах.

                      Со знаком "плюс", если локальное время отстает от UTC.

                      Со знаком "минус", если локальное время опережает UTC.

                      Например 300, если UTC-5'
                    x-description-i18n:
                      eng: 'The offset of the cardholder''s browser time zone from the UTC zone in minutes.

                        With a plus sign if local time is behind UTC.

                        With a minus sign if local time is ahead of UTC.

                        For example 300 if UTC-5.

                        '
                    example: '300'
                  ipAddress:
                    type: string
                    description: IP-адрес плательщика
                    x-description-i18n:
                      eng: Payer IP address
                    example: 77.77.77.77
                    format: ipv4
        required:
        - flow
        - subscription
        - parameters
      type: object
    additionalUserProperty:
      type: object
      required:
      - name
      - value
      description: '`Тег ФФД — 1084` <br/>

        Дополнительный реквизит пользователя'
      x-description-i18n:
        eng: '`The tag FDF — 1084` <br/>

          Additional user property'
      properties:
        name:
          type: string
          description: '`Тег ФФД — 1085` <br/>

            Наименование дополнительного реквизита пользователя'
          x-description-i18n:
            eng: '`The tag FDF — 1085` <br/>

              Additional user property name'
          maxLength: 64
        value:
          type: string
          description: '`Тег ФФД — 1086` <br/>

            Значение дополнительного реквизита пользователя'
          x-description-i18n:
            eng: '`The tag FDF — 1086` <br/>

              Additional user property value'
          maxLength: 256
    CreatedWLPayment3DS1:
      title: Платеж создан
      allOf:
      - $ref: '#/components/schemas/GeneralWLPayment'
      - type: object
        properties:
          stage:
            $ref: '#/components/schemas/PaymentStage'
          flow:
            $ref: '#/components/schemas/PaymentFlow'
          subscription:
            $ref: '#/components/schemas/Subscription'
        required:
        - stage
        - flow
    SubscriptionCustomer:
      title: SubscriptionCustomer
      type: object
      description: Данные покупателя по подписке
      x-description-i18n:
        eng: Subscription customer data
      properties:
        email:
          type: string
          description: Email покупателя
          x-description-i18n:
            eng: Customer email
          example: customer@test.ru
          maxLength: 64
          format: email
      required:
      - email
    GeneralError:
      title: General Error
      type: object
      properties:
        code:
          type: string
          description: Код ошибки запроса
          x-description-i18n:
            eng: Request error code
        message:
          type: string
          description: Описание ошибки
          x-description-i18n:
            eng: Error description
        traceId:
          type: string
          description: Идентификатор выполнения запроса при наличии ошибки
          x-description-i18n:
            eng: Request ID if there is an error
    CreatedWLPayment3DS2:
      title: Необходимо прохождение 3DS Method
      allOf:
      - $ref: '#/components/schemas/GeneralWLPayment'
      - type: object
        properties:
          stage:
            $ref: '#/components/schemas/PaymentStage'
          flow:
            $ref: '#/components/schemas/PaymentFlow'
          subscription:
            $ref: '#/components/schemas/Subscription'
          parameters:
            type: object
            description: Данные, необходимые для проведения платежа
            x-description-i18n:
              eng: Data required to make a payment
            properties:
              threeDSVersion:
                $ref: '#/components/schemas/ThreeDSVersion'
              threeDS:
                type: object
                description: Данные для проведения 3DS
                x-description-i18n:
                  eng: Data for conducting 3DS
                properties:
                  acsUrl:
                    type: string
                    description: Адрес Банка-эмитента для сбора данных браузера плательщика. Используется при прохождении 3DS2 аутентификации.
                    x-description-i18n:
                      eng: The address of the Issuing Bank for collecting the payer browser data. Used when passing 3DS2 authentication.
                  threeDSMethodData:
                    type: string
                    description: Данные необходимые для прохождения 3DS2 аутентификации
                    x-description-i18n:
                      eng: Data required to pass 3DS2 authentication
        required:
        - stage
        - flow
      x-examples: {}
    Payment:
      title: Payment
      description: Полиморфный платеж
      x-description-i18n:
        eng: Polymorphic payment
      properties:
        flow:
          $ref: '#/components/schemas/PaymentFlow'
      oneOf:
      - $ref: '#/components/schemas/SubscriptionPayment'
      - $ref: '#/components/schemas/CardPayment'
      - $ref: '#/components/schemas/CardBinding'
      discriminator:
        propertyName: flow
        mapping:
          SUBSCRIPTION: '#/components/schemas/SubscriptionPayment'
          CARD: '#/components/schemas/CardPayment'
          CARD_BINDING: '#/components/schemas/CardBinding'
      type: object
      x-examples: {}
    Clearing:
      title: Clearing
      type: object
      description: Информация о проведении межбанковского клиринга по платежу. Применимо только для платежей по каналу Интернет-Эквайринг.
      properties:
        amount:
          type: number
          description: Сумма клиринга
        status:
          $ref: '#/components/schemas/ClearingStatus'
        clearingDate:
          type: string
          format: date-time
          description: Фактическая дата клиринга
        plannedClearingDate:
          type: string
          format: date-time
          description: Планируемая дата клиринга
    ContinueWLPayment3DS1:
      title: Необходимо подтверждение 3DS v.1
      allOf:
      - $ref: '#/components/schemas/ContinueWLPayment'
      - type: object
        properties:
          flow:
            $ref: '#/components/schemas/PaymentFlow'
          stage:
            $ref: '#/components/schemas/PaymentStage'
          parameters:
            type: object
            description: Данные, необходимые для проведения платежа
            x-description-i18n:
              eng: Data required to make a payment
            properties:
              threeDSVersion:
                $ref: '#/components/schemas/ThreeDSVersion'
              threeDS:
                type: object
                description: Данные для проведения 3DS
                x-description-i18n:
                  eng: Data for conducting 3DS
                properties:
                  acsUrl:
                    type: string
                    description: Адрес Банка-Эмитента для прохождения 3DS аутентификации
                    x-description-i18n:
                      eng: Issuing Bank address for 3DS authentication
                  pareq:
                    type: string
                    description: Параметр необходимый для продолжения платежа по 3DS1
                    x-description-i18n:
                      eng: Parameter required to continue payment via 3DS1
                  md:
                    type: string
                    description: Данные, необходимые для идентификации транзакции
                    x-description-i18n:
                      eng: Data required to identify the transaction
        required:
        - flow
        - stage
    Subscription:
      title: Subscription
      type: object
      description: Данные для оформления подписки и будущих рекурентных платежей. Результат подписки зависит от плательщика. При успешной подписке будет отправлено [[Уведомление о подписке (v2)]](#tag/Callback/operation/subscriptionNotificationV2).
      x-description-i18n:
        eng: Subscription data. Subscription results depend on the payer. If the subscription is successful [[a subscription notification (v2) will be sent to the merchant's address]](#tag/Callback/operation/subscriptionNotificationV2).
      properties:
        id:
          type: string
          description: Идентификатор подписки. Рекомендуем использовать длинный формат без возможности перебора, например, использовать формат [UUIDv4](https://ru.wikipedia.org/wiki/UUID)
          x-description-i18n:
            eng: Subscription ID. We recommend using a long, non-threadable format, such as [UUIDv4](https://ru.wikipedia.org/wiki/UUID)
          maxLength: 40
          example: a7631fbb-f94f-4c17-1e13-0e96a3a77113
          pattern: ^[A-Za-z0-9-_.]+$
        purpose:
          type: string
          description: 'Описание подписки<br>

            Может содержать:<br>

            * Символы латиницы (A-Z и a-z)

            * Символы кириллицы (А-Я и а-я)

            * Цифры 0-9

            * Спецсимволы: `(`, `)`, `!`, `@`, `[`, `]`, `#`, `+`, `=`, `-`, `|`, `.`, `,`'
          x-description-i18n:
            eng: 'Subscription description<br>

              May contain:<br>

              * Latin characters (A-Z и a-z)

              * Cyrillic symbols (А-Я и а-я)

              * Numbers 0-9

              * Special characters: `(`, `)`, `!`, `@`, `[`, `]`, `#`, `+`, `=`, `-`, `|`, `.`, `,`'
          maxLength: 140
          example: Подписка на интернет магазин
          pattern: ^[A-Za-zА-Яа-я0-9 ()!@\[\]#+=_\|.,-]+$
        autoCharge:
          $ref: '#/components/schemas/SubscriptionAutoCharge'
        customer:
          $ref: '#/components/schemas/SubscriptionCustomer'
        autoAcceptance:
          type: boolean
          default: false
          description: 'Флаг для управления привязкой карты. Если флаг установлен в `true`, чекбокс привязки на платежной форме будет установлен по умолчанию на согласие плательщика с привязкой карты.<br>

            Для управления флагом необходима дополнительная настройка со стороны Банка. <br>

            Поле используется только для метода [[Создание заказа с получением платежной ссылки]](#tag/payform/operation/post-payments-v1-merchants-publicId-orders-payment-link2)

            '
          x-description-i18n:
            eng: 'Flag for managing card binding. If the flag is set to `true`, the binding checkbox on the payment form will be checked by default to indicate the payer''s consent to binding the card.<br>

              Additional configuration on the Bank''s side is required to manage this flag. <br>

              The field is only used for the [[Create order with payment link]](#tag/payform/operation/post-payments-v1-merchants-publicId-orders-payment-link2) method

              '
      required:
      - purpose
    SubscriptionPayment:
      title: SubscriptionPayment
      allOf:
      - $ref: '#/components/schemas/GeneralPayment'
      - type: object
        properties:
          flow:
            $ref: '#/components/schemas/PaymentFlow'
          paymentDetails:
            type: string
            description: Назначение платежа. Используется для оплаты по подписке СБП.
            x-description-i18n:
              eng: Payment purpose. Used for payment under the SBP subscription.
            maxLength: 140
          subscriptionId:
            type: string
            description: Идентификатор подписки
            x-description-i18n:
              eng: Subscription ID
            pattern: ^[A-Za-z0-9-_.]+$
            maxLength: 40
          recurringType:
            $ref: '#/components/schemas/SubscriptionRecurringType'
          receipt:
            allOf:
            - type: object
              properties:
                receiptNumber:
                  type: string
                  pattern: ^[A-Za-z0-9-_.]+$
                  description: Идентификатор чека. Если не передан будет соответствовать идентификатору заказа. Рекомендуем использовать [UUID v4](https://ru.wikipedia.org/wiki/UUID)
                  x-description-i18n:
                    eng: Receipt ID. If not passed, it will match the order ID. We recommend using [UUID v4](https://ru.wikipedia.org/wiki/UUID)
            - $ref: '#/components/schemas/FiscalReceiptBasic'
          splits:
            $ref: '#/components/schemas/Split'
        required:
        - flow
        - subscriptionId
        - recurringType
    SubscriptionPaymentStatus:
      title: SubscriptionPaymentStatus
      type: string
      description: "Статус платежа\n  - `SUCCESS` - Платеж проведен\n  - `IN_PROGRESS` - Платеж в обработке\n  - `DECLINED` - Платеж отклонен"
      x-description-i18n:
        eng: 'Payment status

          - `SUCCESS` - Payment completed

          - `IN_PROGRESS` - Payment is being processed

          - `DECLINED` - Payment declined

          '
      enum:
      - SUCCESS
      - DECLINED
      - IN_PROGRESS
  examples:
    WL.DECLINED_PAYMENT:
      value:
        id: payment-test
        amount: 534.31
        order:
          id: order-test
          comment: Оплата товаров и услуг за заказ №1
        stage: FINAL_CARD_PAYMENT
        extra:
          email: pavel@mail.ru
        flow: CARD
        status:
          value: DECLINED
          date: '2025-12-31T10:00:00+03:00'
          declineReason: PAYMENT_DECLINED
        parameters:
          rrn: '935014591810'
          authCode: 259AA
          eci: '07'
    WL.CREATE_CARD_PAYMENT_WITH_SUBSCRIPTION_AND_SPLITS_REQUEST:
      value:
        id: payment-test
        amount: 1000
        order:
          id: order-test
          comment: string
        extra:
          email: pavel@mail.ru
        flow: CARD
        subscription:
          id: subscription-test
          purpose: Подписка на интернет магазин
        splits:
        - accountId: ea6f870f-debd-48cc-a83f-b87e7cee8582
          amount: 600
        - accountId: 226f0738-d5d8-4ee6-afff-71e05836820a
          amount: 400
        parameters:
          cvv: '880'
          pan: '4000001000000018'
          month: 1
          year: 2030
          browserData:
            userAgent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/139.0.0.0 Safari/537.36
            colorDepth: '24'
            javaEnabled: true
            javaScriptEnabled: true
            language: ru
            screenHeight: '1760'
            screenWidth: '1800'
            timezone: '300'
            ipAddress: 77.77.77.77
    WL_ERROR_403_FORBIDDEN:
      value:
        code: ERROR.FORBIDDEN
        message: Доступ запрещен
        traceId: abb066c61a7c8b74af83f245c7706813
    WL.SUBSCRIPTION_PAYMENT_RESPONSE:
      summary: Списание по подписке успешно выполнено
      x-summary-i18n:
        eng: Subscription payment completed successfully
      value:
        id: payment-subscription-test
        amount: 540
        order:
          id: order-test
          comment: Рекуррентный платеж
        extra:
          email: pavel@mail.ru
        flow: SUBSCRIPTION
        status:
          value: SUCCESS
          date: '2026-07-30T12:00:00+03:00'
        stage: CREATED_SUBSCRIPTION_PAYMENT
        paymentDetails: Оплата подписки
        subscriptionId: subscription-test
        recurringType: UNSCHEDULLED
        parameters:
          paymentMethod: ACQUIRING
          eci: '02'
          rrn: '935014591810'
          authCode: 259AA
    WL.CARD_BINDING_RESPONSE_3DS2:
      summary: Привязка карты, 3DS v.2 сценарий
      value:
        id: payment-binding-123
        amount: 11
        flow: CARD_BINDING
        stage: CREATED_PAYMENT_3DS2
        order:
          id: order-test
          comment: Привязка карты
        status:
          value: NEW
          date: '2026-07-30T12:00:00+03:00'
        subscription:
          id: subscription-test
          purpose: Подписка на интернет магазин
        parameters:
          threeDSVersion: V2
          threeDS:
            threeDSMethodData: eyJ0aHJlZURTTWV0aG9kTm90aWZpY2F0aW9uVVJMIjoiaHR0cHM6Ly9wYXktdGVzdC5yYWlmLnJ1LzNkcy9jb25maXJtM2RzTWV0aG9kIiwidGhyZWVEU1NlcnZlclRyYW5zSUQiOiJmYzk3YzRkYi01ZTFlLTRkN2EtODZhMi1kNzYyNzk2YWRlODIifQ
            acsUrl: https://example.com/acs
    WL.SUCCESS_PAYMENT:
      value:
        id: payment-test
        amount: 534.31
        order:
          id: order-test
          comment: Оплата товаров и услуг за заказ №1
        stage: FINAL_CARD_PAYMENT
        extra:
          email: pavel@mail.ru
        flow: CARD
        status:
          value: SUCCESS
          date: '2025-12-31T10:00:00+03:00'
        parameters:
          rrn: '935014591810'
          authCode: 259AA
          eci: '02'
    WL.REQUIRED_CONFIRMATION_3DS1:
      value:
        id: payment-test
        amount: 534.31
        order:
          id: order-test
          comment: Оплата товаров и услуг за заказ №1
        stage: CONTINUE_PAYMENT_3DS1
        extra:
          email: pavel@mail.ru
        flow: CARD
        status:
          value: 3DS_PENDING
          date: '2024-12-31T10:00:00+03:00'
        parameters:
          threeDSVersion: V1
          threeDS:
            acsUrl: https://example.com/acs
            pareq: eNqdmU9P2zAQhu+L7U
            md: M139anFAI94ana93)a3=
    WL.CREATE_CARD_PAYMENT_WITH_SPLITS_REQUEST:
      value:
        id: payment-test
        amount: 1000
        order:
          id: order-test
          comment: string
        extra:
          email: pavel@mail.ru
        flow: CARD
        splits:
        - accountId: ea6f870f-debd-48cc-a83f-b87e7cee8582
          amount: 600
        - accountId: 226f0738-d5d8-4ee6-afff-71e05836820a
          amount: 400
        parameters:
          cvv: '880'
          pan: '4000001000000018'
          month: 1
          year: 2030
          browserData:
            userAgent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/139.0.0.0 Safari/537.36
            colorDepth: '24'
            javaEnabled: true
            javaScriptEnabled: true
            language: ru
            screenHeight: '1760'
            screenWidth: '1800'
            timezone: '300'
            ipAddress: 77.77.77.77
    WL.CREATE_CARD_PAYMENT_WITH_SUBSCRIPTION_REQUEST:
      value:
        id: payment-test
        amount: 540
        order:
          id: order-test
          comment: string
        extra:
          email: pavel@mail.ru
        flow: CARD
        subscription:
          id: subscription-test
          purpose: Подписка на интернет магазин
        parameters:
          cvv: '880'
          pan: '4000001000000018'
          month: 1
          year: 2030
          browserData:
            userAgent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/139.0.0.0 Safari/537.36
            colorDepth: '24'
            javaEnabled: true
            javaScriptEnabled: true
            language: ru
            screenHeight: '1760'
            screenWidth: '1800'
            timezone: '300'
            ipAddress: 77.77.77.77
    WL.REQUIRED_3DS_METHOD:
      value:
        id: payment-test
        amount: 534.31
        order:
          id: order-test
          comment: Оплата товаров и услуг за заказ №1
        stage: CREATED_PAYMENT_3DS2
        extra:
          email: pavel@mail.ru
        flow: CARD
        status:
          value: NEW
          date: '2024-12-31T10:00:00+03:00'
        parameters:
          threeDSVersion: V2
          threeDS:
            threeDSMethodData: eyJ0aHJlZURTTWV0aG9kTm90aWZpY2F0aW9uVVJMIjoiaHR0cHM6Ly9wYXktdGVzdC5yYWlmLnJ1LzNkcy9jb25maXJtM2RzTWV0aG9kIiwidGhyZWVEU1NlcnZlclRyYW5zSUQiOiJmYzk3YzRkYi01ZTFlLTRkN2EtODZhMi1kNzYyNzk2YWRlODIifQ
            acsUrl: https://example.com/acs
    WL.CARD_BINDING_RESPONSE_3DS1:
      summary: Привязка карты, 3DS v.1 сценарий
      x-summary-i18n:
        eng: Linking a card 3DS v.1 scenario
      value:
        id: payment-binding-123
        amount: 11
        flow: CARD_BINDING
        stage: CREATED_PAYMENT_3DS1
        order:
          id: order-test
          comment: Привязка карты
        status:
          value: NEW
          date: '2026-07-30T12:00:00+03:00'
        subscription:
          id: subscription-test
          purpose: Подписка на интернет магазин
    WL.CREATE_SUBSCRIPTION_PAYMENT_REQUEST:
      summary: Списание по подписке
      x-summary-i18n:
        eng: Subscription payment
      value:
        id: payment-subscription-test
        amount: 540
        order:
          id: order-test
          comment: Оплата молока
        extra:
          email: pavel@mail.ru
        flow: SUBSCRIPTION
        recurringType: UNSCHEDULED
        paymentDetails: Оплата молока на Фрунзе 1
        subscriptionId: subscription-test
    GENERAL_INTERNAL_ERROR_500:
      value:
        code: ERROR.INTERNAL_ERROR
        message: Внутренняя ошибка сервиса
        traceId: abb066c61a7c8b74af83f245c7706813
    WL.CREATED_WL_PAYMENT:
      value:
        id: payment-test
        amount: 534.31
        order:
          id: order-test
          comment: Оплата товаров и услуг за заказ №1
        stage: CREATED_PAYMENT_3DS1
        extra:
          email: pavel@mail.ru
        flow: CARD
        status:
          value: NEW
          date: '2024-12-31T10:00:00+03:00'
    WL.REQUIRED_CONFIRMATION_3DS2:
      value:
        id: payment-test
        amount: 534.31
        order:
          id: order-test
          comment: Оплата товаров и услуг за заказ №1
        stage: CONTINUE_PAYMENT_3DS2
        extra:
          email: pavel@mail.ru
        flow: CARD
        status:
          value: 3DS_PENDING
          date: '2024-12-31T10:00:00+03:00'
        parameters:
          threeDSVersion: V2
          threeDS:
            acsUrl: https://example.com/acs
            creq: eyJ0aHJlZURTU2VydmVyVHJhbnNJRCI6IjZkMjMxM2UyMC0xN2Q0LTQwOGEtYTE2Ni00ZWZjYTNjNTVhODQiLCJhY3NUcmFuc0lEIjoiM2NkMjIzZDYtZTcwYy00czY1LTg0N2ItZGUwZDViZTU0ODBiIiwiY2hhbGxlbmdlV2luZG93U2l6ZSI6IjA1IiwibWVzc2FnZVR5cGUiOiJDUmVxIiwibWVzc2FnZVZlcnNpb24iOiIyLjEuMCJ9
            cresNotificationUrl: https://myscore.ru/succes-page-example
    WL.CREATE_PAYMENT_REQUEST:
      value:
        id: payment-test
        amount: 540
        order:
          id: order-test
          comment: string
        extra:
          email: pavel@mail.ru
        flow: CARD
        parameters:
          cvv: '880'
          pan: '4000001000000018'
          month: 1
          year: 2030
          browserData:
            userAgent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/139.0.0.0 Safari/537.36
            colorDepth: '24'
            javaEnabled: true
            javaScriptEnabled: true
            language: ru
            screenHeight: '1760'
            screenWidth: '1800'
            timezone: '300'
            ipAddress: 77.77.77.77
    WL_ERROR_400_ERROR_VALID_TO_CREATE_PAYMENT:
      value:
        code: ERROR.BAD_REQUEST
        message: 'Некорректное значение поля: amount не должно равняться 0'
        traceId: abb066c61a7c8b74af83f245c7706813
    WL_ERROR_404_PAYMENT_NOT_FOUND:
      value:
        code: ERROR.PAYMENT_NOT_FOUND
        message: Платеж не найден
        traceId: 3af319058c62903432219dd24ed304d1
    WL.CREATE_CARD_BINDING_REQUEST:
      summary: Привязка карты
      value:
        id: payment-binding-123
        flow: CARD_BINDING
        subscription:
          id: subscription-test
          purpose: Подписка на интернет магазин
        parameters:
          cvv: '880'
          pan: '4000001000000018'
          month: 1
          year: 2030
          browserData:
            userAgent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/139.0.0.0 Safari/537.36
            colorDepth: '24'
            javaEnabled: true
            javaScriptEnabled: true
            language: ru
            screenHeight: '1760'
            screenWidth: '1800'
            timezone: '300'
            ipAddress: 77.77.77.77
    WL_ERROR_400_ERROR_CREATE_PAYMENT:
      value:
        code: ERROR.BAD_REQUEST
        message: Платёж с данным идентификатором уже существует
        traceId: abb066c61a7c8b74af83f245c7706813
  parameters:
    publicId:
      name: publicId
      in: path
      required: true
      schema:
        type: string
      description: Идентификатор мерчанта в системе Банка
      x-description-i18n:
        eng: Merchant ID in the Bank system
  responses:
    ContinueWLPaymentResponse:
      description: OK
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/WlPaymentInfo'
          examples:
            Необходимо подтверждение 3DS v.1:
              $ref: '#/components/examples/WL.REQUIRED_CONFIRMATION_3DS1'
            Необходимо подтверждение 3DS v.2:
              $ref: '#/components/examples/WL.REQUIRED_CONFIRMATION_3DS2'
            Успешная оплата:
              $ref: '#/components/examples/WL.SUCCESS_PAYMENT'
    ConfirmWLPaymentResponse:
      description: OK
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/FinalWLCardPayment'
          examples:
            Успешная оплата:
              $ref: '#/components/examples/WL.SUCCESS_PAYMENT'
            Неуспешная оплата:
              $ref: '#/components/examples/WL.DECLINED_PAYMENT'
  securitySchemes:
    secretKey:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: 'Указывается в заголовке `Authorization` в формате `Bearer <secretKey>`.


        Подробная информация содержится в разделе [Авторизация](#section/API/Avtorizaciya)'
      x-description-i18n:
        eng: 'Specified in the `Authorization` header in the format `Bearer <secretKey>`.


          Detailed information is contained in the [Authorization] section (#section/API/Authorizaciya)

          '
x-refined-from:
- raiffeisen-ru-raif-pay-whitelabel-ecom-openapi.json
- raiffeisen-ru-raif-pay-whitelabel-ecom-openapi.yml