Перейти до вмісту

Нарахування

Нарахування — це платіж одному автору. Суму визначає ваша система.

Terminal window
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"}'
Поле Правила
participantId Учасник офера зі статусом active
amount Від 0.01 до 1000000, рядок у доларах США
externalId Ваш власний номер операції: 1–100 символів із A–Z a–z 0–9 . _ : -, унікальний у межах офера
comment Необов’язково, до 200 символів. Його бачить автор
{
"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 списується з бюджету офера.
  • Автор отримує amount повністю й може одразу вивести ці гроші.
  • Нарахування не можна скасувати. Перевірте суму перед надсиланням.

externalId робить повтор нарахування безпечним:

  • Той самий externalId із тими самими даними повертає те саме нарахування й нічого не списує.
  • Той самий externalId з іншими даними завершується помилкою 409 EXTERNAL_ID_CONFLICT.

Обирайте детермінований externalId для кожної виплати у своїй системі (наприклад, 2026-10:<participantId>), зберігайте його до надсилання, а після мережевої помилки, тайм-ауту або 503 надсилайте той самий запит ще раз.

Коли нарахування відхиляється

Section titled “Коли нарахування відхиляється”
Код Чому
PARTICIPANT_NOT_ACTIVE Автор ще не має коду або йому відмовили: спершу надішліть код
CREATOR_BANNED Автора заблоковано на suly.gg
INSUFFICIENT_BUDGET Бюджет менший за суму з комісією: поповніть бюджет офера
OFFER_ENDED Офер закрито
Terminal window
curl -s "https://suly.gg/api/partner/v1/accruals?page=1" \
-H "Authorization: Bearer $SULY_KEY"

Нарахування, по 50 на сторінку, спершу нові, кожне у форматі вище. Додайте participantId=…, щоб прочитати нарахування одного автора.

{ "accruals": [], "total": 0, "page": 1, "pageSize": 50 }