Начисления
Начисление — это платёж одному автору. Сумму определяет ваша система.
POST /accruals
Заголовок раздела «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полностью и может сразу вывести эти деньги. - Начисление нельзя отменить. Проверьте сумму перед отправкой.
Безопасные повторы
Заголовок раздела «Безопасные повторы»externalId делает повтор начисления безопасным:
- Тот же
externalIdс теми же данными возвращает то же начисление и ничего не списывает. - Тот же
externalIdс другими данными завершается ошибкой409 EXTERNAL_ID_CONFLICT.
Выбирайте детерминированный externalId для каждой выплаты в своей системе (например, 2026-10:<participantId>), сохраняйте его до отправки, а после сетевой ошибки, тайм-аута или 503 отправляйте тот же запрос ещё раз.
Когда начисление отклоняется
Заголовок раздела «Когда начисление отклоняется»| Код | Почему |
|---|---|
PARTICIPANT_NOT_ACTIVE |
У автора ещё нет кода или ему отказали: сначала отправьте код |
CREATOR_BANNED |
Автор заблокирован на suly.gg |
INSUFFICIENT_BUDGET |
Бюджет меньше суммы с комиссией: пополните бюджет оффера |
OFFER_ENDED |
Оффер закрыт |
GET /accruals
Заголовок раздела «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 }