Skip to main content


The Fraugster API accepts a payment transaction as a JSON object where each key/value pair represents a datapoint. A datapoint carries specific information about the transaction itself and the customer. The Fraugster Engine receives your datapoints and enriches every transaction with additional ones. As a result, each transaction gets a score that contributes to the approval process.

Datapoint types

Each datapoint has a name and a specific data type. Data type mismatches result in a server response with the code 400 (bad request).

We support the following basic data types, as well as composite ones derived from one or more basic types.

Basic data types

stringA sequence of characters representing textual data."2662 Main Street" “3456"
floatA numeric value with floating decimal points.23.15
timestampAn RFC3339-encoded UTC timestamp. The timezone accepts either the character "Z" to indicate UTC or a time offset in the format "+02:00" or "-07:30".
  • "2009-11-10T23:00:00Z"
  • "1996-12-19T16:39:57-08:00"
dateThe date part of an RFC3339 -encoded UTC timestamp. The timezone accepts either the character "Z" to indicate UTC or a time offset in the format "+02:00" or "-07:30".
  • "2006-01-02Z"
  • "1990-12-31+02:00"
integerA whole number without a fractional component. Can be positive, negative, or zero.42
enumA set of values of the same data type.["EU", "DE", "IT"]
booleanA logical data type with values true or false.false

Composite data types

shopping_cart_itemA collection of datapoints representing an item in the shopping cart of the customer.{ "item_id": "DF42", "item_desc": "Belt"}
customA collection of custom datapoints. It can contain any information about a product, customer, or business model that is not collected by Fraugster datapoints. Can be sent with each transaction and used for rule creation by Fraud Management SaaS users.{ “test”: true, “n”: 42 }

Required datapoints

The Fraugster API currently supports around 170 datapoints. The number of datapoints you submit in the API request depends on your needs, available data, and the Fraugster product you use. The more data the Fraugster Engine receives, the more accurate the scoring outcome is going to be.

That said, the datapoints mentioned below are required. If you don't include all of them in your request, the server responds with the status code 400 (bad request).

trans_idstringYour primary unique reference for the transaction."43d72xfdil915889fu"
trans_tstimestampThe transaction timestamp as reported by the client."2006-01-02T15:04:05Z"
trans_amtfloatThe transaction amount in the original currency.23.15
trans_currencystringISO-3 currency code in which trans_amt is given."EUR"
seller_idstringThe ID of the merchant."ABG826"