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.payment_method.card_number_issue
We were unable to process the transaction because the submitted card number does not have the correct number of digits. Please advise the customer to verify their card details and try the transaction again. If they continue to experience issues, recommend they contact their card issuer for further assistance.
Recommended Customer Message
The submitted card number does not include the proper number of digits. Please double-check the card number and attempt the transaction again. If the issue persists, contact your card issuer's support for assistance.
Root Cause
- Incorrect card number length: The entered card number does not meet the required length for the card type (e.g., Visa, MasterCard, Amex).
- Typographical errors: The customer mistyped the card number, leading to missing or extra digits.
- Incomplete card details: The card number entry was submitted before all required digits were entered.
- Invalid card number format: The card number does not pass standard validation checks such as the Luhn algorithm.
Troubleshooting and Solutions
- Verify and re-enter the complete card number carefully, ensuring all digits are correct.
- Ensure the card number matches the expected format and length for the card type.
- Retry the transaction after correcting the card number.
- Ask the customer to contact their card issuer if the correct card number is still being rejected.
- Implement client-side validation to help prevent submission of incomplete or invalid card numbers.