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

# GET /api/billing/payments/{id} — get payment status

> Poll a single top-up payment for status: pending, paid, failed, or expired. Includes provider reference and paid timestamp when available.

Poll a single top-up payment for its current status. Use this after `POST /api/billing/payments` to detect when the wallet has been credited.

**Method:** `GET` **Path:** `/api/billing/payments/{id}` **Auth:** Session Bearer

## Path parameters

<ParamField path="id" type="string" required>
  Payment identifier from `POST /api/billing/payments`.
</ParamField>

## Response

<ResponseField name="id" type="string">
  Payment identifier.
</ResponseField>

<ResponseField name="provider" type="string">
  `stripe`, `wechat`, or `alipay`.
</ResponseField>

<ResponseField name="amount" type="number">
  Amount in `currency`.
</ResponseField>

<ResponseField name="currency" type="string">
  `USD` or `CNY`.
</ResponseField>

<ResponseField name="status" type="string">
  `pending`, `paid`, `failed`, or `expired`.
</ResponseField>

<ResponseField name="paid_at" type="string">
  ISO 8601 timestamp or `null`.
</ResponseField>

<ResponseField name="provider_reference" type="string">
  Provider transaction ID, if available.
</ResponseField>

## Example

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

```json theme={null}
{
  "id": "pay_01H...",
  "provider": "stripe",
  "amount": 20,
  "currency": "USD",
  "status": "paid",
  "paid_at": "2026-09-23T10:03:12Z",
  "provider_reference": "pi_3Nx..."
}
```

## Errors

| Status | Meaning                              |
| ------ | ------------------------------------ |
| `401`  | Missing or invalid session token.    |
| `404`  | Unknown payment ID for this account. |


## Related topics

- [GET /api/billing/payments — list wallet top-ups](/api-reference/billing/payments-list.md)
- [GET /api/billing/invoices/{paymentId}/download — download invoice](/api-reference/billing/invoice-download.md)
- [GET /api/billing/receipts/{paymentId}/download — download Stripe receipt](/api-reference/billing/receipt-download.md)
- [GET /api/payments/providers — enabled payment channels](/api-reference/site/payment-providers.md)
- [Prepaid wallet, top-ups, and usage billing](/concepts/wallet-billing.md)