/event/transaction

post

https://live.fraudjudge.com/event/transaction

The Fraud Detection API enables customers to analyze transactional data in real time, identifying suspicious patterns, behaviors, or anomalies to prevent fraud. It seamlessly integrates with backend systems, helping organizations mitigate fraud-related losses while ensuring the smooth processing of legitimate transactions.

Body Params

transactionId

string

length ≤ 128

Transaction identifier. If the ID is not specified, it will be generated automatically

transactionType

string

length ≤ 128

The type of transaction, such as a purchase or a return

transactionAmount

number

required

≥ 0

The total transaction amount in the specified currency, rounded to two decimal places. Must be a non-negative decimal value with up to 17 digits in total. The value may contain at most 2 digits after the decimal point. If a fractional part is present, the integer part may contain at most 15 digits.

transactionCurrency

string

required

Transaction currency in ISO 4217 alpha-3 format. Only currencies supported by the European Central Bank (ECB) are accepted. Refer to the ECB official list of currencies for valid values.

cardHolder

string

length ≤ 128

The full name of the card holder as it appears on the card. Typically includes first and last name

cardBin

string

length between 4 and 9

The first 4 to 9 digits of the card number. Commonly used for identifying the issuing bank (BIN/IIN).

cardHash

string

length ≤ 128

The hashed value of the full card number for security purposes. Typically a cryptographic hash (e.g., MD5, SHA-256).

cardLast

string

length between 4 and 4

^\d{4}$

The last 4 digits of the card number, often used for verification purposes.

cardExpiry

string

^(0[1-9]|1[0-2])\/\d{2}$

The card's expiration date in the format MM/YY. Month must be between 01 and 12.

userIp

string

The user's IP address. Can be either an IPv4 or IPv6 address.

userEmail

string

length ≤ 128

The email address of the user.

userPhoneNumber

string

length ≤ 17

^\+?\d{1,16}$

The user's phone number including the country code. The value may optionally start with '+', followed by 1 to 16 digits. Only digits are allowed after the optional '+'. No spaces, hyphens, or other characters are permitted. This means the phone number can contain up to 16 digits, and up to 17 characters in total if the leading '+' is present.

userFullName

string

length ≤ 128

The full name of the user, typically including first and last name.

userFirstName

string

length ≤ 128

The first name of the user.

userLastName

string

length ≤ 128

The last name of the user.

userDob

date

The user's date of birth in ISO 8601 format (YYYY-MM-DD). Must represent a valid calendar date.

userPob

string

length ≤ 128

The user's place of birth. This could be a city, state, or country.

userId

string

length ≤ 128

User's unique identifier

userName

string

length ≤ 128

The registered username of the user, typically used for login or identification. This is not the user's full name.

userCreated

date

User registration date in the format YYYY-MM-DD.

userCountry

string

^[A-Z]{2}$

The two-letter ISO 3166-1 alpha-2 country code representing the user's registered address. Must consist of exactly two uppercase letters.

userCity

string

length ≤ 128

The city associated with the user's registered address.

userRegion

string

length ≤ 128

The region, state, or province associated with the user's registered address, depending on the country's administrative divisions.

userZip

string

length ≤ 128

The user's zip or postal code. This may include letters, numbers, and spaces depending on the country.

userStreet1

string

length ≤ 128

The first line of the user's registered street address, typically including the house number and street name.

userStreet2

string

length ≤ 128

The second line of the user's registered street address, typically used for additional address information such as apartment, suite, unit, or floor.

shippingCountry

string

^[A-Z]{2}$

Two-letter ISO 3166-1 alpha-2 country code for the user's shipping address. Must consist of exactly two uppercase letters.

shippingCity

string

length ≤ 128

The city associated with the user's shipping address

shippingRegion

string

length ≤ 128

The region, state, or province associated with the user's shipping address, depending on the country's administrative divisions.

shippingZip

string

length ≤ 128

The zip or postal code associated with the user's shipping address. This may include letters, numbers, and spaces depending on the country.

shippingStreet1

string

length ≤ 128

The first line of the user's shipping street address, typically including the house number and street name.

shippingStreet2

string

length ≤ 128

The second line of the user's shipping street address, typically used for additional details such as apartment number, suite, or floor.

shippingPhone

string

length ≤ 17

^\+?\d{1,16}$

The phone number associated with the user's shipping address, including the country code. The value may optionally start with '+', followed by 1 to 16 digits. Only digits are allowed after the optional '+'. No spaces, hyphens, or other special characters are permitted. This means the phone number can contain up to 16 digits, and up to 17 characters in total if the leading '+' is present.

shippingFullName

string

length ≤ 128

The full name of the recipient associated with the shipping address, typically including first and last names.

billingCountry

string

^[A-Z]{2}$

Two-letter ISO 3166-1 alpha-2 country code for the user's billing address. Must consist of exactly two uppercase letters.

billingCity

string

length ≤ 128

The city associated with the user's billing address.

billingRegion

string

length ≤ 128

The region, state, or province associated with the user's billing address, depending on the country's administrative divisions.

billingZip

string

length ≤ 128

The zip or postal code of the user's billing address. This may include letters, numbers, and spaces, depending on the country's postal code format.

billingStreet1

string

length ≤ 128

The primary street address for the user's billing address, typically including the house number and street name.

billingStreet2

string

length ≤ 128

Additional address information for the user's billing address, such as apartment, suite, or floor.

billingPhone

string

length ≤ 17

^\+?\d{1,16}$

The phone number associated with the user's billing address, including the country code. The value may optionally start with '+', followed by 1 to 16 digits. Only digits are allowed after the optional '+'. No spaces, hyphens, or other special characters are permitted. This means the phone number can contain up to 16 digits, and up to 17 characters in total if the leading '+' is present.

browserUserAgent

string

length ≤ 128

The user agent string of the browsing client, which includes details about the software, browser, and operating system versions.

items

array of objects | null

The list of items included in the purchase transaction. The array can contain up to 100 items.

items

Responses

200OK

401Unauthorized

403Forbidden

404Not Found

422Unprocessable Content

503Service Unavailable

504Gateway Timeout