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
- Try again in a few minutes. The payment service may be experiencing temporary issues.
- If purchasing credits, verify your payment method is valid by checking it in your Stripe-connected payment portal.
- If the error persists, contact support with the approximate time of the error.
For Administrators
- Check https://status.stripe.com for any ongoing Stripe incidents.
- Verify the STRIPE_SECRET_KEY Worker secret is valid and matches the key in the Stripe Dashboard > Developers > API Keys.
- Check that the credit package Stripe price IDs in the
credit_packagesdatabase table match actual price IDs in the Stripe Dashboard > Products. - Review the Stripe Dashboard > Developers > Logs for the specific failed API call and error details.
- Test Stripe connectivity:
Terminal window curl https://api.stripe.com/v1/prices \-u "$STRIPE_SECRET_KEY:" \-G -d limit=1 - If the Stripe account was recently created or changed, verify it is fully activated and not in restricted mode.
Related Errors
- ERR_STRIPE_INVALID_SIGNATURE β Webhook signature verification failure