1.10. Payout-by-ref

Introduction

Payout-by-ref is a type of transaction which results in funds transfer from Connecting Party banking account to customer (receiver) banking account or digital wallet. Payout transaction in most cases is used for bank account funding.
Receiver account reference for Payout-by-ref (destination-card-ref-id) can be obtained on Card registration step, see card-ref-id in v2/create-card-ref.
Card registration requires a previously made transaction in final status, so Payout-by-ref can be initiated only for already registered Receivers.
See terms definitions in Glossary.

Payout Flow

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

(1) Payout-by-ref can be initiated by Connecting Party based on internal business model or Receiver’s request.
(2) To implement payout-by-ref transaction see /api/v4/payout-by-ref.
(5) To implement order status request see /api/v2/status/. Status should be requested multiple times with 3-5 seconds interval until final status will be received in response.
(7) To implement callback with final status handling see Connecting Party Callback.
(9) Final Status can be sent by Connecting Party based on internal business model or by Receiver’s request.