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