Skip to main content
This section covers transactions flagged by the automated fraud detection system. Review and action these promptly.

​
Overview

The fraud detection system monitors all transactions and flags suspicious activity based on:

Amount

Unusually large transactions

Frequency

Rapid transaction patterns

Behavior

Deviation from normal patterns

Recipients

New or suspicious recipients

​
Endpoints

List Suspicious

GET /api/v1/transactions/suspiciousList flagged transactions with filtering

Summary Stats

GET /api/v1/transactions/suspicious/summaryAggregated statistics for dashboards

​
Severity Levels

Risk Score: 0-30Minor anomalies that may be explained by normal behavior variations.
  • Small amount deviations
  • Slightly unusual timing
  • New recipient (first transaction)

​
Review Status

Pending

Awaiting initial review

Under Review

Being investigated

Cleared

Marked as legitimate

Confirmed

Confirmed as fraud

​
Filtering Options

Filter by from_date and to_date (YYYY-MM-DD format).Default: Last 30 days
Filter by severity: low, medium, high, critical, or all
Filter by status: pending, under_review, cleared, confirmed, or all
Filter by specific subscriber_id or agent_id
Filter with min_amount and max_amount
Filter by transaction_type: transfer_p2p, agent_cashin, pos_payment, etc.

​
Response Structure

{
  "success": true,
  "data": {
    "transactions": [
      {
        "id": "sus_abc123",
        "transaction_id": "txn_xyz789",
        "type": "transfer_p2p",
        "amount": 500000,
        "risk_score": 85,
        "severity": "high",
        "review_status": "pending",
        "flags": ["unusual_amount", "new_recipient"],
        "suspicious_indicators": [
          "Amount 10x higher than average",
          "First transaction to this recipient"
        ],
        "created_at": "2025-01-15T10:30:00Z"
      }
    ],
    "pagination": {
      "current_page": 1,
      "total_pages": 3,
      "total_records": 45
    }
  }
}

​
Dashboard Integration

Use the summary endpoint to power real-time fraud monitoring dashboards.
Key metrics to display:
  • Total Pending - Transactions awaiting review
  • High/Critical Count - Urgent items
  • Amount at Risk - Total flagged amount
  • Trend - Compare to previous period

Compliance Alerts

Manage compliance alerts and resolutions

Monitoring Rules

Configure fraud detection rules