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

# Crypto top-ups

> Fund your balance privately with crypto.

Add credit to your account with cryptocurrency. Payments are final (no
chargebacks), confirmations are fast, and there's no card or subscription.

Your balance is held in **USDT**, a dollar-pegged stablecoin. Whatever you fund
with is converted to USDT at the confirmed rate, so your balance holds a steady
value.

## Supported methods

| Method   | `method` value | Notes                                                   |
| -------- | -------------- | ------------------------------------------------------- |
| USDT     | `usdt`         | Held as-is. No conversion, lowest minimum. Recommended. |
| Bitcoin  | `btc`          | Converted to USDT on confirmation.                      |
| Ethereum | `eth`          | Converted to USDT on confirmation.                      |
| Solana   | `sol`          | Fast and low fee, converted to USDT.                    |

## Create a top-up

```bash theme={null}
curl https://api.heyaskr.ai/topup/create/usdt \
  -H "Authorization: Bearer ASKR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "amount": 10, "currency": "USD" }'
```

The response contains an address to pay (or a payment URI) and an `invoice_id`.

## Check the status

```bash theme={null}
curl https://api.heyaskr.ai/topup/status/INVOICE_ID \
  -H "Authorization: Bearer ASKR_API_KEY"
```

Poll until the status is `paid`. Your balance updates automatically once the
payment confirms.

<Steps>
  <Step title="Create the invoice">Call `topup/create/{method}` with an amount.</Step>
  <Step title="Show it to the user">Render the address or payment URI as a QR code.</Step>
  <Step title="Poll the status">Check `topup/status/{id}` until it's paid.</Step>
  <Step title="Balance updates">Credit is added in USDT; the user can start spending.</Step>
</Steps>

<Note>
  Fund with BTC, ETH or SOL and it's converted to USDT at the confirmed exchange
  rate, so your balance holds a stable dollar-pegged value.
</Note>