Settings
API Version
Product Catalog
Library
List of Errors
gateway

gateway.payment_method.card_invalid_number

The customer's transaction could not be completed due to an invalid card number. Please advise the customer to re-verify the card number and attempt the transaction again. If the problem continues, suggest they try a different payment method or reach out to their bank for further assistance.

Recommended Customer Message

Your transaction could not be completed because the card number you entered is invalid. Please re-verify the card number and try again. If the issue persists, consider using a different payment method or contact your bank for assistance.

Root Cause

  • Incorrect card number entered: The customer mistyped or entered an incomplete card number.
  • Invalid card number format: The provided number does not meet the required format or fails validation checks such as the Luhn algorithm.
  • Unsupported or outdated card type: The entered card number belongs to a card type not supported by the payment gateway.
  • Test or placeholder number used: A dummy or test card number was mistakenly used in a live transaction environment.

Troubleshooting and Solutions

  • Ask the customer to carefully re-verify and enter the correct card number.
  • Ensure the card number matches the expected format and length for the card type being used.
  • Recommend using a different payment card if the issue persists.
  • Suggest contacting the bank if the customer continues to experience difficulties with the valid card number.
  • Implement real-time validation on the payment form to help prevent incorrect or invalid card number submissions.