> ## 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.

# 下载付款的发票与收据

> 中国站为微信支付 / 支付宝订单开具电子发票，国际站提供 Stripe 收据：如何申请、下载并将其用于记账。

每一笔已支付的咏唱引擎充值都可生成一份可下载凭证。中国站为微信支付与支付宝订单开具电子发票（电子发票）。国际站提供 Stripe 收据。

## 中国站：电子发票（电子发票）

<Steps>
  <Step title="为已支付款项申请发票">
    ```bash theme={null}
    curl -X POST https://ariacompute.cn/api/billing/invoices \
      -H "Authorization: Bearer eyJhbGciOi..." \
      -H "Content-Type: application/json" \
      -d '{
        "payment_id": "pay_01H...",
        "title": "北京某某科技有限公司",
        "tax_id": "91110000..."
      }'
    ```

    ```json theme={null}
    {
      "id": "inv_01H...",
      "payment_id": "pay_01H...",
      "title": "北京某某科技有限公司",
      "tax_id": "91110000...",
      "amount": 100,
      "currency": "CNY",
      "status": "issued"
    }
    ```

    发票按 `payment_id` 幂等：重复请求返回同一张发票。
  </Step>

  <Step title="下载发票">
    下载接口接受会话令牌作为查询参数，因此普通的浏览器链接即可生效。

    ```bash theme={null}
    curl -L "https://ariacompute.cn/api/billing/invoices/pay_01H.../download?token=eyJhbGciOi..." \
      -o invoice.pdf
    ```

    如果你从服务端调用，也可以使用 `Authorization: Bearer`：

    ```bash theme={null}
    curl -L -H "Authorization: Bearer eyJhbGciOi..." \
      https://ariacompute.cn/api/billing/invoices/pay_01H.../download \
      -o invoice.pdf
    ```
  </Step>
</Steps>

## 国际站：Stripe 收据

Stripe 付款无需单独请求：付款状态变为 `paid` 后收据会自动生成。

```bash theme={null}
curl -L "https://ariacompute.com/api/billing/receipts/pay_01H.../download?token=eyJhbGciOi..." \
  -o receipt.html
```

或使用 Bearer Header：

```bash theme={null}
curl -L -H "Authorization: Bearer eyJhbGciOi..." \
  https://ariacompute.com/api/billing/receipts/pay_01H.../download \
  -o receipt.html
```

## 何时使用哪一种

| 站点                | 提供方      | 凭证   |
| ----------------- | -------- | ---- |
| `ariacompute.com` | Stripe   | 收据   |
| `ariacompute.cn`  | 微信支付、支付宝 | 电子发票 |

<Note>
  `?token=` 即你在 `Authorization: Bearer` 中发送的同一个 JWT。它存在的目的，是让普通的 `<a href>` 链接无需设置 Header 即可下载文件。
</Note>

## 相关

* [为钱包充值](/guides/top-up-wallet)
* [POST /api/billing/invoices](/api-reference/billing/invoices)
* [GET /api/billing/receipts/](/api-reference/billing/receipt-download){paymentId}[/download](/api-reference/billing/receipt-download)