Library
List of Errors
A transaction was declined due to an unexpected state with the payment method. Advise the customer to retry. Contact Gateway support if the problem persists.

Recommended Customer Message

Your payment cannot be processed due to an unexpected issue. Try again or contact support for help.

Description

The payment failed because the payment method is in an unexpected state. This error occurs when the payment method is not in a valid state for processing, a previous transaction was interrupted, or the gateway encountered an unexpected condition.

Recommended Customer Message

Your payment could not be processed due to an unexpected issue. Please try again or use a different payment method.

Root Cause

  • Invalid payment method state: The payment method is not in a valid state for processing transactions.
  • Interrupted previous transactions: Incomplete or interrupted prior transactions left the payment method in an inconsistent state.
  • Temporary gateway issue: The payment gateway encountered an unexpected state while processing the transaction.
  • Gateway integration errors: Incorrect API request sequence or invalid state transitions in the payment flow.

Troubleshooting and Solutions

  • Ask the customer to retry the transaction after a short interval.
  • Verify the payment method is active and correctly set up for processing.
  • If the issue persists, ask the customer to add the payment method again before retrying.
  • Contact the payment gateway support team if the issue persists across multiple attempts.