POST/api/billing/redeem

使用授权码充值

使用有效的授权码（Authorization Code）为当前账户充值。

Body 参数 (JSON)

参数名	类型	必填	说明
`code`	string	是	需要兑换的授权码。

返回值字段说明

响应数据结构

success

布尔值。true 表示充值成功，false 表示充值失败。

new_balance

账户当前的可用余额总计。

msg

返回充值的结果细节。

常见充值失败原因 (msg)

错误提示 (msg)	原因说明
请输入授权码	请求参数中未提供授权码，或传入了空字符串。
授权码不存在	该授权码未在系统中找到，请检查输入是否正确。
该授权码尚未激活/提取	该授权码（如代理商预生成的卡密）尚未被标记为激活状态，无法使用。
该授权码已被使用	该授权码已被成功兑换过，无法重复使用。
该授权码已作废	该授权码已被管理员标记作废。

注意事项

充值成功后，系统将会自动为您重新激活因余额不足而冻结的关键词。
当授权码不存在、已使用或未激活时，HTTP 响应状态码仍为 200 OK，请务必根据响应体中的 success 布尔字段判断兑换是否成功。

POST

curl -X POST "https://www.fashionbashusa.com/api/billing/redeem" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
  "code": "X7K9P2M4W8N5L3Q1"
}'

成功响应示例

{
  "success": true,
  "msg": "充值成功",
  "new_balance": 150.00
}

失败响应示例

{
  "success": false,
  "msg": "该授权码已被使用",
  "new_balance": 100.00
}