Skip to main content

​
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

{
  "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"
    }
  }
}