Нарахування
Нарахування — це платіж одному автору. Суму визначає ваша система.
POST /accruals
Section titled “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"}'| Поле | Правила |
|---|---|
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повністю й може одразу вивести ці гроші. - Нарахування не можна скасувати. Перевірте суму перед надсиланням.
Безпечні повтори
Section titled “Безпечні повтори”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 |
Офер закрито |
GET /accruals
Section titled “GET /accruals”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 }