API 参考质保
提交售后申请
POSThttps://api.astrum.shop/v1/orders/{order_id}/claims
权限范围 orders:write
订阅失效、开通的套餐不对或卡密无法使用时,可在交付后 7 天内提交。必须提供截图;订阅类订单还须提供客户账号邮箱。
处理方案由我们决定:换用新卡密重新开通,或退款至余额。处理结果通过 Webhook 事件 order.updated(订单中的 warranty.claim_status)推送,也可通过 GET /v1/claims/ 查询。
参数
order_id
路径 · uuid · 必填
订单号,来自 POST /v1/orders 的响应或订单列表。
请求体
application/jsonproblem
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
