Settings
API Version
Product Catalog
Library
List of Errors
gateway

gateway.transaction_authorization.auth_not_found

We encountered an error while processing the authorization for this transaction. This may indicate an issue with the customer's card or restrictions from the processor. Please advise the customer to verify their card details and contact their card issuer for assistance.

Recommended Customer Message

An error occurred while trying to process the authorization for your transaction. This could be due to an issue with your card or restrictions from the processor. Please verify your card details are correct and contact your card issuer for further assistance.

Root Cause

  • Missing or invalid authorization reference: The authorization ID provided could not be found in the gateway or processor records.

  • Expired authorization session: The transaction authorization has expired before capture or completion.

  • Incorrect card details provided: Invalid or outdated card details caused the authorization attempt to fail.

  • Processor restrictions or errors: The payment processor has blocked the authorization attempt due to policy violations or technical issues.

Troubleshooting and Solutions

  • Retry the transaction only after confirming that the authorization process has been correctly initiated.

  • If this error continues to occur, contact the payment gateway support team to investigate potential system or configuration issues.

  • Ensure that transaction workflows manage authorization timeouts and session expiries effectively to avoid such errors.

  • Ask the customer to verify and re-enter their correct card details before retrying the transaction.

  • Recommend the customer contact their card issuer to ensure there are no restrictions or blocks on their card.