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

# 预付费钱包、充值与用量计费

> 每个咏唱引擎账户持有一个预付费钱包。了解国际站与中国站之间的充值、币种、发票与收据机制。

每个咏唱引擎账户都持有一个预付费钱包。你通过受支持的支付提供方为其充值，计量用量从余额中扣减。钱包币种由站点域名固定，与你所浏览的界面语言无关。

## 币种

| 站点                | 币种     | 提供方                             |
| ----------------- | ------ | ------------------------------- |
| `ariacompute.com` | 美元（\$） | Stripe                          |
| `ariacompute.cn`  | 人民币（¥） | 微信支付 APIv3 Native 二维码、支付宝当面付预创建 |

即使你以英文浏览中国站，价格仍为人民币。两个站点的钱包互不共享：各自拥有独立的余额、交易与发票。

## 充值流程

1. 客户端从 `GET /api/payments/providers` 获取可用提供方。
2. 通过 `POST /api/billing/payments` 发起充值，获得 Stripe 结账 URL、微信支付二维码或支付宝二维码。
3. 你在提供方的流程中完成支付。
4. 提供方通过 webhook 调用 `POST /api/payments/webhook/{provider}`，后端为钱包入账。
5. 你可轮询 `GET /api/billing/payments/{id}` 查询状态。

提供方在凭证配置完成前处于禁用状态。使用 `GET /api/payments/providers` 查看当前环境中哪些提供方已生效。

## 用量

用量按计量上报，通过 `GET /api/billing/usage` 查询。每次模型调用、模型下载与 GPU 小时，均依据 `GET /api/pricing` 公布的费率计价，并从你的钱包扣减。你可通过 `GET /api/billing/transactions` 查看产生的交易。

## 发票与收据

每笔已支付款项都可生成一份可供下载与存档的凭证。

* **中国站（`ariacompute.cn`）**：微信支付与支付宝付款可开具电子发票（电子发票）。通过 `POST /api/billing/invoices` 申请，并从 `GET /api/billing/invoices/{paymentId}/download` 下载。每笔付款对应一张发票，幂等。
* **国际站（`ariacompute.com`）**：Stripe 付款提供收据，可从 `GET /api/billing/receipts/{paymentId}/download` 获取。

两个下载接口均接受通过 `Authorization: Bearer` 或 `?token=` 查询参数传递的会话令牌，以便浏览器链接直接可用。

## 相关

* [为钱包充值](/guides/top-up-wallet)
* [发票与收据](/guides/invoices-receipts)
* [GET /api/billing/wallet](/api-reference/billing/wallet)
* [定价](/resources/pricing)