Naliczenia
Naliczenie to płatność dla jednego twórcy. O kwocie decyduje Twój system.
POST /accruals
Dział zatytułowany „POST /accruals”curl -s https://suly.gg/api/partner/v1/accruals \ -H "Authorization: Bearer $SULY_KEY" \ -H 'Content-Type: application/json' \ -d '{"participantId":"…","amount":"125.40","externalId":"2026-10-ANDRY","comment":"October 2026"}'| Pole | Zasady |
|---|---|
participantId |
Uczestnik oferty ze statusem active |
amount |
Od 0.01 do 1000000, ciąg znaków w dolarach amerykańskich |
externalId |
Twój własny numer operacji: 1–100 znaków z zestawu A–Z a–z 0–9 . _ : -, unikalny w ramach oferty |
comment |
Opcjonalny, do 200 znaków. Widzi go twórca |
{ "accrualId": "…", "participantId": "…", "creatorName": "Andry", "externalId": "2026-10-ANDRY", "amount": "125.400000", "fee": "12.540000", "charged": "137.940000", "comment": "October 2026", "createdAt": "2026-11-03T10:00:00.000Z"}charged=amount+feeschodzi z budżetu oferty.- Twórca otrzymuje
amountw całości i może od razu wypłacić te pieniądze. - Naliczenia nie można cofnąć. Sprawdź kwotę, zanim je prześlesz.
Bezpieczne powtórzenia
Dział zatytułowany „Bezpieczne powtórzenia”Dzięki externalId naliczenie można bezpiecznie powtórzyć:
- Ten sam
externalIdz tymi samymi danymi zwraca to samo naliczenie i niczego nie pobiera. - Ten sam
externalIdz innymi danymi kończy się błędem409 EXTERNAL_ID_CONFLICT.
Wybierz deterministyczny externalId dla każdej wypłaty w swoim systemie (na przykład 2026-10:<participantId>), zapisz go przed wysłaniem, a po błędzie sieci, przekroczeniu limitu czasu lub 503 wyślij to samo żądanie jeszcze raz.
Kiedy naliczenie jest odrzucane
Dział zatytułowany „Kiedy naliczenie jest odrzucane”| Kod | Dlaczego |
|---|---|
PARTICIPANT_NOT_ACTIVE |
Twórca nie ma jeszcze kodu albo mu odmówiono: najpierw prześlij kod |
CREATOR_BANNED |
Twórca jest zablokowany w suly.gg |
INSUFFICIENT_BUDGET |
Budżet jest mniejszy niż kwota plus prowizja: doładuj budżet oferty |
OFFER_ENDED |
Oferta jest zamknięta |
GET /accruals
Dział zatytułowany „GET /accruals”curl -s "https://suly.gg/api/partner/v1/accruals?page=1" \ -H "Authorization: Bearer $SULY_KEY"Naliczenia, po 50 na stronę, od najnowszych, każde w formacie podanym wyżej. Dodaj participantId=…, aby odczytać naliczenia jednego twórcy.
{ "accruals": [], "total": 0, "page": 1, "pageSize": 50 }