API Version
Product Catalog
Library
List of Errors
The transaction failed at the preauthorization stage. This could be due to insufficient balance, card restrictions, or an issue with the payment method. Please advise the customer to verify their details or contact their bank.

Recommended Customer Message

The transaction could not be completed due to a preauthorization failure. Please ensure your payment method is valid and has sufficient balance or contact your bank for assistance.

Root Cause

  • Insufficient balance or credit limit: The customer's account does not have enough funds to reserve the preauthorization amount.

  • Payment method restrictions: The card or payment method has limitations that prevent preauthorization transactions.

  • Incorrect payment details: Invalid or outdated card information caused the preauthorization attempt to fail.

  • Bank or issuer declined preauthorization: The bank flagged the preauthorization request as invalid or suspicious and declined it.

Troubleshooting and Solutions

  • Recommend checking that the payment details provided are accurate and up to date.

  • Ask the customer to verify that their payment method has sufficient funds or available credit for the transaction.

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

  • Advise the customer to contact their bank to understand why the preauthorization failed and resolve any account or card restrictions.

  • Retry the transaction only after confirming that the payment method is valid and capable of completing preauthorization.