Партнерські виплати в криптовалюті вирішують дуже конкретну задачу: виплатити тисячам партнерів по кілька доларів кожному, у десятках країн, не збираючи при цьому жодного банківського реквізиту. У Payora ви вставляєте до 500 отримувачів у кабінеті або надсилаєте їх через payout API; сума партії плюс комісії утримується на внутрішньому балансі в момент надсилання, а далі виплата проходить налаштований для вашого акаунта потік схвалення й випуску. Ця стаття — про те, коли партнерські виплати в криптовалюті реально виграють у SWIFT-переказів і PayPal, про неочевидні обмеження й про те, як вбудувати все це в платіжний цикл так, щоб впалий cron ніколи не заплатив двічі.
Чому крипта пасує партнерським і реферальним виплатам
У партнерських і rev-share програм форма виплат така, з якою традиційні рейки дають раду погано: багато отримувачів, малі суми, міжнародні, за повторюваним розкладом. Крипта лягає на цю форму майже ідеально.
- Один глобальний канал. Партнер у Манілі, у Лагосі та в Буенос-Айресі отримують гроші однаково, за ті самі хвилини, з того самого балансу. Немає матриці країн, де що підтримує PayPal і який коридор тихо блокує ваш банк.
- Малі мінімуми справді працюють. Комісія в 4 долари — похибка на тлі 15-доларового міжнародного переказу, тому її просто не надсилають. Заплатіть ті самі 4 долари в USDT на дешевій мережі — і комісія складе центи. Дрібні часті виплати перестають бути невигідними.
- Жодного тертя з банківськими реквізитами. Ви збираєте одне поле на партнера — адресу — замість IBAN, номера рахунку, SWIFT/BIC і юридичного імені, яке має збігатися. Онбординг нового партнера — це вставка, а не форма.
- Швидко. Після підпису розрахунок до отримувача — хвилини, а не два-п’ять робочих днів переказу, який може повернутися через розбіжність імені.
- Платежі остаточні, тому за тим, що ви виплатили, немає чарджбеків. Партнер не може скасувати отриману комісію так, як покупець за карткою оскаржує покупку.
В останнього пункту дві сторони — і це підводить нас до чесної частини.
Чесні обмеження
У остаточності є зворотний бік: відкликати виплату не можна. Якщо ви схвалили й випустили комісію шахраю чи самореферу, завершену ончейн-виплату не можна просто забрати назад — та сама фінальність, що захищає вас від чарджбеків, працює в обидва боки. Тому дисципліна зміщується вище за потоком: схвалюйте уважно, притримуйте підозрілі акаунти до партії й ставтеся до підтвердженого випуску виплат як до точки неповернення. Payora не перевірятиме ваших партнерів за вас; це рішення лишається за вашою програмою.
Друге обмеження — операційне. Надсилання партії — з кабінету чи через API — резервує кошти на вашому балансі Payora й створює payout-партію, але отримувачів не можна вважати оплаченими в момент надсилання заявки. Дотримуйтеся потоку схвалення, випуску й статусів, налаштованого для вашого акаунта, а потім перевіряйте статус виплати та транзакційні докази, перш ніж позначати комісії виплаченими. Хто обіцяє «викликав API — гроші миттєво пішли й уже розраховані», описує більш автоматизовану й ризикованішу модель. Матеріал про архітектуру масових виплат дає загальний контекст, але поточні операційні кроки треба звіряти з документацією продукту й налаштуваннями вашого акаунта.
Два способи запускати партнерські виплати в криптовалюті
Для щомісячного чи разового запуску кабінет — найшвидший шлях. Відкрийте масові виплати, вставте до 500 рядків виду address amount [tag/memo] й надішліть. Сума партії плюс покомпонентна комісія утримується на вашому балансі, тому партію неможливо перевитратити, а потім ви проходите налаштовані для акаунта кроки схвалення й випуску. Destination tag для XRP і memo для XLM ідуть у необов’язкове третє поле в рядку.
Для програми, що платить за фіксованим циклом, керуйте нею через API. POST /v1/payout приймає валюту й до 500 позицій і повертає 201 з batch_id, item_count, total і fee. Автентифікація — та сама схема HMAC, що й у всьому API: заголовки X-Payora-Key, X-Payora-Timestamp і X-Payora-Signature, де підпис — це hex(HMAC-SHA256(api_secret, timestamp . "." . raw_body)) у вікні 120 секунд.
curl -X POST https://api.payora.money/v1/payout \
-H "X-Payora-Key: $KEY" \
-H "X-Payora-Timestamp: $TS" \
-H "X-Payora-Signature: $SIG" \
-H "Idempotency-Key: rev-share-2026-07" \
-H "Content-Type: application/json" \
-d '{"currency":"USDT","items":[
{"address":"TXy...","amount":"12.50","tag":""},
{"address":"TAb...","amount":"4.00","tag":""}
],"note":"July affiliate rev-share"}'Повні формати запиту й відповіді, а також ендпойнти статусу й скасування виплат — у документації API. Ще партію, що очікує, можна скасувати через POST /v1/payout/{id}/cancel, що повертає утриманий баланс вам.
Ідемпотентність: повторний запуск cron ніколи не платить двічі
Це найважливіша деталь для автоматичних партнерських виплат. Cron-завдання падають на півдорозі. Мережевий збій обриває відповідь уже після того, як сервер створив вашу партію, спрацьовує ваша логіка повтору — і ви за одну нервову мить від того, щоб заплатити кожному партнеру двічі.
Надсилайте заголовок Idempotency-Key зі значенням, стабільним для циклу виплат — ідеально сам ідентифікатор циклу, наприклад rev-share-2026-07. Перший запит створює партію; будь-який повтор із тим самим ключем повертає той самий batch_id і не створює нічого нового. Інше тіло під уже зафіксованим ключем повернеться як 409 idempotency_conflict, а не розгалузиться мовчки. Будуйте ключ із платіжного періоду, а не з випадкового UUID на спробу — і впалий запуск можна спокійно просто повторити.
Звірка через вебхук payout.sent і покомпонентні tx-хеші
Ніколи не позначайте комісію «виплачено» у своїй базі на основі оптимістичного здогаду. Дочекайтеся доказу. Після завершення налаштованого потоку випуску, коли в Payora є транзакційні докази за позиціями партії, вона шле підписаний вебхук payout.sent із batch_id і кожною позицією з її ончейн-tx_hash. Він підписується й перевіряється тією самою схемою HMAC-SHA256, що й invoice.paid, тому посібник із перевірки підпису застосовний без змін.
Цикл звірки простий і зручний для аудиту:
- Надішліть партію циклу, використовуючи період як ключ ідемпотентності.
- За вебхуком
payout.sentперевірте підпис, потім зіставте позиції з партнерами за адресою й сумою. - Збережіть кожен
tx_hashпоряд із комісією, щоб партнер із питанням «де мої гроші» отримав посилання на блок-експлорер, а не тікет у підтримку.
Якщо вам ближче опитування, GET /v1/payout/{id} на запит поверне той самий покомпонентний статус і tx-хеші.
Комісії: для безлічі дрібних виплат беріть дешеву мережу
Прийом грошей у Payora — 0%. Налаштовувана комісія за списання (1,5% на тарифі Free плюс комісія мережі монети) застосовується до виплат і утримується покомпонентно разом із партією, а ончейн-комісія мережі — окрема й неминуча. Для партнерських запусків — безліч дрібних сум — саме мережева комісія вирішує, виграєте ви чи втрачаєте, тому вибір монети й мережі важливіший за все інше.
Виплата USDT на Tron чи на дешевій EVM-мережі на кшталт Polygon або Base коштує центи за переказ; виплата тих самих комісій у нативному ETH на мейннеті Ethereum у годину пік може коштувати більше за саму комісію. Спершу виберіть мережу — і розмір виплати перестане мати значення. Повний розбір — у посібнику зі зниження комісій крипто-платежів.
Сувора валідація не дає поганій адресі вам коштувати
Запуск виплат безжальний до одруків, бо він остаточний. Payora валідує всю партію до того, як утримає бодай одну монету: якщо бодай одна адреса некоректна або в суми більше знаків після коми, ніж підтримує монета, весь запит відхиляється з HTTP 422 та індексами проблемних позицій. Це «все або нічого» навмисне — запуск ніколи мовчки не викине партнера й не обріже суму. Виправте позначені рядки й надішліть знову. Оскільки погана адреса партнера відбиває партію, а не з’їдає кошти, один партнер, що вставив адресу невірно, не може коштувати вам виплати.
Збираємо докупи
Партнерська програма на Payora виглядає так: партнери дають адресу, ваша платформа збирає список виплат циклу, ви надсилаєте його POST-ом із періодом як ключем ідемпотентності на дешевій мережі, сувора валідація ловить погані рядки, ваша команда проходить налаштований потік схвалення й випуску, а вебхук payout.sent записує транзакційні докази назад до кожної комісії. Глобальне охоплення й крихітні мінімуми в плюсі; акуратне схвалення й перевірка статусу як ціна. Створіть безкоштовний акаунт, щоб отримати API-ключі, або прочитайте сторінку масових виплат, щоб побачити потік партій від початку до кінця.
Коментарі