Швидкий старт
1. Створіть офер
Section titled “1. Створіть офер”У кабінеті замовника відкрийте Офери → Створити офер, у блоці «Як платите авторам?» оберіть Рефшара, заповніть форму й надішліть її на модерацію. Бюджет переходить із вашого балансу в офер. Усі поля описано на сторінці Офер із рефшарою.
2. Створіть ключ API
Section titled “2. Створіть ключ API”Коли офер схвалено, відкрийте сторінку офера й створіть ключ у блоці Ключ API. Ключ показується лише один раз: скопіюйте його у своє сховище секретів. Кожен офер має власний ключ.
export SULY_KEY='suly_…'3. Перевірте підключення
Section titled “3. Перевірте підключення”curl -s https://suly.gg/api/partner/v1/program \ -H "Authorization: Bearer $SULY_KEY"Ви отримаєте офер із його статусом, бюджетом і поточною комісією.
4. Видайте авторам коди
Section titled “4. Видайте авторам коди”Прочитайте авторів, які чекають на код:
curl -s "https://suly.gg/api/partner/v1/participants?status=pending" \ -H "Authorization: Bearer $SULY_KEY"Для кожного створіть у своїй системі реферальний код і посилання та надішліть їх:
curl -s https://suly.gg/api/partner/v1/participants/$ID/code \ -H "Authorization: Bearer $SULY_KEY" \ -H 'Content-Type: application/json' \ -d '{"code":"ANDRY","link":"https://partner.example/r/ANDRY"}'Автор одразу бачить код і посилання.
5. Заплатіть
Section titled “5. Заплатіть”Коли ваша система розрахувала, скільки заробив автор, надішліть нарахування з власним номером операції:
curl -s https://suly.gg/api/partner/v1/accruals \ -H "Authorization: Bearer $SULY_KEY" \ -H 'Content-Type: application/json' \ -d '{"participantId":"'$ID'","amount":"125.40","externalId":"2026-10-ANDRY","comment":"October 2026"}'Повторне надсилання того самого запиту з тим самим externalId нічого не оплачує двічі, тому його безпечно повторювати після тайм-ауту.
Типова інтеграція
Section titled “Типова інтеграція”- Кожні 5–15 хвилин: читайте учасників зі статусом
pendingі видавайте кожному код і посилання (або відмовляйте). - За вашим графіком виплат: перевіряйте бюджет через
GET /program, потім надсилайте по одному нарахуванню на автора. - Щодня й після кожної виплати: надсилайте кожному автору нотатку про те, чого він не бачить на suly.gg.
- Звірка: зіставляйте
GET /accrualsзі своїми виплатами заexternalId.