Перейти к содержимому

Начисления

Начисление — это платёж одному автору. Сумму определяет ваша система.

Окно терминала
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 Оффер закрыт
Окно терминала
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 }