customer_declinedThe customer declined the payment
Stripe's customer_declined code means the customer turned down a local payment method payment. Its charge outcome reason is generic_decline.
- Type
- Local payment method codes
- Hard decline
- Not on Stripe's list
- Share the reason
- Yes
What does customer_declined mean?
The customer declined the payment.
What to tell the customer
Ask the customer whether they meant to decline, and let them start the payment again.
It looks like the payment was declined in your payment app. If that wasn't intended, please start the payment again.
Should you retry customer_declined?
Stripe doesn't say. Stripe Billing doesn't retry failed local payment method payments unless you turn that on in your retry settings.
Where customer_declined shows up
For local payment methods, the PaymentIntent's last_payment_error.decline_code is customer_declined, and Stripe reports the Charge's outcome.reason as generic_decline.
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 customer_declined, and follow up from there.