Схема и статусы перевода с карты на карту
Общая информация
Перевод с карты на карту — тип платежа, в рамках которого на основании одного исходного запроса осуществляются списание денежных средств с платежной карты отправителя и последующее зачисление этих средств на платежную карту получателя. При этом отправителем и получателем может быть как один и тот же, так и разные пользователи.
Схема проведения
В платежной платформе поддерживаются два варианта проведения перевода с карты на карту: базовый и сокращенный. В случае базового варианта проведения перевода на стороне платежной платформы ITX выполняются как списание, так и зачисление средств пользователю, а в случае сокращенного варианта — только списание или только зачисление. Сокращенный вариант может быть актуален, если мерчанту необходимо проводить через стороннего провайдера платежных услуг либо списание средств с карты отправителя, либо зачисление средств на карту получателя.
Далее представлены схемы базового и сокращенного вариантов проведения перевода с карты на карту.
- Чтобы инициировать проведение базового варианта, следует отправить в платформу запрос категории
money_transfer. При поступлении этого запроса в платежную платформу формируются и далее последовательно выполняются следующие операции:- Операция
sale, в результате которой выполняется списание c платежной карты отправителя. Если на этом этапе получен отказ, в платежной платформе автоматически отклоняется зачисление средств. - Операция
payout, в результате которой выполняется зачисление списанных средств на платежную карту получателя. Если на этом этапе получен отказ, в платежной платформе автоматически инициируется отмена списания средств (операцияreversal).
- Операция
- Чтобы инициировать проведение сокращенного варианта, следует отправить в платформу запрос категории
money_transfer/inили запрос категорииmoney_transfer/out. В зависимости от категории запроса в платежной платформе формируется одна из следующих операций:- Операция
sale, в результате которой выполняется списание c платежной карты отправителя — для запроса категорииmoney_transfer/in. Если по каким-либо причинам необходимо отменить списание средств, следует отправить в платежную платформу запрос категорииmoney_transfer/in/refund. При поступлении такого запроса выполняется операцияreversal, в результате которой списанные средства возвращаются отправителю. - Операция
payout, в результате которой выполняется зачисление списанных средств на платежную карту получателя — для запроса категорииmoney_transfer/out.
- Операция
В представленной далее схеме соответствия между запросом, платежом и операциями показано, что в результате запроса мерчанта на проведение базового варианта перевода, в платежной платформе инициируются и выполняются две операции. Операция отмены списания средств инициируется автоматически на стороне платежной платформы.
Вне зависимости от варианта проведения этого типа платежа может потребоваться отправка дополнительного запроса, если необходима аутентификация пользователя с использованием технологии 3-D Secure. Более подробная информация о такой аутентификации представлена в Более подробная информация о такой аутентификации представлена в разделах Аутентификация по протоколу 3‑D Secure 2 и Аутентификация по протоколу 3‑D Secure 1.
В рамках проведения этого типа платежа недоступна вспомогательная процедура дополнения информации о платеже, то есть при необходимости уточнения каких-либо параметров оповещение от платформы в веб-сервис не отправляется. Это подразумевает, что все параметры для проведения переводов следует передавать в платежную платформу в исходных запросах. Таким образом, при осуществлении переводов в странах, где необходима проверка в рамках Address Verification Service, в исходный запрос следует включить объект AvsInfo с указанием адреса, который зафиксирован эмитентом как актуальный для отправителя перевода (индекс, улица и номер дома).
Рис.: Диаграмма состояний перевода
Далее в рамках данного раздела представлена информация о возможных статусах перевода с карты на карту и связанных с ним операций.
Статусы платежа
При проведении перевода с карты на карту могут использоваться следующие статусы.
error |
Проведение платежа не инициировано из-за ошибки, возникшей при проверке принятого запроса | Конечное состояние. Допускается повторная отправка запроса с тем же идентификатором платежа и повторная попытка проведения этого платежа |
processing |
Платеж проводится | Промежуточное состояние |
awaiting 3ds result |
Проведение платежа приостановлено до получения запроса на продолжение с учетом результата аутентификации 3‑D Secure — 3ds_result. Если такой запрос не получен в течение 30 минут, платеж переводится в статус decline |
Промежуточное состояние |
decline |
Платеж отклонен, так как отклонена операция списания | Конечное состояние |
reversed |
Платеж отменен, так как отклонена операция зачисления или отменена операция списания | Конечное состояние |
success |
Платеж проведен | Конечное состояние |
Статусы операции sale
При выполнении операции sale могут использоваться следующие статусы.
processing |
Операция выполняется | Промежуточное состояние |
awaiting 3ds result |
Выполнение операции приостановлено до получения запроса на продолжение с учетом результата аутентификации 3-D Secure — 3ds_result. Если такой запрос не получен в течение 30 минут, операция переводится в статус decline |
Промежуточное состояние |
decline |
Операция отклонена | Конечное состояние |
success |
Операция выполнена | Конечное состояние |
Статусы операции payout
При выполнении операции payout могут использоваться следующие статусы.
processing |
Операция выполняется | Промежуточное состояние |
decline |
Операция отклонена | Конечное состояние |
success |
Операция выполнена | Конечное состояние |
Статусы операции reversal
При выполнении операции reversal могут использоваться следующие статусы.
processing |
Операция выполняется | Промежуточное состояние |
decline |
Операция отклонена | Конечное состояние |
success |
Операция выполнена | Конечное состояние |
Дополнительные материалы
При работе с переводами с карты на карту могут быть полезны следующие материалы:
- Общий порядок интеграции — раздел с общей информацией о взаимодействии с платежной платформой через Gate.
- Оповещения (callbacks) в Gate — раздел с информацией об оповещениях и работе с ними.
- Статусы операций и коды ответов — раздел с информацией о кодах ошибок, используемых в платежной платформе.