incorrect_pinThe PIN is wrong

Stripe's incorrect_pin decline means the PIN entered on a card reader was wrong. Only applies to in-person payments. What to do next.

Next step
Customer should authenticate or use a PIN
Hard decline
Not on Stripe's list
Share the reason
Yes

What does incorrect_pin mean?

The PIN entered is incorrect. Stripe only uses this code for payments made with a card reader.

What Stripe says to do

The customer needs to try again with the correct PIN.

What to tell the customer

Tell the customer the PIN was wrong and let them try again on the reader.

Example wording
That PIN wasn't accepted. Please try entering it again.

Should you retry incorrect_pin?

Yes, with the correct PIN. Too many wrong attempts end in pin_try_exceeded. 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 incorrect_pin 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 incorrect_pin, and follow up from there.

Related decline codes

All Stripe decline codes