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

Введение

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

Значение терминов см. в Глоссарии.

Bank Wire Transfer Flow

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

Simple Bank Transfer Flow Statuses

Stage название

Описание

AUTH_APPROVED

Счёт был выставлен Плательщику.

CANCEL_APPROVED

Плательщик не завершил перевод. Этот этап необязателен и может использоваться для лучшего контроля транзакции в бэк-офисе.

CAPTURE_APPROVED

Funds were transferred to the Присоединяющаяся сторона account (settled).

VOID_APPROVED

Средства были возвращены Плательщиком (отозваны).

REVERSAL_APPROVED

Funds were returned to the Payer by Присоединяющаяся сторона.

Extended Bank Transfer Flow Statuses

Stage название

Описание

AUTH_STARTING

Транзакция was initiated.

AUTH_INVOICED

Счёт был выставлен плательщику. Его можно скачать в бэк-офисе, отправить плательщику по электронной почте или запросить через API.

AUTH_SENT

Плательщик сообщил Присоединяющейся стороне, что счёт оплачен. Этот этап может быть пропущен.

CANCEL_APPROVED

Плательщик не завершил перевод. Этот этап необязателен и может использоваться для лучшего контроля транзакции в бэк-офисе.

AUTH_APPROVED

Перевод был получен банком.

CAPTURE_APPROVED

Funds were transferred to the Присоединяющаяся сторона account (settled).

VOID_APPROVED

Средства были возвращены Плательщиком (отозваны).

REVERSAL_APPROVED

Funds were returned to the Payer by Присоединяющаяся сторона.

CHARGEBACK_APPROVED

Средства были возвращены плательщиком.