Skip to main content

Smart Retry

Overview​

During the payment process, technical issues can occasionally disrupt the flow. If an error occurs during a Capture, Refund, or Void operation, the Smart Retry feature automatically attempts to rerun the action. This helps successfully complete the operation without losing the transaction due to a temporary glitch.

How It Works​

1. Error Mapping​

We define a specific list of error status codes for each Payment Service Provider (PSP) and their respective solutions. These codes represent temporary, recoverable issues where an initial failure could turn into a success after a retry. Only errors that match these predefined codes are eligible to trigger a Smart Retry.

2. Resolution Scenarios​

When the system receives an eligible error code from the PSP, it immediately executes a Get Status request to verify the actual state of the transaction on the partner's side. Based on this check, the system handles two distinct scenarios:

  • Scenario A: The transaction is actually successful (False Negative) We receive an error from the PSP, but the Get Status call reveals that the transaction is marked as OK on the partner's side. Because the action was actually successful, the system simply returns the successful status and halts the retry process.
  • Scenario B: The transaction actually failed (True Failure) We receive an error from the PSP, and the Get Status call confirms that the transaction is also in error (KO) on the partner's side. Because the failure is confirmed and mapped as a temporary issue, the system will automatically re-run the initial action (Capture, Refund, or Void) to attempt to get a successful response from the PSP.