online_or_offline_pin_required
The card needs a PIN for this payment.
| Group | In-person card reader (PIN) |
|---|---|
| Retry | Fix at the reader |
| Customer-facing | Safe to explain |
What it means
The card needs a PIN for this payment.
What Stripe's docs suggest
If the reader supports online PIN, ask for the PIN without starting a new transaction. If not, ask the customer to insert the card and enter the PIN. Source
Will a retry work?
This is an in-person, card-present code. The customer fixes it at the terminal.
What to tell the customer
A message you could send: “That didn't go through. Please enter your PIN again, insert your card, or try another card.”
If this hit a subscription renewal
- This happens in person, at a card reader, not on subscription renewals.
- Ask the customer to re-enter the PIN or insert the card, or use another card.
Similar card-network reason codes
Banks also return a raw network code. These raw codes have a similar meaning to online_or_offline_pin_required. Stripe doesn't publish a one-to-one mapping, so treat this as our guide, not an official match.
| Network | Raw code | Meaning (our wording) |
|---|---|---|
| Visa | 70 | PIN required |
Stripe's network decline code tables
Questions
What does online_or_offline_pin_required mean?
The card needs a PIN for this payment.
Can I retry a online_or_offline_pin_required decline?
This is an in-person, card-present code. The customer fixes it at the terminal.
What should I tell a customer about online_or_offline_pin_required?
A message you could send: “That didn't go through. Please enter your PIN again, insert your card, or try another card.”
Related codes
Checked against Stripe's public docs on November 17, 2026. Codes and guidance can change; always confirm in the official decline code list.