online_or_offline_pin_requiredThe card needs a PIN

Stripe's online_or_offline_pin_required decline means the card needs a PIN. Prompt for Online PIN if the reader supports it, otherwise insert the card.

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

What does online_or_offline_pin_required mean?

The card requires a PIN, so it was declined.

The difference from offline_pin_required is the Online PIN option: on a reader that supports it, you don't need to start a new transaction.

What Stripe says to do

If the reader supports Online PIN, prompt the customer for a PIN without creating a new transaction. If it doesn't, the customer needs to insert the card and enter a PIN.

What to tell the customer

Ask the customer to enter their PIN, or to insert the card and enter it if the reader doesn't support Online PIN.

Example wording
This card needs your PIN. Please enter your PIN to finish the payment.

Should you retry online_or_offline_pin_required?

Stripe's next step is a PIN prompt on the same transaction when the reader supports Online PIN. Otherwise the customer tries again by inserting the card. 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 online_or_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 online_or_offline_pin_required, and follow up from there.

Related decline codes

All Stripe decline codes