Для многих бизнесов ключевой задачей является не только прием платежей, но и регулярные выплаты партнерам, поставщикам, фрилансерам, сотрудникам или клиентам. PayShark.io предоставляет полноценный Payout API, который позволяет автоматизировать массовые выплаты через P2P-сеть. В этой статье мы подробно разберем, как использовать PayShark.io для выплат: от получения предложений до создания массовых выплат и обработки колбэков, с реальными бизнес-кейсами и примерами кода.
Система выплат PayShark.io построена на той же P2P-архитектуре, что и прием платежей. Вместо банковских переводов через медленные международные системы, вы создаете выплату через API, и средства мгновенно направляются получателю через оптимальный маршрут P2P-сети. Это обеспечивает скорость доставки средств в минутах, а не днях, и комиссию в разы ниже, чем у традиционных банковских переводов.
Получение предложений на выплату
Первый шаг для создания выплаты — получить список доступных предложений от трейдеров. Каждое предложение содержит информацию о доступной сумме, курсе конвертации, комиссии и времени обработки.
GET /api/payout/offers?currency=rub&amount=100000
Параметры: currency — код валюты выплаты (rub, kzt, byn), amount — сумма в минимальных единицах валюты.
Ответ содержит массив предложений, отсортированных по оптимальности. Каждое предложение включает: id (идентификатор), amount (доступная сумма), rate (курс конвертации), commission (комиссия сервиса), processing_time (время обработки в минутах), payment_method (доступный метод выплаты).
Выбор оптимального предложения критически важен. Разные трейдеры предлагают разные курсы и комиссии. Ваша система должна автоматически выбирать лучшее предложение на основе заданных критериев: минимальная комиссия, максимальная скорость обработки или баланс между ними.
Создание выплаты
После выбора предложения создается выплата:
POST /api/payout
-d 'offer_id=OFFER_ID'
-d 'amount=100000'
-d 'currency=rub'
-d 'payment_details={"card_number":"1234567890123456"}'
-d 'callback_url=https://merchant.example/payout/callback'
Параметры: offer_id (выбранное предложение), amount (сумма), currency (валюта), payment_details (реквизиты получателя), callback_url (URL для уведомлений).
Ответ содержит ID выплаты, статус, сумму, реквизиты получателя и время обработки.
Статусы выплаты проходят последовательность: pending, processing_by_trader, processing_by_administrator, fully_completed. При ошибке — cancelled или dispute. Каждый статус сопровождается callback-уведомлением для автоматизации.
Массовые выплаты через пул
Для выплат большому количеству получателей используется функция пула:
POST /api/payout/pool
-d 'currency=rub'
-d 'payouts=[{"amount":50000,"payment_details":{"card_number":"1111111111111111"}},{"amount":30000,"payment_details":{"card_number":"2222222222222222"}}]'
-d 'callback_url=https://merchant.example/payout/pool/callback'
Этот метод создает групповую выплату как единую операцию. Все получатели получают средства одновременно.
Практический кейс: выплата комиссионных партнерской сети. Партнерская программа с 500 участниками ежемесячно выплачивает комиссионные на сумму от 10 до 500 тысяч рублей каждому. Используя Payout Pool API, можно отправить все 500 выплат одной командой. Система автоматически распределит средства, и каждый партнер получит свою комиссию в течение нескольких минут.
Споры по выплатам
Если получатель не получил средства, открывается спор:
POST /api/payout/dispute
-d 'payout_id=ID_ВЫПЛАТЫ'
Администраторы PayShark разбирают ситуацию. Для получения информации о споре используется GET /api/payout/dispute.
Безопасность выплат — критический аспект. PayShark.io рекомендует настроить двухфакторную аутентификацию для создания крупных выплат, установить лимиты на суммы и количество выплат, вести журнал всех операций для аудита.
Интеграция Payout API PayShark.io позволяет полностью автоматизировать процесс выплат, снизить операционные издержки и обеспечить мгновенную доставку средств получателям. Это решение подходит для любых бизнес-сценариев, требующих регулярных выплат физическим и юридическим лицам.
