stop_payment_orderDeclined for an unknown reason

Stripe's stop_payment_order decline means the bank declined without a documented reason. Why not to assume the customer cancelled, and what to ask.

Next step
Customer should contact their bank
Hard decline
Not on Stripe's list
Share the reason
Yes

What does stop_payment_order mean?

The card was declined, and the issuer didn't give Stripe a specific reason.

The name suggests a stop-payment instruction at the bank, but Stripe only documents an unknown reason. Ask the customer before you treat it as a cancellation.

What Stripe says to do

The customer needs to contact their card issuer for more information.

What to tell the customer

Ask the customer whether they meant to stop the payment, and if not, to contact their bank.

Example wording
Your bank declined this payment. If you didn't expect that, please contact your bank or use a different card.

Should you retry stop_payment_order?

Stripe doesn't suggest a retry. 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 stop_payment_order 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.

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 stop_payment_order, and follow up from there.

Related decline codes

All Stripe decline codes