Выплаты средств (Pay-Out)
Назначение Pay-Out
Section titled “Назначение Pay-Out”Pay-Out — это процесс вывода средств с вашего баланса на реквизит ваших клиентов
С помощью данного механизма вы можете отправлять выплаты как на собственные счета, так и на реквизиты ваших клиентов.
Процесс Pay-Out построен таким образом, чтобы обеспечить контролируемую, прозрачную и корректную обработку каждой заявки на вывод.
Этот же API используется и для выплат мэтчинга (isMatching: true): выплата закрывается входящими депозитами игроков и, при нехватке, выплатами трейдеров платформы. Контракт мэтчинга (статусы, части fills[], callback-и, закрытие на оплаченном) описан отдельно.
Matching
Section titled “Matching”Для сценария matching в спецификации вынесена отдельная страница:
Выплата мэтчинга создаётся тем же POST /payment/pay-out с isMatching: true; timeoutInMin для неё — SLA выплаты. Ответ, GET и callback выплаты мэтчинга имеют один формат (части — в fills[], callback-и — только финал и корректировки), закрыть выплату на оплаченном можно через POST /payment/pay-out/{id}/close. Подробности — на странице Мэтчинг.
Логика обработки выплат
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-уведомления идемпотентно.
- Учитывайте, что обработка выплат может занимать различное время в зависимости от типа реквизитов и загрузки системы.
- Для выплат мэтчинга метод определяется реквизитом (
sbpNumber→sbp_invoice,cardNumber→c2c_invoice), ключ выплаты —merchantTransactionId(поляmatchingTransactionIdнет). - Callback-и выплат мэтчинга обрабатывайте идемпотентно по паре (
id,eventSeq).
Механизм Pay-Out является ключевым инструментом для управления выводом средств и обеспечивает надёжную и контролируемую работу с выплатами.