API 参考质保

提交售后申请

POSThttps://api.astrum.shop/v1/keys/{key_id}/claims
权限范围 keys:write

订阅丢失或套餐不对时，请在激活码激活后 7 天内提交。截图为必填项。

处理方案由我们决定：重新开通，或把激活码的价格退回余额。处理结果见 GET /v1/claims/{claim_id}；如退回价格，还会推送 key.refunded 事件。

参数

key_id
路径 · uuid · 必填

激活码编号，来自 POST /v1/keys 的响应或列表。

请求体

application/json
problem
string · 必填

出现了什么问题：

not_working
没有订阅或卡密无法使用
wrong_plan
开通的套餐不对
other
其他问题，请在 comment 中说明
wish
string · 必填

希望如何处理：

restart
重新开通：换用新卡密，优先选用其他供应商
refund
退款至余额

activation 支持重新开通；card_payment 只能把激活码的价格退回余额。

account_email
string | null

客户账号邮箱——必填：我们据此核对截图。

comment
string | null
screenshot_base64
string · 必填

问题截图：base64 编码的 PNG、JPEG 或 WebP，不超过 10 MB。

响应

claim_id
string

申请编号。

order_id
string

该申请对应的开通尝试的内部编号；激活码本身见 key_id。

key_id
string | null

该申请对应的激活码；null 表示针对 API 订单的旧申请（2026-10-15 之前）。

status
string

申请状态：

open
待回复
restarted
重新开通：已换用新卡密；客户可能需要重新提交信息
refunded
已退款：款项已退回余额
refused
已驳回，原因见 refuse_reason
problem
string

出现了什么问题：

not_working
没有订阅或卡密无法使用
wrong_plan
开通的套餐不对
other
其他问题，请在 comment 中说明
wish
string

申请时期望的处理方式：

restart
重新开通：换用新卡密，优先选用其他供应商
refund
退款至余额
refuse_reason
string | null

驳回原因；未驳回时为 null：

account_banned
客户账号已被封禁，不在质保范围内
plan_present
订阅仍然有效
wrong_screenshot
截图内容不符
window_closed
质保期已过
account_email
string | null

申请中的客户账号邮箱；处理完成 90 天后删除。

comment
string | null

您的备注。

created_at
string

提交时间（UTC）。

decided_at
string | null

处理时间（UTC）；null 表示仍在等待处理。

warranty_until
string | null

提交申请时质保的截止时间。

所有接口通用的错误，详见「错误码」章节：

10001 invalid_key10002 key_scope_missing10003 ip_not_allowed10004 browser_not_allowed10005 account_suspended20001 too_many_requests90002 api_disabled90001 internal_error
测试 USDT，
密钥 ask_test_…
curl https://api.astrum.shop/v1/keys/$KEY_ID/claims -X POST \
  -H "Authorization: Bearer $ASTRUM_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "problem": "not_working",
    "wish": "restart",
    "account_email": "client@example.com",
    "comment": "昨天还是 Plus，今天变回 Free 了",
    "screenshot_base64": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg=="
  }'
响应
{
  "claim_id": "5c2e9a41-7d3b-4e8f-a1c6-2b9d0e4f7a13",
  "order_id": "b1e04c6e-5a0b-4f6e-9a39-0b9f2f1c8d21",
  "key_id": "9b2f6c1e-4d7a-4b0e-8f3c-1a5d2e7c9b40",
  "status": "open",
  "problem": "not_working",
  "wish": "restart",
  "refuse_reason": null,
  "account_email": "client@example.com",
  "comment": "昨天还是 Plus，今天变回 Free 了",
  "created_at": "2026-10-16T09:41:27Z",
  "decided_at": null,
  "warranty_until": "2026-10-21T10:32:40Z"
}