1.15. Deposit To Card Transfer

Введение

Перевод с пополнением карты (D2C) — перевод средств с банковского счёта Присоединяющейся стороны (Deposit) на номер банковской карты получателя (PAN) или токенизированные данные карты (Card Reference ID). Выполняется в три этапа:

Первоначальный платёж — любой тип транзакции с данными держателя карты: sale, preauth, transfer и т. д. Важно выполнить первоначальный платёж максимально безопасно, чтобы гарантировать регистрацию карты её реальным держателем.
Регистрация карты — получите card-ref-id (идентификатор ссылки на карту) и зарегистрируйте карту клиента в его профиле. Идентификатор ссылки на карту можно использовать неограниченное число раз, пока банковская карта активна.
Перевод денег – выполните команду API v4/transfer-by-ref/, используя destination-card-ref-id, полученный на предыдущем шаге.
Значение терминов см. в Глоссарии.

Deposit To Card Transfer Flow

@startuml skinparam roundcorner 20 skinparam sequenceArrowThickness 1 skinparam maxmessagesize 1200 skinparam sequenceParticipant underline actor Плательщик as P participant "Присоединяющаяся Сторона" as A participant SBC as B autonumber hnote over P,B : Инициация платежа == Регистрация карты == A -> B: api/v2/create-card-ref activate A activate B B --> A: Return card-ref-id deactivate B A -> A: Назначение токен ИД профилю Клиента deactivate A == Получение информации о карте == group Опционально A -> B: api/v2/get-card-info/ activate A activate B B -> A: Получение информации о карте deactivate A deactivate B end == Списание средств на карту == A -> B: api/v4/transfer-by-ref/ activate A activate B B --> A: Ответ с ИД транзакции B -> B: Обработка\nсписания средств group Получение финального статуса == Получение обратного вызова \nПрисоединяющейся Стороны == A <- B: Обратный вызов с финальным статусом A --> B: HTTP 200 deactivate B == Запрос статуса == A -> B: Получение статуса по ИД транзакции activate B B --> A: Конечный статус deactivate A deactivate B end @enduml

(1) Для реализации регистрации карты и получения Card Reference ID см. /api/v2/create-card-ref.
(3) Присоединяющаяся сторона назначает идентификатор ссылки на карту профилю клиента, после чего отображает страницу с сообщением об успешной регистрации карты и одобрении первоначального платежа.
(4) Сведения о реализации запроса информации о карте по Card Reference ID см. в /api/v2/get-card-info. Содержимое ответа на этот запрос можно использовать для отображения Плательщику информации о ранее использованной карте или для обновления базы данных Присоединяющейся стороны. Этот запрос можно выполнять в любое время, если Присоединяющаяся сторона располагает Card Reference ID.
(6) Присоединяющаяся сторона инициирует deposit to card transfer (D2C). Для реализации запроса deposit to card см. /api/v4/transfer-by-ref
(9) Для имплементации обратного вызова с обработкой финального статуса см.:ref:Обратный вызов Присоединяющейся Стороны<merchant_callbacks>.
(11) Для реализации запроса статуса заказа см. /api/v2/status/. Статус следует запрашивать несколько раз с интервалом 3-5 секунд до получения финального статуса в ответе.
(12) Финальный статус может быть отправлен Присоединяющейся стороной на основе внутренней бизнес-модели или по запросу Получателя.