Przejdź do głównej zawartości

Naliczenia

Naliczenie to płatność dla jednego twórcy. O kwocie decyduje Twój system.

Okno terminala
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 + fee schodzi z budżetu oferty.
  • Twórca otrzymuje amount w całości i może od razu wypłacić te pieniądze.
  • Naliczenia nie można cofnąć. Sprawdź kwotę, zanim je prześlesz.

Dzięki externalId naliczenie można bezpiecznie powtórzyć:

  • Ten sam externalId z tymi samymi danymi zwraca to samo naliczenie i niczego nie pobiera.
  • Ten sam externalId z innymi danymi kończy się błędem 409 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.

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
Okno terminala
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 }