Settings
API Version
Product Catalog
Library
Configure SDK
Home
Business Entities
Customers
Subscriptions
In App Purchases - Legacy
Omnichannel
Invoices and Credit Notes
Estimates
Orders
Product Catalog
Entitlements
Usage Based Billing
Hosted Pages
Payments
Currencies
Events
Simulation Tools
List of Errors
gateway
gateway.identity_verification.contactless_fallback
The shopper attempted a contactless payment, but the transaction failed, requiring an alternate card entry method (PIN, swipe, or chip). The customer abandoned the transaction before completing the fallback method. Please advise the shopper to retry with another payment method or instruct them to use a different card entry method to complete the transaction.
Recommended Customer Message
The contactless payment was unsuccessful, and we could not complete the transaction. Please try again using a different card entry method, such as inserting the card or entering your PIN. If the issue persists, contact your bank or card issuer for assistance.
Root Cause
- Contactless transaction limit exceeded: The transaction amount exceeded the allowed limit for contactless payments, triggering a fallback to another method.
- Card issuer security policy: The issuer requires additional authentication for certain transactions, disabling contactless for this attempt.
- Technical issues with NFC/Contactless reader: The payment terminal failed to properly read the card using contactless mode.
- Fallback triggered but not completed: The customer did not proceed with the fallback method (chip insert, PIN entry, or swipe).
Troubleshooting and Solutions
- We recommend using a different payment method if the issue persists.
- Advise the customer to retry using an alternative card entry method, such as inserting the card and entering their PIN or swiping the card.
- Ensure the payment terminal is functioning correctly and supports fallback handling.
- If this issue occurs frequently, consider reviewing terminal settings or contacting the payment gateway for troubleshooting.