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

# GET /api/billing/payments — 列出钱包充值

> 以游标分页列出钱包充值，并支持按状态过滤。支付归属于当前账户与站点。

按时间倒序列出钱包充值。按状态过滤以查找待处理、已支付、失败或已过期的尝试。

**方法：** `GET` **路径：** `/api/billing/payments` **认证：** 会话 Bearer

## 查询参数

<ParamField query="limit" type="number">
  最大条目数。默认 `50`。
</ParamField>

<ParamField query="cursor" type="string">
  不透明的分页游标。
</ParamField>

<ParamField query="status" type="string">
  `pending`、`paid`、`failed` 或 `expired`。
</ParamField>

## 响应

<ResponseField name="payments" type="object[]">
  <Expandable title="payment">
    <ResponseField name="id" type="string">
      支付标识。
    </ResponseField>

    <ResponseField name="provider" type="string">
      `stripe`、`wechat` 或 `alipay`。
    </ResponseField>

    <ResponseField name="amount" type="number">
      以 `currency` 计价的金额。
    </ResponseField>

    <ResponseField name="currency" type="string">
      `USD` 或 `CNY`。
    </ResponseField>

    <ResponseField name="status" type="string">
      当前状态。
    </ResponseField>

    <ResponseField name="created_at" type="string">
      ISO 8601 时间戳。
    </ResponseField>

    <ResponseField name="paid_at" type="string">
      ISO 8601 时间戳或 `null`。
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="next_cursor" type="string">
  下一页游标或 `null`。
</ResponseField>

## 示例

```bash theme={null}
curl -H "Authorization: Bearer eyJhbGciOi..." \
  "https://ariacompute.cn/api/billing/payments?limit=10&status=paid"
```