Перевод

Общая информация

Перевод — это тип платежа, в рамках которого на основании одного исходного запроса для перевода денежных средств от отправителя к получателю последовательно выполняются две операции: списание средств отправителя и зачисление средств получателю. При этом в разных случаях отправителем и получателем могут выступать как одни и те же, так и разные пользователи, для списания и зачисления средств могут использоваться различные платёжные инструменты, а мерчант каждый раз выступает в роли посредника, предоставляющего сервис для таких переводов.

Проведение платежей этого типа доступно при работе через Gate.

Схема проведения

Чтобы инициировать перевод, следует отправить в платформу запрос категории money_transfer. Для выполнения такого запроса в платформе формируются и последовательно выполняются следующие операции:

Операция списания (sale), результатом выполнения которой является списание средств отправителя. Если списание отклоняется, то последующая операция зачисления не инициируется.
Операция зачисления (payout), результатом выполнения которой является зачисление средств получателю. Если зачисление отклоняется, то в платформе инициируется отмена выполненного списания (с помощью операции reversal или refund), чтобы вернуть средства отправителю.

В зависимости от того, какие платёжные инструменты используются на стороне отправителя и получателя, для проведения перевода может потребоваться выполнение вспомогательных процедур, таких как аутентификация пользователя с использованием протокола 3‑D Secure (Аутентификация 3‑D Secure). Вместе с тем, при выполнении переводов не может применяться процедура дополнения информации о платеже, поэтому во избежание отклонения инициированных переводов следует указывать в запросах все обязательные и рекомендуемые сведения.

Рис. 1. Диаграмма состояний перевода

Далее в рамках данной статьи представлена информация о возможных статусах перевода и связанных с ним операций. Более подробную информацию о проведении перевода через Gate можно получить в статье Переводы.

Статусы платежа

При проведении перевода могут использоваться следующие статусы.


`error`	Проведение платежа не инициировано из-за ошибки, возникшей при проверке принятого запроса	Конечное состояние. Допускается повторная отправка запроса с тем же идентификатором платежа и повторная попытка проведения этого платежа
`processing`	Платёж проводится	Промежуточное состояние
`awaiting redirect result`	Проведение платежа приостановлено до получения уведомления о результате обработки платежа на стороне платёжной системы. В зависимости от результата на стороне платёжной системы платёж переводится в статус `success` или `decline`. В рамках проведения одного платежа может использоваться статус `awaiting redirect result` либо `awaiting customer action`, но не оба этих статуса	Промежуточное состояние
`awaiting customer action`	Проведение платежа приостановлено до выполнения пользователем необходимых действий на стороне платёжной системы (в соответствии со спецификой платёжного метода). В зависимости от результата этих действий платёж переводится в статус `success` или статус `decline`. В рамках проведения одного платежа может использоваться `awaiting customer action` либо `awaiting redirect result`, но не оба этих статуса	Промежуточное состояние
`awaiting 3ds result`	Проведение платежа приостановлено до получения информации о результате аутентификации 3‑D Secure. Если такая информация не получена в течение установленного времени, то платёж переводится в статус `decline`. Как правило, время ожидания такой информации составляет 30 минут. Для получения более подробной информации о времени ожидания следует обращаться к специалистам технической поддержки — support@flashpay.kg	Промежуточное состояние
`decline`	Платёж отклонён, поскольку отклонена операция списания	Конечное состояние
`reversed`	Платёж отклонён, поскольку отклонена операция зачисления, при этом списанная сумма возвращена отправителю перевода до закрытия операционного дня	Конечное состояние
`refunded`	Платёж отклонён, поскольку отклонена операция зачисления, при этом списанная сумма возвращена отправителю перевода после закрытия операционного дня, в котором было выполнено списание	Конечное состояние.
`success`	Платёж проведён	Конечное состояние

Статусы операции sale

При выполнении операции sale могут использоваться следующие статусы.


`processing`	Операция выполняется	Промежуточное состояние
`awaiting redirect result`	Выполнение операции приостановлено до получения уведомления о результате обработки платежа на стороне платёжной системы. В зависимости от результата операция переводится в статус `success` или статус `decline`	Промежуточное состояние
`awaiting customer action`	Выполнение операции приостановлено до выполнения выполнения пользователем необходимых действий на стороне платёжной системы (в соответствии со спецификой платёжного метода). В зависимости от результата этих действий операция переводится в статус `success` или `decline`	Промежуточное состояние
`awaiting 3ds result`	Выполнение операции приостановлено до получения информации о результате аутентификации 3‑D Secure. Если такая информация не получена в течение установленного времени, то операция переводится в статус `decline`. Как правило, время ожидания такой информации составляет 30 минут. Для получения более подробной информации о времени ожидания следует обращаться к специалистам технической поддержки — support@flashpay.kg	Промежуточное состояние
`decline`	Операция отклонена	Конечное состояние
`success`	Операция выполнена	Конечное состояние

Статусы операции payout

При выполнении операции payout могут использоваться следующие статусы.


`processing`	Операция выполняется	Промежуточное состояние
`decline`	Операция отклонена	Конечное состояние
`success`	Операция выполнена	Конечное состояние

Статусы операции reversal и refund

При выполнении операций reversal и refund могут использоваться следующие статусы.


`processing`	Операция выполняется	Промежуточное состояние
`decline`	Операция отклонена	Конечное состояние
`success`	Операция выполнена	Конечное состояние