Error codes
Soft decline
Stripe
online_or_offline_pin_required
The card was declined as it requires a PIN.
What does online_or_offline_pin_required mean?
This decline indicates that a PIN is required to complete a card reader transaction — either entered online (via PIN pad) or offline (via chip verification). It applies only to in-person payments.
Is it a soft or hard decline?
Soft decline. The card is valid; PIN entry is just required.
Common root causes
Chip-enabled card requiring PIN
Transaction amount above no-PIN threshold
Issuer policy requiring PIN verification
Recommended recovery steps
Ask customer to complete PIN entry on the card reader
Does not apply to online billing
How FlyCode handles online_or_offline_pin_required
FlyCode is focused on online subscription recovery where PIN entry is not part of the authorization flow. This decline type does not apply to FlyCode's scope.
What does online_or_offline_pin_required mean?
This decline indicates that a PIN is required to complete a card reader transaction — either entered online (via PIN pad) or offline (via chip verification). It applies only to in-person payments.
Is it a soft or hard decline?
Soft decline. The card is valid; PIN entry is just required.
Common root causes
Chip-enabled card requiring PIN
Transaction amount above no-PIN threshold
Issuer policy requiring PIN verification
Recommended recovery steps
Ask customer to complete PIN entry on the card reader
Does not apply to online billing
How FlyCode handles online_or_offline_pin_required
FlyCode is focused on online subscription recovery where PIN entry is not part of the authorization flow. This decline type does not apply to FlyCode's scope.
What does online_or_offline_pin_required mean?
This decline indicates that a PIN is required to complete a card reader transaction — either entered online (via PIN pad) or offline (via chip verification). It applies only to in-person payments.
Is it a soft or hard decline?
Soft decline. The card is valid; PIN entry is just required.
Common root causes
Chip-enabled card requiring PIN
Transaction amount above no-PIN threshold
Issuer policy requiring PIN verification
Recommended recovery steps
Ask customer to complete PIN entry on the card reader
Does not apply to online billing
How FlyCode handles online_or_offline_pin_required
FlyCode is focused on online subscription recovery where PIN entry is not part of the authorization flow. This decline type does not apply to FlyCode's scope.
Understanding This Decline Code
Extended content body
Frequently Asked Questions
What does online_or_offline_pin_required mean?
How do I handle online_or_offline_pin_required?
Only relevant at the point of sale — ask the customer to enter their PIN on the card reader. Not applicable to online or subscription billing.
Does this apply to online subscriptions?
FlyCode specializes in online subscription recovery. In-person PIN-required transactions are outside FlyCode's scope — but the online recurring charges FlyCode recovers don't require PIN at all.

