.. meta::
   :description: Перевод Deposit-to-Card через API SBC: отправка средств с учётной записи торговца непосредственно на карту получателя по каналам MoneySend или Visa Direct.

Deposit To Card Transfer
########################


.. role:: ex

.. role:: code


Введение
============

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

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


Deposit To Card Transfer Flow
=============================

.. uml::
  :align: center

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

.. ifconfig:: "doc.payneteasy.com" in site_link

   ----

   .. admonition:: See also
      :class: related-cross-link

      `Card-to-card transfers for fintech apps → <https://payneteasy.com/branches/fintech>`_

.. ifconfig:: "doc.payneteasy.ru" in site_link

   ----

   .. admonition:: См. также
      :class: related-cross-link

      `Финтех-решения: переводы карта-карта → <https://payneteasy.ru/branches/fintech>`_