使用 Stripe、微信支付或支付宝为钱包充值

咏唱引擎钱包为预付费模式。要增加余额，你需要用站点支持的提供方发起一笔支付订单并完成流程。提供方通过 webhook 确认付款后，后端会为钱包入账。

查看已启用的提供方

curl https://ariacompute.cn/api/payments/providers

{
  "providers": [
    { "name": "wechat", "enabled": true, "currency": "CNY", "region": "cn" }
  ]
}

在中国站你会看到 wechat 与 alipay，而非 stripe。

发起支付

使用会话 Bearer 令牌调用 POST /api/billing/payments。

curl -X POST https://ariacompute.com/api/billing/payments \
  -H "Authorization: Bearer eyJhbGciOi..." \
  -H "Content-Type: application/json" \
  -d '{"provider": "stripe", "amount": 20, "currency": "USD"}'

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"}'

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

Stripe 返回 redirect_url（结账页）。微信支付与支付宝返回一个 qr_code_url，你需将其渲染为二维码供付款人扫码。

{
  "id": "pay_01H...",
  "provider": "stripe",
  "status": "pending",
  "redirect_url": "https://checkout.stripe.com/...",
  "expires_at": "2026-09-23T11:00:00Z"
}

完成支付

Stripe：打开 redirect_url 并用银行卡付款。
微信支付 / 支付宝：用手机上对应的 App 扫描二维码。

等待确认

提供方调用 POST /api/payments/webhook/{provider}，后端为你的钱包入账。轮询 GET /api/billing/payments/{id} 直到 status 变为 paid。

curl -H "Authorization: Bearer eyJhbGciOi..." \
  https://ariacompute.cn/api/billing/payments/pay_01H...

确认钱包余额

curl -H "Authorization: Bearer eyJhbGciOi..." \
  https://ariacompute.cn/api/billing/wallet

{ "balance": 100.00, "currency": "CNY", "updated_at": "2026-09-23T10:03:12Z" }

币种由站点域名固定：.com 为美元，.cn 为人民币。你无法用人民币为 .com 钱包充值，反之亦然。

下一步

下载付款的发票或收据。
使用 GET /api/billing/usage 查看用量。

快速开始

核心概念

指南

SDK

资源

使用 Stripe、微信支付或支付宝为钱包充值

下一步

​下一步

下一步