Fraud Monitoring
Fraud Monitoring
Live Transactions
Submit an event for live transaction check
Request
[POST]
Copy
{{IngestURL}}
Header
Header | Type | Description |
---|---|---|
Authorization | string | public secret key |
Ingest URL
Kindly check here about the guide on how to Connect a Flow
Request Body Template
Bank Transaction
body
Copy
{
"type":"banking", //banking, payments, onboarding
"event":{
"transaction":{
"id": "87554303-3f75-4883-8fb8-48fce003859f", //unique transaction id
"time": "2022-12-12T12:15:05.391Z", //ISO 8601 format
"amount": 8291,
"currency": "XAF",
"ref": "xaf",
"session_id": "xaf",
"type": "deposit", //debit, credit, transfer, etc.
"channel": "mobile", //online, mobile, atm, branch, pos
"purpose": "salary payment", //bill payment, transfer, airtime, etc.
"source_of_funds": "employment income" //savings, business, investment, etc.
},
"user":{
"user_id":"9931fac0-6bfa-4b3c-842c-7840006d89b6",
"user_type": "individual", //individual, business, government, other
"registration_time": "2022-12-12T12:15:05.392Z",
"email":"erik.miller@buchanan.com",
"name":"Trevor Arias",
"tier": "silver", //basic, silver, gold, platinum
"account_type": "checking", //savings, checking, business, student
"gender": "male", //male, female, other
"balance": 24500.50, //current account balance before transaction
"mobile":"5797454931",
"last_pin_change": "2022-11-01T08:30:00.000Z",
"last_password_change": "2022-10-15T14:22:10.000Z"
},
"receiver":{
"account_name": "John Doe",
"bank_name": "EcoBank",
"account_number": "CM21100375689",
"country": "Cameroon"
},
"sender":{
"account_name": "Anon Doe",
"bank_name": "Paystack TITAN",
"account_number": "NG0567890321",
"country": "Nigeria"
},
"device":{
"type":"mobile",
"os":"Android",
"model":"Pixel 7",
"language":"en-US",
"ip_address":"154.72.170.233",
"device_id":"ff97adb7-8d3d-4f15-94df-87e21e1212de"
},
"address":{
"city":"North Sarah",
"street":"6238 Walker Unions Suite 802",
"country":"Morocco"
},
"meta": [
{"key": "value"}
]
}
}
Card Transaction
Response
Copy
{
"type":"card_transaction",
"event":{
"transaction":{
"id": "87554303-3f75-4883-8fb8-48fce003859f",
"time": 1670843705391,
"amount": 8291,
"currency": "xaf",
"ref": "xaf",
"session_id": "xaf",
"type": "deposit",
"channel": "paystack"
},
"user":{
"user_id":"9931fac0-6bfa-4b3c-842c-7840006d89b6",
"registration_time":1670843705392,
"email":"erik.miller@buchanan.com",
"name":"Trevor Arias",
"mobile":"5797454931"
},
"payment":{
"payment_id": "9931fac0-6bfa-4b3c-842c",
"method_type": "card",
"scheme": "Visa",
"card_last_four": "9876",
"expiry_month": "10",
"expiry_year": "25",
"name_on_card": "John Buchanan",
"billing_address": {
"city": "North Sarah",
"street": "6238 Walker Unions Suite 802",
"country": "Morocco"
}
},
"device":{
"type":"mobile",
"os":"Android",
"model":"Pixel 7",
"language":"en/US",
"ip_address":"154.72.170.233",
"device_id":"ff97adb7-8d3d-4f15-94df-87e21e1212de"
},
"address":{
"city": "North Sarah",
"street": "6238 Walker Unions Suite 802",
"country": "Morocco"
},
"meta": [
{"key": "value"}
]
}
}
webhook notification response
Response
Copy
{
event: {
meta: [
{
transaction_id: "Dojah-20231111085937073"
}
],
user: {
name: "Maplerad-Provarex-Acc None",
email: "",
mobile: "None",
user_id: "4ac1bc59-34ad-485a-bda5-eb406a49a411",
registration_time: "1696421468798421"
},
device: {
os: "Android",
type: "mobile",
model: "Pixel 7",
language: "en/US",
device_id: "ff97adb7-8d3d-4f15-94df-87e21e1212de",
ip_address: "154.72.170.233"
},
sender: {
country: "NG",
bank_name: "",
account_name: "Paystack",
account_number: "1017692813"
},
address: {
city: "Lagos",
street: "Ikeja",
country: "Nigeria"
},
receiver: {
country: "NG",
bank_name: "VFD_NEW",
account_name: "",
account_number: "1029283851"
},
transaction: {
id: "Dojah-20231111085937073",
ref: "Dojah-20231111085937073",
time: "1699693180085313",
type: "deposit",
amount: 300,
channel: "transfer",
currency: "NGN",
session_id: "Dojah-20231111085937073"
}
},
score: 30,
decision: {
action: "Allow",
rule_status: false
},
behavioral: {
UnusualTimeTransactions: {
state: true,
description: "User transaction time is outside of normal business hours"
},
AbnormalTransactionVolume: {
state: true,
description: "User has abnormally high transaction volume of 34 within a short period"
}
}
}
Was this page helpful?
Assistant
Responses are generated using AI and may contain mistakes.