入账
一笔入账就是向一位创作者的一次付款。金额由你的系统决定。
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,并可立即提现。 - 入账无法撤销。发送前请核对金额。
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 }