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

# Wallet has insufficient credit (INSUFFICIENT_CREDIT)

> A pay-per-use tool needs wallet credit that the workspace does not currently have.

## What it means

Some Aeris tools are metered against a prepaid wallet rather than a monthly plan (for example, paid audit runs or campaign proposals that touch a partner API with per-call cost). If the wallet cannot cover the cost, Aeris refuses to run the tool instead of overdrafting.

`details.topup_url` links to the top-up flow.

## How to fix

* Surface `details.topup_url` to the user.
* After they add credit, retry the tool call.
* If auto-refill is available on the plan, encourage the user to enable it to prevent this on the next hit.

## Response envelope

```json theme={"dark"}
{
  "ok": false,
  "error_envelope": {
    "code": "INSUFFICIENT_CREDIT",
    "message": "Insufficient wallet credit for this action.",
    "docs_url": "https://tryaeris.ai/docs/mcp/errors/insufficient-credit",
    "retryable": false,
    "retry_after_ms": null,
    "details": {
      "topup_url": "https://tryaeris.ai/settings/billing/wallet"
    }
  }
}
```

## Related

* [`ENTITLEMENT_LOCKED`](/mcp/errors/entitlement-locked) — not a wallet problem; the plan itself excludes the tool.