← Troubleshooting

How to fix trial_exhausted (HTTP 402)

The trial credit balance on this account is zero.

What the API returns

{
  "error": {
    "code": "trial_exhausted",
    "message": "your free trial credits are exhausted — add a payment method to continue",
    "request_id": "770372810e5f2a70"
  }
}

Why it happens

• The trial credits were used; the account has no paid plan or wallet balance yet.

How to fix it

1. Dashboard → Billing → add a payment method and choose a plan, or add pay-as-you-go wallet credits.
2. Until then the free monthly allowance still applies if you are on the free plan; check Dashboard → Usage.

Should your code retry?

Not automatically. Retrying will return the same error until credits are available; surface it to whoever manages the account.

See all codes on the troubleshooting index and the error envelope on Errors. Still stuck? Email [email protected] with the request_id.