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.

Example wording
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.

Related decline codes

All Stripe decline codes