До вмісту

Партнерські та реферальні виплати в криптовалюті: платіть усім одразу

Партнерські виплати в криптовалюті дають змогу платити тисячам партнерів крихітні суми в багатьох країнах без банківських реквізитів. Розбираємо, як безпечно робити партії та автоматизувати реферальні виплати в крипті.

Payora9 хв читанняEN · RU · UK · ES · DE · FR · IT · PL · PT · HI · ZH

Партнерські виплати в криптовалюті вирішують дуже конкретну задачу: виплатити тисячам партнерів по кілька доларів кожному, у десятках країн, не збираючи при цьому жодного банківського реквізиту. У 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, тому посібник із перевірки підпису застосовний без змін.

Цикл звірки простий і зручний для аудиту:

  1. Надішліть партію циклу, використовуючи період як ключ ідемпотентності.
  2. За вебхуком payout.sent перевірте підпис, потім зіставте позиції з партнерами за адресою й сумою.
  3. Збережіть кожен 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-ключі, або прочитайте сторінку масових виплат, щоб побачити потік партій від початку до кінця.

Поділитися

Коментарі

Готові почати?

Створіть акаунт — і перший рахунок запрацює менш ніж за годину.