Выплаты средств (Pay-Out)
Назначение Pay-Out
Section titled “Назначение Pay-Out”Pay-Out — это процесс вывода средств с вашего баланса на реквизит ваших клиентов
С помощью данного механизма вы можете отправлять выплаты как на собственные счета, так и на реквизиты ваших клиентов.
Процесс Pay-Out построен таким образом, чтобы обеспечить контролируемую, прозрачную и корректную обработку каждой заявки на вывод.
Этот же API используется и для создания matching-заявок. В этом режиме вместо обычной pay-out сделки система создаёт контейнер спроса на выплату, который затем может быть закрыт входящими invoice pay-in сделками.
Matching
Section titled “Matching”Для сценария matching в спецификации вынесена отдельная страница:
Если вам нужно создать matching-заявку, используйте стандартный POST /payment/pay-out с флагом isMatching=true. Полный flow создания, наполнения, invoice confirmation и fallback-логики описан на отдельной странице.
Логика обработки выплат
Section titled “Логика обработки выплат”Каждая операция Pay-Out проходит несколько этапов обработки.
Статус заявки отражает её текущее состояние и позволяет отслеживать прогресс выполнения.
Статусы Pay-Out операций
Section titled “Статусы Pay-Out операций”pending
Section titled “pending”- Заявка на выплату создана и принята системой.
- Операция ожидает начала обработки.
- На этом этапе выполняются первичные проверки и постановка в очередь.
active
Section titled “active”- Выплата находится в процессе выполнения.
- Операция обрабатывается оператором или автоматизированной системой.
- Возможна проверка реквизитов и подготовка перевода средств.
success
Section titled “success”- Выплата успешно завершена.
- Средства отправлены по указанным реквизитам.
- Операция считается выполненной и не требует дальнейших действий.
canceled
Section titled “canceled”- Заявка на выплату отменена.
- Возможные причины отмены:
- некорректно указанные реквизиты;
- невозможность принять средства по заданным данным;
- выявленные ошибки или несоответствия при проверке.
Особенности изменения статусов
Section titled “Особенности изменения статусов”Уведомления о статусах
Section titled “Уведомления о статусах”Webhook-уведомления
Все изменения статусов Pay-Out операций автоматически отправляются на ваш webhook-адрес.
Это позволяет в реальном времени отслеживать состояние выплат и синхронизировать данные с вашей системой.
Рекомендации
Section titled “Рекомендации”- Всегда проверяйте корректность платёжных реквизитов перед созданием заявки.
- Обрабатывайте webhook-уведомления идемпотентно.
- Учитывайте, что обработка выплат может занимать различное время в зависимости от типа реквизитов и загрузки системы.
- Если вы используете matching, заранее определите, какой тип invoice будет закрывать заявку:
c2c_invoiceилиsbp_invoice. - Для matching рекомендуется всегда передавать отдельный
matchingTransactionId, чтобы не смешивать идентификатор контейнера и идентификаторы downstream-операций.
Механизм Pay-Out является ключевым инструментом для управления выводом средств и обеспечивает надёжную и контролируемую работу с выплатами.