Post fraud request - Adhere by Smartcomply

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

{
  "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

{
    "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`

​Fraud Detection Request

​Request Endpoint

​Status Codes

​Payload Example Request

​Request Body

Fraud Detection Request

Request Endpoint

Status Codes

Payload Example Request

Request Body