Быстрый старт
1. Создайте оффер
Заголовок раздела «1. Создайте оффер»В кабинете заказчика откройте Офферы → Создать оффер, в блоке «Как платите авторам?» выберите Рефшара, заполните форму и отправьте её на модерацию. Бюджет переходит с вашего баланса в оффер. Все поля описаны на странице Оффер с рефшарой.
2. Создайте ключ API
Заголовок раздела «2. Создайте ключ API»Когда оффер одобрен, откройте страницу оффера и создайте ключ в блоке Ключ API. Ключ показывается только один раз: скопируйте его в своё хранилище секретов. У каждого оффера свой ключ.
export SULY_KEY='suly_…'3. Проверьте подключение
Заголовок раздела «3. Проверьте подключение»curl -s https://suly.gg/api/partner/v1/program \ -H "Authorization: Bearer $SULY_KEY"Вы получите оффер с его статусом, бюджетом и текущей комиссией.
4. Выдайте авторам коды
Заголовок раздела «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. Заплатите
Заголовок раздела «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 ничего не оплачивает дважды, поэтому его безопасно повторять после тайм-аута.
Типичная интеграция
Заголовок раздела «Типичная интеграция»- Каждые 5–15 минут: читайте участников со статусом
pendingи выдавайте каждому код и ссылку (или отказывайте). - По вашему графику выплат: проверяйте бюджет через
GET /program, затем отправляйте по одному начислению на автора. - Ежедневно и после каждой выплаты: отправляйте каждому автору заметку о том, чего он не видит на suly.gg.
- Сверка: сопоставляйте
GET /accrualsсо своими выплатами поexternalId.