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

  1. Ask customer to complete PIN entry on the card reader

  2. 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

  1. Ask customer to complete PIN entry on the card reader

  2. 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

  1. Ask customer to complete PIN entry on the card reader

  2. 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.

FlyCode partnered with Stripe, to turn failed payment intro revenue.

With our newest Stripe app, you can stop chasing your customers about their failed payments and recover more payments with zero development work.

With our newest Stripe app, you can stop chasing your customers about their failed payments and recover more payments with zero development work.

Giving Back

Partnering with organizations that promote women in technology and families in need is something we are proud to do.

Text graphic displaying "SPE CODES; NEXT LEVEL" in a bold, stylized font on a solid background.
Logo featuring a stylized text "Catching" with an orange accent, set against a simple background.

2026 FlyCode © All Right Reserved.

Giving Back

Partnering with organizations that promote women in technology and families in need is something we are proud to do.

Text graphic displaying "SPE CODES; NEXT LEVEL" in a bold, stylized font on a solid background.
Logo featuring a stylized text "Catching" with an orange accent, set against a simple background.

2026 FlyCode © All Right Reserved.