.. meta::
   :description: Выплата с банковским подтверждением в API Payneteasy: двухэтапный процесс выплаты с вызовами check и pay, позволяющий получить подтверждение до отправки средств.

.. _Payout-with-bank-confirmation:

Выплата с банковским подтверждением
===========================================


.. role:: ex

.. role:: code

Введение
-----------------------------

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

Общий сценарий выплаты
-----------------------------

.. uml::
  :align: center

  participant Получатель as R
  participant "Присоединяющаяся Сторона" as cp
  autonumber
  group Опционально
  R -> cp : Инициализация
  activate cp
  end
  == Запрос на выплату ==
  cp -> "Payneteasy": /api/v4/payout-check/
  activate "Payneteasy"
  "Payneteasy" --> cp: ИД транзакции
  cp -> "Payneteasy": Получение статуса по ИД транзакции\napi/v2/status
  "Payneteasy" --> cp : Ответ со\nстатусом,order-stage
  cp -> "Payneteasy": /api/v4/payout-pay/
  "Payneteasy" --> cp : Ответ payout-pay
  group Опционально
  cp -> "Payneteasy": Получение статуса по ИД транзакции\napi/v2/status
  "Payneteasy" --> cp : Ответ со\nстатусом,redirect-to
  cp -> R: Предоставлние URL-а перенаправления
  deactivate "Payneteasy"
  deactivate cp
  activate R
  R -> "Payneteasy": Перенаправление на redirect-to
  deactivate R
  activate "Payneteasy"
  "Payneteasy" -> R: Дополнительная форма подстверждения
  deactivate "Payneteasy"
  activate R
  R -> "Payneteasy": Подтверждение формы
  deactivate R
  activate "Payneteasy"
  end
  "Payneteasy" --> "Payneteasy": Обработка\nвыплаты
  group Получение финального статуса
  == Получение обратного вызова \nПрисоединяющейся Стороны ==
  cp <- "Payneteasy" : Обратный вызов с финальным статусом
  "Payneteasy" <-- cp: HTTP 200
  deactivate "Payneteasy"
  == Запрос статуса ==
  cp -> "Payneteasy": Получение статуса по ИД транзакции\napi/v2/status
  activate "Payneteasy"
  "Payneteasy" --> cp : Ответ со\nстатусом,order-stage
  deactivate "Payneteasy"
  end
  group Опционально
  cp --> R: Показ результата
  deactivate cp
  end

| (1) Выплата может быть инициирована Присоединяющейся Стороной в зависимости от внутренней бизнес-модели или запроса Получателя.
| (2) Для имплементации запроса на проверку возможности выплаты см. :ref:`/api/v4/payout-check/`.
| (4) Для имплементации запроса статуса, см. :ref:`/api/v2/status/</api/v2/status/>`.
| (5)  Параметр :ex:`order-stage` обязан вернуть :ex:`payout_check_validated`, возврат :ex:`payout_check_validating` означает что банк все ещё обрабатывает запрос. В этом случае Присоединяющаяся Сторона продолжает запрашивать статус транзакции.
| (6) Чтобы продолжить обработку Payout, реализуйте запрос payout-pay, см. :ref:`/api/v4/payout-pay/`.
| (9) Некоторые типы выплат требуют от Получателя заполнить дополнительные данные в форме. Форма будет перенаправлена клиенту в параметре redirect-to ответа на запрос статуса.
| (12) Получатель подтверждает форму выплаты.
| (13) Получатель перенаправляется назад к Присоединяющейся Стороне. См. :ref:`Финальное Перенаправление<final_redirect>`.
| (15) Для имплементации обратного вызова с обработкой финального статуса см. :ref:`Обратный вызов Присоединяющейся Стороны.<merchant_callbacks>`.
| (17) Статус должен запрашиваться несколько раз с интервалами в 3-5 секунд до получения финального статуса в ответе.
| (19) Финальный статус может быть отправлен Присоединяющейся Стороной в зависимости от бизнес модели или запроса Получателя.

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

   ----

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

      `Global payout corridors: SEPA, SWIFT, local rails → <https://payneteasy.com/blog/global-payouts-how-to-pay-third-parties-globally-with-ease>`_

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

   ----

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

      `Финтех-решения: выплаты и переводы → <https://payneteasy.ru/branches/fintech>`_