Szybki start
1. Utwórz ofertę
Dział zatytułowany „1. Utwórz ofertę”W panelu marki otwórz Oferty → Utwórz ofertę, w bloku „Jak płacisz twórcom?” wybierz RevShare, wypełnij formularz i wyślij go do moderacji. Budżet przechodzi z Twojego salda do oferty. Wszystkie pola opisuje strona Oferta RevShare.
2. Utwórz klucz API
Dział zatytułowany „2. Utwórz klucz API”Gdy oferta zostanie zatwierdzona, otwórz stronę oferty i utwórz klucz w bloku Klucz API. Klucz jest pokazywany tylko raz: skopiuj go do swojego magazynu sekretów. Każda oferta ma własny klucz.
export SULY_KEY='suly_…'3. Sprawdź połączenie
Dział zatytułowany „3. Sprawdź połączenie”curl -s https://suly.gg/api/partner/v1/program \ -H "Authorization: Bearer $SULY_KEY"Dostajesz ofertę z jej statusem, budżetem i aktualną prowizją.
4. Wydaj twórcom kody
Dział zatytułowany „4. Wydaj twórcom kody”Odczytaj twórców, którzy czekają na kod:
curl -s "https://suly.gg/api/partner/v1/participants?status=pending" \ -H "Authorization: Bearer $SULY_KEY"Dla każdego utwórz w swoim systemie kod polecający i link, a potem je prześlij:
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"}'Twórca od razu widzi kod i link.
5. Zapłać
Dział zatytułowany „5. Zapłać”Gdy Twój system wyliczy, ile zarobił twórca, prześlij naliczenie z własnym numerem operacji:
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"}'Ponowne wysłanie tego samego żądania z tym samym externalId niczego nie opłaca dwa razy, więc można je bezpiecznie powtórzyć po przekroczeniu limitu czasu.
Typowa integracja
Dział zatytułowany „Typowa integracja”- Co 5–15 minut: odczytuj uczestników ze statusem
pendingi wydawaj każdemu kod i link (albo odmawiaj). - Według swojego harmonogramu wypłat: sprawdź budżet przez
GET /program, a potem prześlij po jednym naliczeniu na twórcę. - Codziennie i po każdej wypłacie: przesyłaj każdemu twórcy notatkę z tym, czego nie widzi w suly.gg.
- Uzgadnianie: dopasuj
GET /accrualsdo własnych wypłat poexternalId.