钱包购买订阅
POST /api/subscription/wallet/pay
使用钱包额度购买指定订阅套餐。需提供幂等键以避免重复扣费。
鉴权说明
用户控制台接口,需登录用户身份(会话 Cookie,或 Authorization: Bearer <access_token>)。此令牌与模型调用使用的 sk- 密钥不同。
请求体参数
| 参数名 | 类型 | 必选 | 说明 |
|---|---|---|---|
plan_id | integer | 必选 | 订阅套餐 ID,必须大于 0 |
idempotency_key | string | 必选 | 幂等键,防止重复扣费 |
请求示例
{
"plan_id": 1,
"idempotency_key": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}
响应字段(200)
| 字段名 | 类型 | 说明 |
|---|---|---|
success | boolean | 是否成功 |
message | string | 提示信息 |
data | object | 购买结果(订阅详情) |
相关订阅支付接口
- 免费套餐领取:
POST /api/subscription/free/pay,请求体{ "plan_id": <整数> } - 钱包续费:
POST /api/subscription/wallet/renew,请求体{ "subscription_id": <整数>, "idempotency_key": <字符串> } - 支付宝充值(属于充值模块,非订阅):
POST /api/user/alipay/pay