Выплата
Помимо этой статьи для работы с выплатами могут быть полезны:
- статья Выплаты с описанием того, как проводить выплаты через Gate и какие запросы и оповещения при этом актуальны в случае прямого использования платёжных карт;
- статьи раздела Платёжные методы с описанием того, как проводить выплаты через Gate при работе с различными платёжными методами и какие запросы и оповещения могут быть актуальны при этом.
Общая информация
Выплата — это тип платежа, в рамках которого на основании одного исходного запроса осуществляется один перевод денежных средств от мерчанта к пользователю.
В рамках платёжной платформы поддерживается один вариант для работы с выплатами через запросы (разовые единичные выплаты), но дополнительно обеспечивается возможность проведения массовых выплат через Dashboard (с автоматическим формированием требуемого количества платежей; подробнее — в разделе Контроль и проведение платежей).
Модель проведения
Чтобы инициировать выплату, следует отправить в платформу запрос категории payout. Для выполнения такого запроса в платформе формируется операция payout, результатом выполнения которой является перечисление средств на счёт пользователя.
Для проведения выплаты может требоваться отправка дополнительного запроса, если необходимо уточнение информации для какой-либо из сторон, участвующих в проведении платежа (например, предоставление в платёжную систему адреса держателя карты, не переданного в исходном запросе). В этом случае от платформы к веб-сервису отправляется оповещение с названиями параметров для уточнения и проведение платежа в платформе приостанавливается до получения от веб-сервиса запроса с необходимой информацией — clarification. В настоящее время эта процедура не используется для работы альтернативными платёжными методами.
Если выплате после подтверждения со стороны платёжной системы или провайдера присвоен статус success, но зачислить средства пользователю по каким-либо причинам невозможно, то после получения уведомления об этом в платёжной платформе инициируется отмена выплаты. Это выполняется вручную специалистами технической поддержки ecommpay или, при использовании некоторых платёжных методов, автоматически. Для выполнения такой отмены формируется операция payout reversal.
Далее в рамках данного раздела представлена информация о возможных статусах выплаты и связанных с ней операций. Более подробную информацию о проведении выплат на счета, ассоциированные с платёжными картами, можно найти в разделе Выплаты, а о проведении выплат на альтернативные платёжные инструменты — в разделе Платёжные методы.
Статусы платежа
При проведении выплаты могут использоваться следующие статусы.
error |
Проведение платежа не инициировано из-за ошибки, возникшей при проверке принятого запроса | Конечное состояние. Допускается повторная отправка запроса с тем же идентификатором платежа и повторная попытка проведения этого платежа |
processing |
Платёж проводится | Промежуточное состояние |
awaiting clarification |
Проведение платежа приостановлено до получения запроса на продолжение с учётом требуемой дополнительной информации — clarification. Если такой запрос не получен в течение 30 минут, платёж переводится в статус decline |
Промежуточное состояние |
decline |
Платёж отклонён | Конечное состояние |
success |
Платёж проведён (подтверждён на стороне платёжной системы или провайдера) |
Конечное состояние. Дополнительно допускается отмена выплаты |
reversed |
Платёж отменён | Конечное состояние |
Статусы операции payout
При выполнении операции payout могут использоваться следующие статусы.
processing |
Операция выполняется | Промежуточное состояние |
awaiting clarification |
Выполнение операции приостановлено до получения запроса на продолжение с учётом требуемой дополнительной информации — clarification. Если такой запрос не получен в течение 30 минут, операция переводится в статус decline |
Промежуточное состояние |
decline |
Операция отклонена | Конечное состояние |
success |
Операция выполнена | Конечное состояние |
Статусы операции payout reversal
При выполнении операции payout reversal могут использоваться следующие статусы.
processing |
Операция выполняется | Промежуточное состояние |
decline |
Операция отклонена | Конечное состояние |
success |
Операция выполнена | Конечное состояние |
Дополнительные материалы
При работе с выплатами могут быть полезны следующие материалы:
- Организация взаимодействия — раздел с общей информацией о взаимодействии с платёжной платформой через Gate.
- Выплаты — раздел с подробной информацией о проведении выплат на счета, ассоциированные с платёжными картами.
- Оповещения — раздел с информацией об оповещениях и работе с ними.
- Информация об операциях — раздел с информацией о кодах ошибок, используемых в платёжной платформе.