Выплата

Совет: Эта статья посвящена тому, как проводятся выплаты в платёжной платформе ecommpay, какие операции при этом используются и как меняются статусы этих платежей и операций.

Помимо этой статьи для работы с выплатами могут быть полезны:

  • статья Выплаты с описанием того, как проводить выплаты через Gate и какие запросы и оповещения при этом актуальны в случае прямого использования платёжных карт;
  • статьи раздела Платёжные методы с описанием того, как проводить выплаты через Gate при работе с различными платёжными методами и какие запросы и оповещения могут быть актуальны при этом.

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

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

В рамках платёжной платформы поддерживается один вариант для работы с выплатами через запросы (разовые единичные выплаты), но дополнительно обеспечивается возможность проведения массовых выплат через Dashboard (с автоматическим формированием требуемого количества платежей; подробнее — в разделе Контроль и проведение платежей).

Модель проведения

Чтобы инициировать выплату, следует отправить в платформу запрос категории payout. Для выполнения такого запроса в платформе формируется операция payout, результатом выполнения которой является перечисление средств на счёт пользователя. При выполнении повторных попыток проведения выплаты в рамках одного платежа или разбиении суммы платежа формируются несколько таких операций (подробнее).

Для проведения выплаты может требоваться отправка дополнительного запроса, если необходимо уточнение информации для какой-либо из сторон, участвующих в проведении платежа (например, предоставление в платёжную систему адреса держателя карты, не переданного в исходном запросе). В этом случае от платформы к веб-сервису отправляется оповещение с названиями параметров для уточнения и проведение платежа в платформе приостанавливается до получения от веб-сервиса запроса с необходимой информацией — clarification. В настоящее время эта процедура не используется для работы альтернативными платёжными методами.

Если выплате после подтверждения со стороны платёжной системы или провайдера присвоен статус success, но зачислить средства пользователю по каким-либо причинам невозможно, то после получения уведомления об этом в платёжной платформе инициируется отмена выплаты. Это выполняется вручную специалистами технической поддержки ecommpay или, при использовании некоторых платёжных методов, автоматически. Для выполнения такой отмены формируется операция payout reversal.

Рис.: Диаграмма состояний выплаты

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

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

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

error Проведение платежа не инициировано из-за ошибки, возникшей при проверке принятого запроса Конечное состояние. Допускается повторная отправка запроса с тем же идентификатором платежа и повторная попытка проведения этого платежа
processing Платёж проводится Промежуточное состояние
awaiting clarification Проведение платежа приостановлено до получения запроса на продолжение с учётом требуемой дополнительной информации — clarification. Если такой запрос не получен в течение 30 минут, платёж переводится в статус decline Промежуточное состояние
awaiting retry Ожидаются повторные попытки выполнения выплаты в рамках проведения платежа (подробнее — в разделе Повторные попытки выплат) Промежуточное состояние
decline Платёж отклонён Конечное состояние
success

Платёж проведён (подтверждён на стороне платёжной системы или провайдера)

Конечное состояние. Дополнительно допускается отмена выплаты
reversed Платёж отменён Конечное состояние

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

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

processing Операция выполняется Промежуточное состояние
awaiting clarification Выполнение операции приостановлено до получения запроса на продолжение с учётом требуемой дополнительной информации — clarification. Если такой запрос не получен в течение 30 минут, операция переводится в статус decline Промежуточное состояние
decline Операция отклонена Конечное состояние
success Операция выполнена Конечное состояние

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

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

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

Дополнительные материалы

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

  • Организация взаимодействия — раздел с общей информацией о взаимодействии с платёжной платформой через Gate.
  • Выплаты — раздел с подробной информацией о проведении выплат на счета, ассоциированные с платёжными картами.
  • Оповещения — раздел с информацией об оповещениях и работе с ними.
  • Информация об операциях — раздел с информацией о кодах ошибок, используемых в платёжной платформе.