POST /api/billing/payments — 发起钱包充值

使用受支持的提供方发起一笔钱包充值订单。响应包含一个重定向 URL（Stripe Checkout）或一个二维码 URL（微信支付、支付宝），供付款人完成支付。 方法： POST 路径： /api/billing/payments 认证： 会话 Bearer

请求

string

required

stripe（国际站，美元）、wechat（中国站，人民币）或 alipay（中国站，人民币）。必须已启用：请先检查 GET /api/payments/providers。

number

required

以 currency 主单位计价的充值金额（例如 100 表示 100 元）。

string

required

国际站为 USD，中国站为 CNY。

响应

string

支付标识。

string

所选提供方。

string

初始状态，通常为 pending。

string

Stripe Checkout URL（仅 Stripe）。

string

供微信支付或支付宝渲染的二维码 URL。

string

ISO 8601 过期时间戳。

示例

curl -X POST https://ariacompute.cn/api/billing/payments \
  -H "Authorization: Bearer eyJhbGciOi..." \
  -H "Content-Type: application/json" \
  -d '{"provider": "wechat", "amount": 100, "currency": "CNY"}'

{
  "id": "pay_01H...",
  "provider": "wechat",
  "status": "pending",
  "qr_code_url": "https://pay.weixin.qq.com/...",
  "expires_at": "2026-09-23T11:00:00Z"
}

错误

状态	含义
`400`	缺失字段或不支持的提供方 / 币种组合。
`401`	缺失或无效的会话令牌。
`409`	提供方未启用。

概览

认证

API 密钥

模型

下载

计费

站点

POST /api/billing/payments — 发起钱包充值

请求

响应

示例

错误

​请求

​响应

​示例

​错误

请求

响应

示例

错误