Перейти до вмісту

Швидкий старт

У кабінеті замовника відкрийте Офери → Створити офер, у блоці «Як платите авторам?» оберіть Рефшара, заповніть форму й надішліть її на модерацію. Бюджет переходить із вашого балансу в офер. Усі поля описано на сторінці Офер із рефшарою.

Коли офер схвалено, відкрийте сторінку офера й створіть ключ у блоці Ключ API. Ключ показується лише один раз: скопіюйте його у своє сховище секретів. Кожен офер має власний ключ.

Terminal window
export SULY_KEY='suly_…'

3. Перевірте підключення

Section titled “3. Перевірте підключення”
Terminal window
curl -s https://suly.gg/api/partner/v1/program \
-H "Authorization: Bearer $SULY_KEY"

Ви отримаєте офер із його статусом, бюджетом і поточною комісією.

Прочитайте авторів, які чекають на код:

Terminal window
curl -s "https://suly.gg/api/partner/v1/participants?status=pending" \
-H "Authorization: Bearer $SULY_KEY"

Для кожного створіть у своїй системі реферальний код і посилання та надішліть їх:

Terminal window
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"}'

Автор одразу бачить код і посилання.

Коли ваша система розрахувала, скільки заробив автор, надішліть нарахування з власним номером операції:

Terminal window
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 нічого не оплачує двічі, тому його безпечно повторювати після тайм-ауту.

  1. Кожні 5–15 хвилин: читайте учасників зі статусом pending і видавайте кожному код і посилання (або відмовляйте).
  2. За вашим графіком виплат: перевіряйте бюджет через GET /program, потім надсилайте по одному нарахуванню на автора.
  3. Щодня й після кожної виплати: надсилайте кожному автору нотатку про те, чого він не бачить на suly.gg.
  4. Звірка: зіставляйте GET /accruals зі своїми виплатами за externalId.