1.12. Payout By Reference

Введение

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

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

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