processing_errorAn error occurred while processing the card

Stripe's processing_error decline means something went wrong processing the card. Stripe says to try again. How it shows up and how to test it.

Next step
Retry may work
Hard decline
Not on Stripe's list
Share the reason
Yes

What does processing_error mean?

An error occurred while processing the card.

Stripe also uses processing_error as an API error code, with the advice to try again later or with a different payment method.

What Stripe says to do

Ask the customer to try the payment again. If it still can't be processed, the customer needs to contact their card issuer.

What to tell the customer

Ask the customer to try again. If it still fails, suggest another payment method or a call to their bank.

Example wording
Something went wrong while processing your card. Please try again, or use a different payment method.

Should you retry processing_error?

Yes. Stripe's next step is another attempt. It isn't on Stripe's hard decline list, so Stripe Billing retries follow your Smart Retries or custom schedule.

Before any retry, check the charge's outcome.advice_code. try_again_later means the issuer allows a retry, do_not_try_again means don't use the card again for this transaction, and confirm_card_data means some card details need checking.

Where processing_error shows up

On a failed PaymentIntent, read last_payment_error.decline_code. On the Charge, the same code is in outcome.reason. Card declines usually come with the error code card_declined and the reason in decline_code.

Stripe also documents processing_error as a top-level API error code, so check error.code as well as decline_code when you handle it.

To test it in a Stripe sandbox: Stripe's test card 4000000000000119 returns processing_error as the error code, with no separate decline_code.

With local payment methods

Stripe also returns processing_error for local payment methods, with the Charge's outcome.reason set to partner_processing_error. Stripe's message: "The payment provider encountered a processing error."

Get failed payments in Slack

ChargeBell posts a Slack alert when a Stripe payment fails, with the amount, the customer, and Stripe's decline message. Open the payment from the alert to see its decline code, such as processing_error, and follow up from there.

Related decline codes

All Stripe decline codes