提交售后申请

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

订阅失效、开通的套餐不对或卡密无法使用时,可在交付后 7 天内提交。必须提供截图;订阅类订单还须提供客户账号邮箱。

处理方案由我们决定:换用新卡密重新开通,或退款至余额。处理结果通过 Webhook 事件 order.updated(订单中的 warranty.claim_status)推送,也可通过 GET /v1/claims/{claim_id} 查询。

参数

order_id
路径 · uuid · 必填

订单号,来自 POST /v1/orders 的响应或订单列表。

请求体

application/json
problem
string · 必填

出现了什么问题:

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

期望的处理方式:

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

activation、key 和 account 可以重新开通;card_payment 和 new_account 只能退款。

account_email
string | null

客户账号邮箱:订阅类订单(activation、card_payment)必填,我们据此核对截图。

comment
string | null

其他需要说明的情况,不超过 1000 个字符。

screenshot_base64
string · 必填

客户账号中套餐页面的截图(或卡密报错的画面),PNG、JPEG 或 WebP 格式,不超过 10 MB,使用 base64 编码。没有截图的申请不予受理。

响应

claim_id
string

申请编号。

order_id
string

该申请对应的订单。

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/orders/$ORDER_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",
  "status": "open",
  "problem": "not_working",
  "wish": "restart",
  "refuse_reason": null,
  "account_email": "client@example.com",
  "comment": "昨天还是 Plus,今天变回 Free 了",
  "created_at": "2026-10-08T09:41:27Z",
  "decided_at": null,
  "warranty_until": "2026-10-12T10:20:44Z"
}