.. meta::
   :description: Payout по ссылке в API SBC: отправка средств на ранее использованную карту по сохранённому recurring ID без повторного сбора данных карты получателя.

.. _payout_by_ref:

Payout By Reference
#######################################


.. role:: ex

.. role:: code

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

| Payout-by-ref — тип транзакции, приводящий к переводу средств с банковского счёта Присоединяющейся стороны на банковскую карту, банковский счёт или цифровой кошелёк клиента (получателя). В большинстве случаев Payout используется для пополнения банковского счёта.
| Идентификатор ссылки на карту счёта получателя (:ex:`destination-card-ref-id`) для Payout By Reference можно получить на этапе регистрации карты; см. :ex:`card-ref-id` в :ref:`v2/create-card-ref<api-v2-card-ref-id>` или :ref:`v4/create-card-ref<api-v4-card-ref-id>`.
| Регистрация карты требует ранее совершённой транзакции в финальном статусе, поэтому Payout-by-ref может быть инициирован только для уже зарегистрированных Получателей.

| Значение терминов см. в :ref:`Глоссарии<glossary>`.

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

.. uml::
  :align: center

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

| (1) Payout-by-ref может быть инициирован Присоединяющейся стороной на основе внутренней бизнес-модели или по запросу Получателя.
| (2) Для реализации транзакции payout-by-ref см. :ref:`/api/v4/payout-by-ref/`.
| (5) Чтобы реализовать запрос статуса заказа, см. :ref:`/api/v2/status/</api/v2/status/>`. Статус должен быть запрошен несколько раз с интервалом 3-5 секунд, пока в ответе не будет получен окончательный статус.
| (7) Для обработки обратного вызова с окончательным статусом заказа см. :ref:`Обратный вызов Присоединяющейся Стороны<merchant_callbacks>`.
| (9) Окончательный статус может быть отправлен Присоединяющейся Стороной основываясь на внутренней бизнес-модели или по запросу Получателя.

.. 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>`_