pin_try_exceededToo many wrong PIN attempts
Stripe's pin_try_exceeded decline means the customer entered the wrong PIN too many times. They must use another card or payment method.
- Next step
- Customer should use another card
- Hard decline
- Not on Stripe's list
- Share the reason
- Yes
What does pin_try_exceeded mean?
The customer used up the allowed number of PIN attempts.
What Stripe says to do
The customer must use another card or payment method.
What to tell the customer
Tell the customer the card has been locked out of PIN attempts and ask for another payment method.
Too many PIN attempts were made on this card. Please use a different card or payment method.
Should you retry pin_try_exceeded?
Not on this card. Stripe says the customer must use another card or payment method. 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 pin_try_exceeded 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 pin_try_exceeded, and follow up from there.