Skip to main content

Suspicious Transactions

Warning

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/suspicious

List flagged transactions with filtering

Summary Stats

GET /api/v1/transactions/suspicious/summary

Aggregated statistics for dashboards

Severity Levels​

Risk Score: 0-30

Minor 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​

Date Range

Filter by from_date and to_date (YYYY-MM-DD format).

Default: Last 30 days

Severity

Filter by severity: low, medium, high, critical, or all

Status

Filter by status: pending, under_review, cleared, confirmed, or all

Subscriber/Agent

Filter by specific subscriber_id or agent_id

Amount Range

Filter with min_amount and max_amount

Transaction Type

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​

Info

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