offline_pin_requiredThe card needs a PIN
Stripe's offline_pin_required decline means the card needs a PIN. The customer should insert the card and enter it. In-person payment guidance.
- Next step
- Customer should authenticate or use a PIN
- Hard decline
- Not on Stripe's list
- Share the reason
- Yes
What does offline_pin_required mean?
The card requires a PIN, so it was declined.
What Stripe says to do
The customer needs to try again by inserting their card and entering a PIN.
What to tell the customer
Ask the customer to insert the card instead of tapping, and enter their PIN.
This card needs your PIN. Please insert the card and enter your PIN.
Should you retry offline_pin_required?
Yes, by inserting the card and entering the 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 offline_pin_required 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 offline_pin_required, and follow up from there.