Antifraud Manual Review

The Antifraud Review feature allows you to pause transactions for manual review before they are processed by the payment provider.

Overview

When a transaction triggers an antifraud rule configured with the review action, the system:

1. Pauses the transaction immediately
2. Sets the transaction status to review
3. Sends you a callback notification
4. Waits for your decision within a specified timeout period
5. Proceeds based on your response or automatically declines if timeout expires

Flow

Setting Up Review Rules

Step 1: Create an Antifraud Rule

Navigate to the antifraud rules configuration in dashboard panel and create a new rule:

1. Define Conditions: Set up the conditions that should trigger manual review
2. Select Action: Choose Review as the action
3. Set Timeout: Specify the review timeout in hours

Step 2: Configure Timeout Period

The timeout period determines how long you have to make a decision. The timeout value is returned in the callback notification as reviewTimeout. Transactions in review status will not expire based on the standard timeLimit parameter. Instead, they wait for your decision or are automatically declined after the review timeout expires

Receiving Review Notifications

Callback Structure

When a transaction enters review status, you receive a callback.

Key Fields

• orderStatus / payoutStatus: Will be review for transactions requiring manual review
• reviewTimeout: Number of hours you have to make a decision
• payments: Array containing payment attempt details for your review For Order Reviews - Each payment attempt includes a payer object with:
• Personal Data: Full name, email, phone number, birth date, IP address
• Address Data: Complete address including country, state, city, street, and postal code
• Document Data: Identity document details (type, number, issuing country, expiration date)
• paymentDetails / payoutDetails: Details of the payment or payout transaction that vary according to the instrumentType used.

For Payout Reviews - Each payout transaction includes a recipient object with the same structure as above.

Making Review Decisions

API Endpoint

To submit your decision, call the Submit Antifraud Review Decision.

Decision Outcomes

Based on your decision or timeout, the following outcomes occur:

Scenario	Result	Notes
Decision: accept	Transaction continues processing through normal flow	Status changes from review to in_progress
Decision: decline	Transaction is declined	Status changes from review to failed
No decision within timeout	Transaction is automatically declined	Status changes from review to failed