跳转到内容

入账

一笔入账就是向一位创作者的一次付款。金额由你的系统决定。

终端窗口
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 }