Skip to main content

Search variables

The following table contains a complete list of variables supported by the search in Transactions overview. The data stored in these datapoints or attributes is available for search purposes.

Good to remember

Datapoints carry specific information about a transaction. You send datapoints to us via the Fraugster API. Attributes carry additional information about a transaction. They are are calculated during the enrichment process using the data in datapoints.

It's important to remember that some attributes rely on specific datapoints to be calculated. If these datapoints are not available, the attributes won't be calculated. An example from the following table is cust_fl_norm. If you want it to be calculated, you need to send cust_name or cust_first_name + cust_last_name in your API request.

Internal nameDisplay nameDatapoint (D) or attribute (A)?Description
bill_ad_zipBilling address | Postal codeDThe postal code on the billing address.
bill_ad_line2Billing address | Apartment numberDThe apartment or flat number on the billing address.
cc_num_hashCredit card | Hashed numberDThe hashed value of the credit card number. Use this datapoint to send credit card numbers if you cannot send the full card number in cc_num.
acct_ad_line1Account address | Street and building numberDThe street and building number on the account address.
phone_workPhone | WorkDThe phone number of the customer marked as the work phone.
ship_ad_first_nameShipping address | First nameDThe first name of the customer on the shipping address.
pmt_methodTransaction | Payment methodDThe payment method used for the transaction.
bin_brandBIN | BrandD or A (requires cc_bin)The credit card brand.
cust_fl_normCustomer | Full name normalizedA (requires cust_name or cust_first_name + cust_last_name)The normalized value of the customer's full name. Normalization in this case removes unicode and special characters (for example, an apostrophe is removed and ü becomes u) and spells all the names in lower case.
ship_ad_emailShipping address | EmailDThe email address of the customer on the shipping address.
cust_middle_nameCustomer | Middle nameDThe middle name of the customer.
ip_ispIP | Internet service providerA (requires ip)The ISP (Internet Service Provider) that owns the IP address.
ship_ad_cityShipping address | CityDThe city on the shipping address.
cust_emailCustomer | Email addressDThe primary email address of the customer.
ba_ibanBank account | IBANDIBAN (International bank account number). Up to 34 alphanumeric characters.
scndry_phoneCustomer | Secondary phoneDThe secondary phone number of the customer.
bill_ad_stateBilling address | StateDThe state or another unit of administrative division on the billing address.
client_idClient | IDDClient IDs are assigned by Fraugster during the integration process. By definition, they are equal to the API user that customers send in order to authenticate. Client IDs are always lower case.
bill_ad_line1Billing address | Street and building numberDThe street and building number on the billing address.
bill_ad_last_nameBilling address | Last nameDThe last name of the customer on the billing address.
ship_ad_line2Shipping address | Apartment numberDThe apartment or flat number on the shipping address.
ship_ad_last_nameShipping address | Last nameDThe last name of the customer on the shipping address.
phoneCustomer | PhoneDThe phone number of the customer.
bill_ad_first_nameBilling address | First nameDThe first name of the customer on the billing address.
ship_ad_zipShipping address | Postal codeDThe postal code on the shipping address.
cc_first_nameCredit card | Cardholder first nameDThe first name of the credit card holder.
order_idMerchant | Order IDDThe identification code of the order as captured by the merchant. Do not confuse with the order ID assigned by the PSP (trans_id) or the order ID created by Fraugster (frg_trans_id).
cust_last_nameCustomer | Last nameDThe last name of the customer.
bill_ad_cityBilling address | CityDThe city on the billing address.
acct_ad_zipAccount address | Postal codeDThe postal code on the account address.
device_idDevice | IDDDevice identification code.
acct_ad_line2Account address | Apartment numberDThe apartment or flat number on the account address.
ba_bicBank account | BICDThe BIC (bank identifier code) of the bank account. Up to 11 characters.
cc_last_nameCredit card | Cardholder last nameDThe last name of the credit card holder.
customer_account_numberCustomer | Account numberDThe account number of the customer in the merchant's database.
ipIPDThe IP address of the customer.
ba_numBank account | NumberD or A (requires ba_iban)The bank account number of the customer.
cust_scndry_emailCustomer | Secondary email addressDThe secondary email address of the customer.
cc_cardholderCredit card | Cardholder full nameDThe full name of the credit card holder. Send this datapoint if you collect the full name. Otherwise send parts of the name separately in cc_first_name, cc_middle_name, and cc_last_name.
ship_ad_stateShipping address | StateDThe state or another unit of administrative division on the shipping address.
ba_last_nameBank account | Account holder last nameDThe last name of the bank account holder.
ip_cityIP | CityA (requires ip)The city of the IP address.
slr_ind_mccMerchant | MCCDThe MCC (merchant category code) of the merchant. You can either have this configured in the configuration service or send this information in the API request.
seller_idMerchant | IDDThe identification code of the merchant.
cust_first_nameCustomer | First nameDThe first name of the customer.
acct_ad_stateAccount address | StateDThe state or another unit of administrative division on the account address.
acct_ad_cityAccount address | CityDThe city on the address of the customer saved in the customer's account on the merchant's platform.
ba_first_nameBank account | Account holder first nameDThe first name of the bank account holder.
cc_binBIN | NumberDThe BIN number of the credit card (the first 6 digits).
bin_categoryBIN | Brand categoryA (requires cc_bin)The category of the credit card brand.
cc_last_4_digCredit card | Last 4 digitsDThe last 4 digits of the credit card.
device_nameDevice | NameDThe name of the customer's device.
sub_sellerSub-merchant | IDDThe identification code of the sub-merchant.
ship_ad_line1Shipping address | Street and building numberDThe street and building number on the shipping address.
slr_nameMerchant | NameDThe name of the merchant. You can either have this configured in the configuration service or send this information in the API request.
ship_ad_line1_zip_cnctShipping address | Street, building number, postal code concatenatedA (if you send ship_ad_line1 and ship_ad_zip)The normalized and concatenated values of the street and building number on the shipping address together with the postal code. The attribute is useful if you want to create a blacklist. It helps you see a specific address without upper-case letters or spaces, making it easier to find and compare two identical addresses.
cust_idCustomer | ID as per merchantDThe ID of the customer in the merchant's database.
device_id_exactDevice | Exact IDDExact ID is a hashed device fingerprint generated by the payment company. It's based on a variety of markers to give a 100-percent accuracy in identifying a device, including browser language, cookies settings, and more.
device_id_smartDevice | Smart IDDSmart ID is a hashed device fingerprint generated by the payment company. It's optimized for persistence across standard computer lifecycle events. It works without the use of cookies and is calculated from hundreds of device attributes that are measured in real time.
cust_email_normCustomer | Email address normalizedA (requires cust_email)The normalized version of the customer's email address. Normalization may include standardizing the case, removing unnecessary spaces, etc.
cust_nameCustomer | Full nameDThe full name of the customer. Use this datapoint when a customer sends their full name in one field, as opposed to sending their first, middle, and last name in separate fields.
sanctions_lists_hits_jsonSanctions lists hits | JSON stringA (requires sanctions list configuration)A list of objects with all sanctions lists hits, represented as a JSON string.
device_id_mappedDevice | Device ID mappedA (requires device ID configuration)The value of the device ID based on the client's configuration (Fraugster's or their own).
frg_trans_idTransaction | IDA (generated by Fraugster)The order ID created by Fraugster. Do not confuse with the order ID assigned by the PSP (trans_id) or the ID of the order as captured by the merchant (order_id).
trans_idTransaction | IDDThe order ID assigned by the PSP. Do not confuse with the ID created by Fraugster (frg_trans_id) or the ID of the order as captured by the merchant (order_id).