Skip to content

ERR_STRIPE_ERROR β€” Stripe Error

HTTP Status: 502 Retryable: Yes Automatic retry: None. Stripe API calls are not automatically retried to avoid duplicate charges.

What the User Sees

Payment processing service encountered an error. (ERR_STRIPE_ERROR)

What Causes This Error

A Stripe API call failed during checkout session creation, credit package lookup, or other payment operations. This is a general Stripe error that covers infrastructure failures, configuration issues, and unexpected API responses.

Common causes include: Stripe platform outage (check https://status.stripe.com), invalid STRIPE_SECRET_KEY, invalid Stripe price IDs that do not match the credit_packages table, or account-level configuration issues such as a disabled or restricted Stripe account.

This error does NOT include webhook signature failures (see ERR_STRIPE_INVALID_SIGNATURE) or user-side payment failures (declined cards, insufficient funds), which are handled separately by Stripe’s checkout flow.

Resolution Steps

For Users

  1. Try again in a few minutes. The payment service may be experiencing temporary issues.
  2. If purchasing credits, verify your payment method is valid by checking it in your Stripe-connected payment portal.
  3. If the error persists, contact support with the approximate time of the error.

For Administrators

  1. Check https://status.stripe.com for any ongoing Stripe incidents.
  2. Verify the STRIPE_SECRET_KEY Worker secret is valid and matches the key in the Stripe Dashboard > Developers > API Keys.
  3. Check that the credit package Stripe price IDs in the credit_packages database table match actual price IDs in the Stripe Dashboard > Products.
  4. Review the Stripe Dashboard > Developers > Logs for the specific failed API call and error details.
  5. Test Stripe connectivity:
    Terminal window
    curl https://api.stripe.com/v1/prices \
    -u "$STRIPE_SECRET_KEY:" \
    -G -d limit=1
  6. If the Stripe account was recently created or changed, verify it is fully activated and not in restricted mode.