Top up your wallet with Stripe, WeChat Pay, or Alipay

Aria Compute wallets are prepaid. To add funds, you start a payment order with your site’s supported provider and complete the flow. The backend credits the wallet once the provider confirms the payment via webhook.

Check which providers are enabled

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

{
  "providers": [
    { "name": "stripe", "enabled": true, "currency": "USD", "region": "intl" }
  ]
}

On the China site you will see wechat and alipay instead of stripe.

Start a payment

Call POST /api/billing/payments with a session Bearer token.

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 returns a redirect_url (Checkout). WeChat Pay and Alipay return a qr_code_url you render as a QR for the payer.

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

Complete the payment

Stripe: open redirect_url and pay with a card.
WeChat Pay / Alipay: scan the QR with the corresponding app on your phone.

Wait for confirmation

The provider calls POST /api/payments/webhook/{provider} and the backend credits your wallet. Poll GET /api/billing/payments/{id} until status becomes paid.

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

Confirm your wallet balance

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

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

Currency is fixed by the site domain: USD on .com, CNY on .cn. You cannot fund a .com wallet in CNY or vice versa.

Next steps

Download the invoice or receipt for the payment.
Check usage with GET /api/billing/usage.

Get Started

Core Concepts

Guides

SDKs

Resources

Top up your wallet with Stripe, WeChat Pay, or Alipay

Next steps

​Next steps

Next steps