.. meta::
   :description: Банковский перевод со счётом через API SBC: формирует XML-счёт для банковского перевода клиента и сверяет входящие платежи с данными заказа.

.. _bank_transfer_with_invoice:

Банковский перевод со счётом
##########################


.. role:: ex

.. role:: code

Введение
^^^^^^^^^^^^

| Этот сценарий использования описывает, как Присоединяющаяся сторона может выставлять счета для Swift или аналогичных систем банковских переводов в Платёжном Шлюзе и отображать их плательщикам. Статусы входящих банковских переводов могут обновляться автоматически или вручную.
|
| Значение терминов см. в :ref:`Глоссарии<glossary>`.

Bank Wire Transfer Flow
^^^^^^^^^^^^^^^^^^^^^^^

.. uml::
  :align: center

    skinparam roundcorner 20
    skinparam sequenceArrowThickness 2
    skinparam ParticipantPadding 30
    actor Плательщик as Customer
    participant "Веб-сайт \nПрисоединяющейся Стороны" as Merchant
    participant "Платёжный Шлюз" as g
    autonumber
    Customer -> Merchant: Инициализация
    activate Merchant
    == Запрос на проведение оплаты ==
    Merchant -> g: api/v2/auth-cash
    activate g
    g --> Merchant: orderId
    g --> g: Генерация инвойса
    == Получение обратного вызова \nПрисоединяющейся Стороны ==
    Merchant <- g: Обратный вызов с финальным статусом
    g <-- Merchant: HTTP 200
    deactivate g
    == Запрос статуса ==
    Merchant -> g: api/v2/status
    activate g
    g --> Merchant: Ответ со статусом, order-stage, \nreceipt-id=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
    deactivate g
    == Получение инвойса в форматах \nXML, PDF или обоих сразу ==
    group XML
    g <-- Merchant: view-invoice-xml/ENDPOINTID/receipt-id
    activate g
    g --> Merchant: XML
    deactivate g
    end
    group PDF
    g <-- Merchant: view-invoice/ENDPOINTID/receipt-id
    activate g
    g --> Merchant: PDF
    deactivate g
    end
    Merchant -> Customer: Показ результата
    deactivate Merchant

| (2) Для реализации запроса банковского перевода см. :ref:`/api/v2/auth-cash/</api/v2/auth-cash/>`.
| (5,6) Для реализации запроса статуса заказа см. :ref:`/api/v2/status/</api/v2/status/>`. Статус следует запрашивать несколько раз с интервалом 3–5 секунд, пока в ответе не будет получен окончательный статус. :ex:`receipt-id` будет получен в ответе статуса.
| (7) Для реализации обратного вызова с обработкой окончательного статуса см. :ref:`Присоединяющаяся сторона<merchant_callbacks>`.
| (9) Для реализации запроса view-invoice-xml см. :ref:`/view-invoice-xml/</view-invoice-xml/>`. :ex:`receipt-id` будет использоваться для получения счёта в формате XML.
| (11) Для реализации запроса просмотра счёта см. :ref:`/view-invoice/</view-invoice/>`. :ex:`receipt-id` будет использоваться для получения счёта в формате PDF.

Simple Bank Transfer Flow Statuses
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

.. list-table::
   :widths: 50, 50
   :header-rows: 1
   :class: longtable

   * - Stage название
     - Описание
   * - :code:`AUTH_APPROVED`
     - Счёт был выставлен Плательщику.
   * - :code:`CANCEL_APPROVED`
     - Плательщик не завершил перевод. Этот этап необязателен и может использоваться для лучшего контроля транзакции в бэк-офисе.
   * - :code:`CAPTURE_APPROVED`
     - Funds were transferred to the Присоединяющаяся сторона account (settled).
   * - :code:`VOID_APPROVED`
     - Средства были возвращены Плательщиком (отозваны).
   * - :code:`REVERSAL_APPROVED`
     - Funds were returned to the Payer by Присоединяющаяся сторона.

Extended Bank Transfer Flow Statuses
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

.. list-table::
   :widths: 50, 50
   :header-rows: 1
   :class: longtable

   * - Stage название
     - Описание
   * - :code:`AUTH_STARTING`
     - Транзакция was initiated.
   * - :code:`AUTH_INVOICED`
     - Счёт был выставлен плательщику. Его можно скачать в бэк-офисе, отправить плательщику по электронной почте или запросить через API.
   * - :code:`AUTH_SENT`
     - Плательщик сообщил Присоединяющейся стороне, что счёт оплачен. Этот этап может быть пропущен.
   * - :code:`CANCEL_APPROVED`
     - Плательщик не завершил перевод. Этот этап необязателен и может использоваться для лучшего контроля транзакции в бэк-офисе.
   * - :code:`AUTH_APPROVED`
     - Перевод был получен банком.
   * - :code:`CAPTURE_APPROVED`
     - Funds were transferred to the Присоединяющаяся сторона account (settled).
   * - :code:`VOID_APPROVED`
     - Средства были возвращены Плательщиком (отозваны).
   * - :code:`REVERSAL_APPROVED`
     - Funds were returned to the Payer by Присоединяющаяся сторона.
   * - :code:`CHARGEBACK_APPROVED`
     - Средства были возвращены плательщиком.

.. ifconfig:: "doc.payneteasy.com" in site_link

   ----

   .. admonition:: See also
      :class: related-cross-link

      `Payment infrastructure for banks and PIs → <https://payneteasy.com/branches/banks>`_

.. ifconfig:: "doc.payneteasy.ru" in site_link

   ----

   .. admonition:: См. также
      :class: related-cross-link

      `Решения для банков и финансовых институтов → <https://payneteasy.ru/branches/banks>`_