Managing Held Transactions

Last updated: April 7, 2026

You can configure scenarios to place a Hold on a transaction if it breaches a set of conditions. This outcome is a powerful tool that instructs your system not to process a potentially risky payment until it has been manually reviewed. 

This guide outlines the end-to-end process for managing these transactions via the web app and API.

1. Set the "Hold" Outcome in a Scenario

First, you need to specify in your scenario that a transaction should be held. This is configured per customer segment.

  1. Navigate to the scenario you wish to edit.

  2. Select Actions > Create draft.

  3. Once the draft is created, select Actions > Edit.

  4. Click Add customer segment.

  5. In the configuration options for that segment, set the Transaction outcome to Hold.

  6. Click Save to apply your changes to the draft.

2. Find Held Transactions

You can easily find all transactions that are currently being held.

  1. Navigate to the Transactions page from the main navigation menu.

  2. Click Filters, open the Evaluation Outcome filter, and tick the Hold checkbox. The list will update to show only held transactions.

3. Review a Held Transaction

Once a transaction is held, an analyst must make a decision to either release it for processing or reject it.

Via the Web App

  1. From the filtered list, click on a transaction to open its detail page.

  2. In the top-right corner, you will see Evaluation outcome: Hold and a Decision button.

  3. Click Decision and select one of the options:

    • Release: Removes the hold, allowing the payment to be processed.

    • Reject: Sustains the hold, confirming the payment should not be processed.

  4. This action sets the Review Decision for the transaction and will trigger a webhook if one is configured.

Tip: On the Transactions page, you can filter by Review Decision to find all previously released or rejected transactions.

Via the API

To submit a review decision programmatically, please refer to our API documentation:

4. Set Up a Webhook for Notifications

To automatically inform your system after a review decision has been made, you should use the TRANSACTION_REVIEWED webhook. This webhook will send a notification every time a user sets a Release or Reject decision on a transaction.

For full details on configuring webhooks, please see our documentation: