> ## Documentation Index
> Fetch the complete documentation index at: https://docs.smartcomply.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Post fraud request

## Fraud Detection Request

This endpoint evaluates the risk level of a transaction by calculating a fraud percentage based on a predefined threshold and limit. All fields are required. Ensure that the transaction\_id is unique for each request to maintain data integrity.

### Request Endpoint

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

* **Media-Type:** `application/json`

### Status Codes

* **201 Created:** Transaction processed successfully. Fraud score calculated based on threshold.
* **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.

### Payload Example Request

```json theme={null}
{
  "transaction_id": "12345678",
  "amount": 300000,
  "currency": "NGN",
  "transaction_type": "card",
  "timestamp": "2025-08-23T14:30:00Z",
  "card_details": {
    "bin": "345676",
    "last4": "9809"
  },
  "merchant_details": {
    "merchant_name": "ABC Stores",
    "merchant_location": "Lagos, Nigeria"
  },
  "customer_details": {
    "customer_name": "John Queen",
    "customer_email": "jogn@gmail.com",
    "customer_phone": "+2347012345678",
    "bvn": "1234567890"
  },
  "additional_info": {
    "ip_address": "102.89.1.1",
    "country_code": "234",
    "location": "Lagos, Nigeria"
  }
}
```

201 Created Response

```json theme={null}
{
    "status": "Success",
    "data": {
      "fraud_percentage": 20.02,
      "transaction_status": "Clean"
    }
    "message": "Sucessfully processed card transaction"
}
```

### Request Body

| Field | Description | Type |
| - | - | - |
| `transaction_id` | This is the unique identifier for the transaction | `String` |
| `amount` | The total transaction amount | `Float` |
| `currency` | This is currency code for the transaction (e.g., USD, NGN) | `String` |
| `transaction_type` | Type of the transaction (e.g., card) | `String` |
| `timestamp` | ISO 8601 date and time of the transaction. | `String` |
| `card_details` | Details of the card being used for the transaction | `Object` |
| `- bin` | First six digits of the card number | `String` |
| `- last4` | Last four digits of the card number | `String` |
| `merchant_details` | Details of the merchant | `Object` |
| `- merchant_name` | Name of the merchant | `String` |
| `- merchant_location` | Location of the merchant | `String` |
| `customer_details` | Information about the verified customer initiating the transaction. | `Object` |
| `- customer_name` | Customer's full name | `String` |
| `- customer_email` | Customer's email address | `String` |
| `- customer_phone` | Customer's phone number with country code | `String` |
| `- bvn` | Customer's Bank Verification Number (BVN) | `String` |
| `additional_info` | Additional details regarding the transaction | `Object` |
| `- ip_address` | IP address of the customer during the transaction | `String` |
| `- country_code` | Country code associated with the transaction | `String` |
| `- location` | Customer's location (can be formatted as "lat=-30.6556,lon=-65.7655") | `String` |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.