> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ariacompute.com/llms.txt
> Use this file to discover all available pages before exploring further.

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

> Start a wallet top-up on the international or China site, complete the payment flow, and confirm the credit landed in your Aria Compute wallet.

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.

<Steps>
  <Step title="Check which providers are enabled">
    ```bash theme={null}
    curl https://ariacompute.com/api/payments/providers
    ```

    ```json theme={null}
    {
      "providers": [
        { "name": "stripe", "enabled": true, "currency": "USD", "region": "intl" }
      ]
    }
    ```

    On the China site you will see `wechat` and `alipay` instead of `stripe`.
  </Step>

  <Step title="Start a payment">
    Call `POST /api/billing/payments` with a session Bearer token.

    <CodeGroup>
      ```bash Stripe (USD) theme={null}
      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"}'
      ```

      ```bash WeChat Pay (CNY) theme={null}
      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"}'
      ```

      ```bash Alipay (CNY) theme={null}
      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"}'
      ```
    </CodeGroup>

    Stripe returns a `redirect_url` (Checkout). WeChat Pay and Alipay return a `qr_code_url` you render as a QR for the payer.

    ```json theme={null}
    {
      "id": "pay_01H...",
      "provider": "stripe",
      "status": "pending",
      "redirect_url": "https://checkout.stripe.com/...",
      "expires_at": "2026-09-23T11:00:00Z"
    }
    ```
  </Step>

  <Step title="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.
  </Step>

  <Step title="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`.

    ```bash theme={null}
    curl -H "Authorization: Bearer eyJhbGciOi..." \
      https://ariacompute.com/api/billing/payments/pay_01H...
    ```
  </Step>

  <Step title="Confirm your wallet balance">
    ```bash theme={null}
    curl -H "Authorization: Bearer eyJhbGciOi..." \
      https://ariacompute.com/api/billing/wallet
    ```

    ```json theme={null}
    { "balance": 20.00, "currency": "USD", "updated_at": "2026-09-23T10:03:12Z" }
    ```
  </Step>
</Steps>

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

## Next steps

* [Download the invoice or receipt](/guides/invoices-receipts) for the payment.
* Check usage with [`GET /api/billing/usage`](/api-reference/billing/usage).


## Related topics

- [POST /api/billing/payments — start a wallet top-up](/api-reference/billing/payments-create.md)
- [Prepaid wallet, top-ups, and usage billing](/concepts/wallet-billing.md)
- [Download invoices and receipts for your payments](/guides/invoices-receipts.md)
- [Aria Compute Documentation](/index.md)
- [International and China sites, and how to choose](/concepts/sites-regions.md)