Top-ups and payments

POST /api/user/stripe/pay

Native access token · POST /api/user/stripe/pay

创建原生 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

Authorizations

Authorizationstringrequired

Use a native login access_token (or a scoped PAT where supported); required access: Native access token.

Authorization: Bearer $ONEASTER_ACCESS_TOKEN

Body · application/json

amountintegerrequired

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

payment_methodstringrequired

支付渠道,固定为 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
}