invalid_pinThe PIN is invalid
Stripe's invalid_pin decline means the PIN entered was incorrect. How it compares to incorrect_pin and what to tell the customer at the reader.
- Next step
- Customer should authenticate or use a PIN
- Hard decline
- Not on Stripe's list
- Share the reason
- Yes
What does invalid_pin mean?
The PIN entered is incorrect.
Stripe describes invalid_pin and incorrect_pin the same way, but only notes for incorrect_pin that it's limited to card reader payments.
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 wasn't accepted and let them try again.
That PIN wasn't accepted. Please try entering it again.
Should you retry invalid_pin?
Yes, with the correct PIN. 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 invalid_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 invalid_pin, and follow up from there.