Settings
API Version
Product Catalog
Library
List of Errors
gateway

gateway.payment_method.card_pin_invalid

The transaction failed because the provided PIN could not be validated. Please ask the customer to verify their PIN and attempt the transaction again. If the issue persists, you may need to check with the payment gateway or the card issuer.

Recommended Customer Message

The PIN you entered is invalid, and we could not process the transaction. Please verify your PIN and try again. If the issue persists, contact your bank or card issuer for assistance.

Root Cause

  • Incorrect PIN entered: The customer provided a wrong PIN that does not match the one registered with the card issuer.
  • PIN entry errors: The PIN was mistyped or incomplete during the transaction attempt.
  • Card issuer validation failure: The card issuer could not validate the provided PIN due to system or verification issues.
  • Card under security lock: Multiple invalid PIN attempts may have caused the card to be temporarily restricted or locked.

Troubleshooting and Solutions

  • Ask the customer to verify and re-enter the correct PIN.

  • Recommend contacting the card issuer if the customer is unable to recall or reset the PIN.

  • Advise using a different payment method if the issue persists.

  • Avoid retrying the transaction multiple times to prevent the card from being locked.

  • Contact the payment gateway support team if the problem continues despite using the correct PIN.