POST /api/billing/payments — start a wallet top-up

Create a wallet top-up order with a supported provider. Response includes a redirect URL (Stripe Checkout) or a QR code URL (WeChat Pay, Alipay) that the payer uses to complete the payment. Method: POST Path: /api/billing/payments Auth: Session Bearer

Request

string

required

stripe (international, USD), wechat (China, CNY), or alipay (China, CNY). Must be enabled: check GET /api/payments/providers.

number

required

Top-up amount in major units of currency (for example 20 for $20).

string

required

USD on the international site, CNY on the China site.

Response

string

Payment identifier.

string

Selected provider.

string

Initial status, typically pending.

string

Stripe Checkout URL (Stripe only).

string

QR code URL to render for WeChat Pay or Alipay.

string

ISO 8601 expiry timestamp.

Example

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

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

Errors

Status	Meaning
`400`	Missing field or unsupported provider/currency combination.
`401`	Missing or invalid session token.
`409`	Provider not enabled.

Overview

Authentication

API Keys

Models

Downloads

Billing

Site

POST /api/billing/payments — start a wallet top-up

Request

Response

Example

Errors

​Request

​Response

​Example

​Errors

Request

Response

Example

Errors