Error codes
Soft decline
Stripe
incorrect_pin
The PIN entered is incorrect. This decline code only applies to payments made with a card reader.
What does incorrect_pin mean?
The incorrect_pin decline code is returned when a PIN entered at a card reader does not match the cardholder's PIN on file. This code applies only to payments made with physical card readers — it does not appear in online or subscription billing contexts.
Is it a soft or hard decline?
incorrect_pin is a soft decline. The card is valid; the PIN was just entered incorrectly.
Common root causes
Customer mistyped the PIN at a card reader
Customer forgot the correct PIN
PIN entered for a different card
Recommended recovery steps
Ask the customer to re-enter the correct PIN
If repeatedly failing, try another payment method
Do not retry the same PIN — repeated attempts may trigger a lockout
How FlyCode handles incorrect_pin
FlyCode operates on online subscription recovery only. PIN-based declines from physical card readers are not applicable to FlyCode's scope. For online recurring charges, PIN entry is never required.
What does incorrect_pin mean?
The incorrect_pin decline code is returned when a PIN entered at a card reader does not match the cardholder's PIN on file. This code applies only to payments made with physical card readers — it does not appear in online or subscription billing contexts.
Is it a soft or hard decline?
incorrect_pin is a soft decline. The card is valid; the PIN was just entered incorrectly.
Common root causes
Customer mistyped the PIN at a card reader
Customer forgot the correct PIN
PIN entered for a different card
Recommended recovery steps
Ask the customer to re-enter the correct PIN
If repeatedly failing, try another payment method
Do not retry the same PIN — repeated attempts may trigger a lockout
How FlyCode handles incorrect_pin
FlyCode operates on online subscription recovery only. PIN-based declines from physical card readers are not applicable to FlyCode's scope. For online recurring charges, PIN entry is never required.
What does incorrect_pin mean?
The incorrect_pin decline code is returned when a PIN entered at a card reader does not match the cardholder's PIN on file. This code applies only to payments made with physical card readers — it does not appear in online or subscription billing contexts.
Is it a soft or hard decline?
incorrect_pin is a soft decline. The card is valid; the PIN was just entered incorrectly.
Common root causes
Customer mistyped the PIN at a card reader
Customer forgot the correct PIN
PIN entered for a different card
Recommended recovery steps
Ask the customer to re-enter the correct PIN
If repeatedly failing, try another payment method
Do not retry the same PIN — repeated attempts may trigger a lockout
How FlyCode handles incorrect_pin
FlyCode operates on online subscription recovery only. PIN-based declines from physical card readers are not applicable to FlyCode's scope. For online recurring charges, PIN entry is never required.
Understanding This Decline Code
Extended content body
Frequently Asked Questions
What does incorrect_pin mean?
Can incorrect_pin be recovered remotely?
No — it only applies to in-person payments with card readers. Recovery requires the customer to correctly enter their PIN in person.
Does incorrect_pin apply to online subscriptions?
FlyCode focuses on online subscription recovery and does not apply to PIN-based in-person transactions. For online recurring billing, FlyCode uses network tokens that bypass PIN requirements entirely.
