充值与支付

POST /api/user/stripe/pay

创建 Stripe 充值订单并获取支付链接

创建原生 Stripe Checkout 会话。使用登录 access_token 或具备 wallet:write 的 PAT,拒绝推理 Key。amount 为整数购买数量,payment_method 固定为 stripe。服务端重新报价并保存预计积分与原价快照。成功返回 message=success、data.pay_link、trade_no 及 preview;业务失败可能仍为 HTTP 200、message=error 且 data 为错误文本,或 success=false,必须检查返回壳。

POST/api/user/stripe/pay

身份验证

Authorizationstring必填

使用登录取得的 native access_token(部分接口支持带对应权限的 PAT);身份要求:登录 access_token。

Authorization: Bearer $ONEASTER_ACCESS_TOKEN

请求正文 · application/json

amountinteger必填

购买数量(整数 quota-USD 单位,1–10000)

payment_methodstring必填

支付渠道,固定为 stripe

success_urlstring

支付成功后跳转的前端地址(可选;必须属于服务器受信任域名列表)

cancel_urlstring

支付取消后跳转的前端地址(可选;必须属于服务器受信任域名列表)

JSON Schema
{
  "type": "object",
  "required": [
    "amount",
    "payment_method"
  ],
  "properties": {
    "amount": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10000,
      "description": "购买数量(整数 quota-USD 单位,1–10000)"
    },
    "payment_method": {
      "type": "string",
      "enum": [
        "stripe"
      ],
      "description": "支付渠道,固定为 stripe"
    },
    "success_url": {
      "type": "string",
      "description": "支付成功后跳转的前端地址(可选;必须属于服务器受信任域名列表)"
    },
    "cancel_url": {
      "type": "string",
      "description": "支付取消后跳转的前端地址(可选;必须属于服务器受信任域名列表)"
    }
  },
  "additionalProperties": false
}