Skip to content
AnglinAI Docs

ERR_CREDITS_INSUFFICIENT — Credits Insufficient

HTTP Status: 402 Retryable: No Automatic retry: None. This is a business logic check, not a transient error.

What the User Sees

Insufficient credits for this conversion. (ERR_CREDITS_INSUFFICIENT)

What Causes This Error

The user’s credit balance is lower than the number of pages in the document they are attempting to convert. Credits are checked before conversion starts to avoid wasting AI processing resources on conversions that cannot be completed.

This is normal business logic, not an error condition. The credit check compares the user’s current balance against the estimated cost (typically 1 credit per page). If the balance is insufficient, the conversion is rejected immediately with a clear message.

The credit check accounts for page ranges — if the user specifies a page range (e.g., pages 1-5), only the cost for those specific pages is checked, not the entire document.

Resolution Steps

For Users

  1. Purchase more credits from the Credits page. Multiple credit packages are available at different price points.
  2. Alternatively, use page ranges to convert fewer pages at a time, staying within your current credit balance.
  3. Check your current credit balance on the Credits page or in the account dropdown.
  4. If you believe your credit balance is incorrect, contact support.

For Administrators

  1. No action is needed for this error — it is working as designed.
  2. To grant credits manually to a specific user: navigate to Admin > Users > select the user > Grant Credits.
  3. Credits can also be granted programmatically via the API: POST /api/admin/credits/grant with the user ID and credit amount.
  4. To adjust credit pricing or package sizes, update the credit_packages table in Supabase. Ensure corresponding Stripe price IDs are valid.
  5. If multiple users are reporting this error unexpectedly, verify that the credit deduction amounts are correct and that a recent code change did not inflate the per-page cost.