Перейти к содержимому

Быстрый старт

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

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

Окно терминала
export SULY_KEY='suly_…'
Окно терминала
curl -s https://suly.gg/api/partner/v1/program \
-H "Authorization: Bearer $SULY_KEY"

Вы получите оффер с его статусом, бюджетом и текущей комиссией.

Прочитайте авторов, которые ждут код:

Окно терминала
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"}'

Автор сразу видит код и ссылку.

Когда ваша система рассчитала, сколько заработал автор, отправьте начисление с собственным номером операции:

Окно терминала
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.