Error codes
Soft decline
Stripe
offline_pin_required
The card was declined because it requires a PIN.
What does offline_pin_required mean?
The offline_pin_required decline is returned when a card reader transaction requires the customer to insert their card and enter a PIN. This applies only to in-person payments — not online or subscription billing.
Is it a soft or hard decline?
Soft decline. The card is valid; the transaction just needs PIN verification to complete.
Common root causes
Chip-card transaction requiring PIN
Issuer policy requiring PIN for this transaction
Contactless transaction exceeding no-PIN threshold
Recommended recovery steps
Ask customer to insert card and enter PIN
Does not apply to online subscriptions
How FlyCode handles offline_pin_required
FlyCode is an online subscription recovery platform. In-person PIN-required transactions are outside FlyCode's scope. For online recurring charges, PIN is never required.
What does offline_pin_required mean?
The offline_pin_required decline is returned when a card reader transaction requires the customer to insert their card and enter a PIN. This applies only to in-person payments — not online or subscription billing.
Is it a soft or hard decline?
Soft decline. The card is valid; the transaction just needs PIN verification to complete.
Common root causes
Chip-card transaction requiring PIN
Issuer policy requiring PIN for this transaction
Contactless transaction exceeding no-PIN threshold
Recommended recovery steps
Ask customer to insert card and enter PIN
Does not apply to online subscriptions
How FlyCode handles offline_pin_required
FlyCode is an online subscription recovery platform. In-person PIN-required transactions are outside FlyCode's scope. For online recurring charges, PIN is never required.
What does offline_pin_required mean?
The offline_pin_required decline is returned when a card reader transaction requires the customer to insert their card and enter a PIN. This applies only to in-person payments — not online or subscription billing.
Is it a soft or hard decline?
Soft decline. The card is valid; the transaction just needs PIN verification to complete.
Common root causes
Chip-card transaction requiring PIN
Issuer policy requiring PIN for this transaction
Contactless transaction exceeding no-PIN threshold
Recommended recovery steps
Ask customer to insert card and enter PIN
Does not apply to online subscriptions
How FlyCode handles offline_pin_required
FlyCode is an online subscription recovery platform. In-person PIN-required transactions are outside FlyCode's scope. For online recurring charges, PIN is never required.
Understanding This Decline Code
Extended content body
Frequently Asked Questions
What does offline_pin_required mean?
What should I do about offline_pin_required?
Only relevant at the point of sale — ask the customer to insert the card and enter their PIN. This decline does not occur in online or subscription billing contexts.
Does offline_pin_required affect subscriptions?
FlyCode focuses on online subscription recovery. PIN-based declines from in-person card readers are outside FlyCode's scope — but for online subscriptions, FlyCode uses network tokens that don't require PIN.
