Post transaction request

​

Post Transaction Monitoring Request

The Transaction Monitoring API endpoint processes transactions in real-time, calculating the fraud percentage based on your predefined thresholds and limits. This endpoint allows for detailed monitoring of transactions to detect and flag potentially fraudulent activity. All fields in the request are required to ensure a comprehensive assessment, and each transaction’s reference field must be unique for accurate tracking.

​

Request Endpoint

POST: {{BASE_URL}}/api/v1/monitoring/transaction_monitoring/

• Media-Type: application/json

​

Status Codes

• 201 Created: Transaction processed successfully.
• 400 Bad Request: Missing or invalid fields in the request.
• 500 Internal Server Error: Unexpected error during processing. The request body is not set correctly.

​

Suspicious Activity Codes:

• 450 - Suspicious Transaction Detected (Requires Manual Review)
• 451 - High-Risk Transaction (Potential Fraud)
• 452 - Unusual Transaction Behavior (Pattern Anomaly)
• 453 - Velocity Check Failed (Too Many Transactions in Short Time)
• 454 - Geographic Inconsistency (Unusual Location)
• 455 - Transaction Amount Too High (Above Threshold)
• 456 - Blacklisted Account or Entity
• 457 - Repeated Failed Transactions (Possible Fraud Attempt)

​

Safe Activity code

• 200 - Transaction Approved (No Issues)
• 201 - Transaction Successfully Processed (Created)
• 202 - Transaction Pending Review (Routine Check, No Immediate Risk)
• 210 - Trusted Transaction (Verified and Safe)
• 211 - Low-Risk Transaction (No Anomalies Detected)
• 212 - Recurring Transaction Approved (Previously Authorized Pattern)
• 220 - Whitelisted Entity (Pre-approved Account or Business)
• 221 - Known Customer (Transaction Aligns with User History)

​

Payload Example Request

{
  "transaction_id": "18772",
  "amount": 1500.00,
  "currency": "USD",
  "transaction_type": "transfer",
  "account_type": "corporate", //individual or corporate
  "status": "completed",
  "origin_account": {
    "account_number": "9876543210",
    "bank_code": "001"
  },
  "destination_account": {
    "account_number": "0123456789",
    "bank_code": "002"
  },
  "customer_details": {
    "customer_name": "Jane Doe",
    "customer_email": "jane.doe@example.com"
  },
  "additional_info": {
    "ip_address": "192.168.1.1",
    "location": "San Francisco, CA", //"lat=-30.6556,lon=-65.7655"
    "transaction_description": "Payment for order #789"
  }
}

201 Created Response

{
    "status": "Success",
    "data": {
        "activity_code": "200"
        "status": "completed",
        "comment": []
    },
    "message": "Transaction was successfully processed"
}

​

Request Body