Complete List of Datapoints
Shufti's Transaction Trust Monitoring (TTM) evaluates every transaction by running it against a set of rules you configure. Shufti collects data points from its user as input in API requests and performs screening.
Datapoints are the raw values your application sends in the API request. They represent the core facts of a transaction, such as the customer's email address, IP address, device ID, transaction amount, or payment method. Datapoints are the foundation of every rule in TTM.
The tables below list all available Datapoints:
Datapoints
⬇️ Download the complete list of datapoints:
General | Account
| Name | Display Name | Description |
|---|---|---|
| acct_ad_city | Account address | City | Type: string The city on the address of the buyer saved in the buyer's account on the merchant's platform. Example: Paris, Berlin |
| acct_ad_ctry | Account address | Country | Type: enum The country on the account address. An ISO 3166-1 alpha-2 code. |
| acct_ad_line1 | Account address | Street and building number | Type: string The street and building number on the account address. Example: 44 Ashgrove Road |
| acct_ad_line2 | Account address | Apartment number | Type: string The apartment or flat number on the account address. Example: Apt. 15 |
| acct_ad_state | Account address | State | Type: string The state or another unit of administrative division on the account address. Example: VA, Bavaria, New York |
| acct_ad_zip | Account address | Postal code | Type: string The postal code on the account address. Example: 10179 |
| cust_existing | Customer | Existing with payment company | Type: bool Indicates whether the customer has an account with the payment company. |
| cust_existing_merchant | Customer | Existing with merchant | Type: bool Indicates whether the customer has an account with the merchant. |
| cust_forgot_password | Customer | Forgot password | Type: bool Indicates whether the customer forgot the password for their account on the e-commerce platform. |
| cust_has_password | Customer | Has password | Type: bool Indicates whether the customer has a password for their account on the e-commerce platform. |
| cust_last_login_ts | Account | Last login | Type: timestamp The date of the last login of the customer. Relevant if the customer has a user account on the merchant's e-commerce platform. Example: 2019-02-04T15:04:05Z |
| cust_signup_dt | Account | Signup date | Type: string The date when the customer signed up for the merchant's e-commerce platform. An RFC3339-encoded UTC timestamp. Example: 2017-12-09Z |
| cust_signup_ts | Account | Signup timestamp | Type: timestamp An RFC3339-encoded UTC timestamp when the customer signed up for the merchant's e-commerce platform, i.e. created their account with the merchant. |
| customer_account_number | Customer | Account number | Type: string The account number of the customer in the merchant's database. Example: 2364 |
| password_update_ts | Account | Password update timestamp | Type: timestamp An RFC3339-encoded UTC timestamp indicating when the customer last updated their password on the e-commerce platform. |
General | Billing Address
| Name | Display Name | Description |
|---|---|---|
| bill_ad_city | Billing address | City | Type: string The city on the billing address. Example: Berlin |
| bill_ad_city_norm_dp | Billing address | City normalized by the payment company | Type: string The normalized value of the city on the billing address provided by the payment company. Example: buenosaires, newyork |
| bill_ad_ctry | Billing address | Country | Type: enum The country on the billing address. An ISO 3166-1 alpha-2 code. |
| bill_ad_ctry_norm_dp | Billing address | Country normalized by payment company | Type: enum The normalized value of the country on the billing address provided by the payment company. |
| bill_ad_first_name | Billing address | First name | Type: string The first name of the customer on the billing address. Example: Grace |
| bill_ad_house_num | Billing address | House number | Type: string The house number on the billing address. Example: 4, 40/1 |
| bill_ad_house_num_norm_dp | Billing address | House number normalized | Type: string The normalized value of the house number on the billing address. Example: 4, 40 |
| bill_ad_last_name | Billing address | Last name | Type: string The last name of the customer on the billing address. Example: Hopper |
| bill_ad_line1 | Billing address | Street and building number | Type: string The street and building number on the billing address. Example: Hartwigstraße 27 |
| bill_ad_line1_norm_dp | Billing address | Street and building number normalized by payment company | Type: string The normalized value of the street and building number on the billing address. Example: Hartwigstr. |
| bill_ad_line2 | Billing address | Apartment number | Type: string The apartment or flat number on the billing address. Example: Apt. 15 |
| bill_ad_line3 | Billing address | Additional info | Type: string Additional address information on the billing address. Example: 2nd floor |
| bill_ad_line3_norm_dp | Billing address | Additional info normalized by payment company | Type: string The normalized value of additional details on the billing address provided by the payment company. Example: 2nd floor – left side, 2nd floor |
| bill_ad_middle_name | Billing address | Middle name | Type: string The middle name of the customer on the billing address. Example: Brewster Murray |
| bill_ad_name | Billing address | Full name | Type: string The full name of the customer on the billing address. 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. Example: Grace Hopper |
| bill_ad_state | Billing address | State | Type: string The state or another unit of administrative division on the billing address. Example: New York, Bavaria |
| bill_ad_zip | Billing address | Postal code | Type: string The postal code on the billing address. Example: 10179 |
| bill_ad_zip_norm_dp | Billing address | Postal code normalized | Type: string The normalized value of the postal code on the billing address. Example: 78467 |
| bill_name_title | Billing address | Courtesy title | Type: string The courtesy title of the customer on the billing address. Example: Dr. |
General | Customer Identity
| Name | Display Name | Description |
|---|---|---|
| cust_company | Customer | Company name | Type: string The company name of the customer. Example: Schön Klinik München Harlaching |
| cust_dob | Customer | Date of birth | Type: date The date of birth of the customer. Example: 1906-12-09Z |
| cust_email | Customer | Email address | Type: string The primary email address of the customer. Example: [email protected] |
| cust_first_name | Customer | First name | Type: string The first name of the customer. Example: Grace |
| cust_gender | Customer | Gender | Type: string The gender of the customer. Example: F |
| cust_id | Customer | ID as per merchant | Type: string The ID of the customer in the merchant's database. Example: 7730468, 4738 |
| cust_last_name | Customer | Last name | Type: string The last name of the customer. Example: Hopper |
| cust_middle_name | Customer | Middle name | Type: string The middle name of the customer. Example: Brewster Murray |
| cust_name | Customer | Full name | Type: string The 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. Example: Grace Brewster Murray Hopper |
| cust_nationality | Customer | Nationality | Type: string The nationality of the customer. Example: Italian |
| cust_scndry_email | Customer | Secondary email address | Type: string The secondary email address of the customer. Example: [email protected] |
| cust_title | Customer | Courtesy title | Type: string The courtesy title of the customer. Example: Dr. |
| customer_is_of_age | Customer | Is of age | Type: bool Specifies if the customer is of age, i.e. old enough, according to the law, to be eligible for certain purchases. |
| customer_username | Customer | Username | Type: string Specifies the username of the customer they created for the e-commerce account/product they are using. Example: gamer_42 |
| customer_verified_account | Customer | Verified account | Type: bool Indicates if user's account has been verified. Different products offer different verification processes, i.e. via an email address or a code. This normally depends on the type of the registration system. |
| fax | Customer | Fax number | Type: string The fax number of the customer. Example: 030-1781224 |
| phone | Customer | Phone | Type: string The phone number of the customer. Example: +49(0)8144111100 |
| phone_mobile | Customer | Mobile phone number | Type: string The customer's mobile phone number. Example: 017624225600 |
| phone_type | Phone | Type | Type: string The type of the phone used by the customer. Example: Work |
| phone_work | Phone | Work | Type: string The phone number of the customer marked as the work phone. Example: +49(0)8144111100 |
| scndry_phone | Customer | Secondary phone | Type: string The secondary phone number of the customer. Example: 017624225600 |
General | Device
| Name | Display Name | Description |
|---|---|---|
| browser_user_agent | Browser | User agent | Type: string The web browser user agent. Example: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/66.0.3359.181 Safari/537.36 |
| brwsr_addons | Browser | Add-ons | Type: string A list of add-ons installed on user's browser. Example: Adblock Plus, FeedsPlus, Affine |
| brwsr_lang | Browser | Language | Type: string The language of the customer's web browser. Example: en-US |
| brwsr_ts | Browser | Timestamp | Type: timestamp Web browser timestamp at the time of the purchase. Example: 2017-12-03T11:52:06Z |
| brwsr_type | Browser | Type | Type: string The type of the customer's web browser. Example: Firefox |
| brwsr_version | Browser | Version | Type: string The version of the customer's web browser. Example: 65.0.2 (64-bit) |
| device_crt_ts | Device | Timestamp | Type: timestamp The timestamp on the device when the transaction happened. |
| device_manufacturer | Device | Manufacturer | Type: string The manufacturer of the customer's device. Example: Samsung |
| device_name | Device | Name | Type: string The name of the customer's device. Example: Grace’s MacBook Pro |
| device_type | Device | Type | Type: string The device type of the customer. Example: iPhone |
| device_version | Device | Version | Type: string The version of the customer's device. Example: 4.1 |
| os_lang | OS | Language | Type: string Language of the operating system on the customer's device. Example: en-GB |
| os_ts | OS | Timestamp | Type: timestamp The operating system timestamp at the time of the purchase. Example: 2017-12-03T11:52:06Z |
| os_type | OS | Type | Type: string Type of the customer's operating system. Example: iOS 10.1.1 |
| os_version | OS | Version | Type: string The version of the operating system on the customer's device. Example: macOS Mojave 10.14.3 |
| screen_dpi | Screen | DPI | Type: string The DPI (dots per inch) value of customer's screen. Example: 120 x 120 |
| screen_x | Screen | Horizontal resolution | Type: string The horisontal (x-axis) value of the customer's screen resolution. Example: 800 |
| screen_y | Screen | Vertical resolution | Type: string The vertical (y-axis) value of the customer's screen resolution. Example: 600 |
| support_cookie | Browser | Cookie support | Type: bool Indicates if the user's browser supports and is not blocking cookies. |
| support_flash | Browser | Flash support | Type: bool Indicates if the user's browser supports Flash. |
| support_geo | Browser | Geolocation support | Type: bool Indicates if the user's browser supports geolocation. |
| support_java | Browser | Java support | Type: bool Indicates if the user's browser supports Java. |
| support_js | Browser | JavaScript support | Type: bool Indicates if the user's browser supports JavaScript. |
| device_fingerprint | Device | Fingerprint | Type: DeviceInfo Device fingerprint collected from the user's device. |
General | Device Id
| Name | Display Name | Description |
|---|---|---|
| device_id | Device | ID | Type: string Device identification code. Example: 2fc4b5912826ad1 |
| device_id_exact | Device | Exact ID | Type: string Exact 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. Example: ATHjII4ALRQySeFH1hmaC5svTtgg |
| device_id_smart | Device | Smart ID | Type: string Smart 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. Example: AGlYUjsSx4fCMnEfrNSFQVqoXjko |
| device_reputation | Device | Reputation | Type: string Specific reputation and/or behavior associated with a device. This information is provided by a third-party provider of your choice or generated by you internally. You normally send this datapoint with 'device_id' and 'device_score'. Example: risky_device_behavior, risky_ip_reputation, risky_ip_behavior |
| device_score | Device | Score | Type: float The score of the device generated by a third-party provider of your choice or by you internally. You normally send this datapoint with 'device_id' and 'device_reputation'. Example: 42.01 |
General | Ip Address
| Name | Display Name | Description |
|---|---|---|
| ip | IP | Type: string The IP address of the customer. Example: 192.168.0.1 |
| ip_hashed | IP | Hashed value | Type: string The hashed value of the IP address. Example: 6023d6a87eec89bf628b2520434a1065ac4da0e0 |
General | Merchant
| Name | Display Name | Description |
|---|---|---|
| platform_id | Platform ID | Type: string The name of the payment platform. Example: GlobalCollect |
| seller_id | Merchant | ID | Type: string The identification code of the merchant. Example: ABG826 |
| slr_asp | Merchant | Average sales price | Type: float The ASP (average sales price) of the merchant. Example: 5.99 |
| slr_crncy | Merchant | Currency | Type: enum The operating currency of the merchant. |
| slr_ctry | Merchant | Country | Type: enum The country where the merchant operates. An ISO 3166-1 alpha-2 code. You can either have this configured in the configuration service or send this information in the API request. |
| slr_ind | Merchant | Industry | Type: string The industry where the merchant operates. You can either have this configured in the configuration service or send this information in the API request. Example: Perfumery/duty free |
| slr_ind_cat | Merchant | Industry category | Type: string The industry category of the merchant. You can either have this configured in the configuration service or send this information in the API request. Example: 3 Retail |
| slr_ind_mcc | Merchant | MCC | Type: string The 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. Example: 5641 |
| slr_name | Merchant | Name | Type: string The name of the merchant. You can either have this configured in the configuration service or send this information in the API request. Example: Square Enix |
| sub_seller | Sub-merchant | ID | Type: string The identification code of the sub-merchant. Example: 8897 |
General | Purchase
| Name | Display Name | Description |
|---|---|---|
| affiliate_partner | Purchase | Affiliate partner | Type: string Indicates the affiliate partner that generated the customer. Example: BigCommerce |
| agency_country | Purchase | Agency country name | Type: enum The country where the agency that facilitated the purchase operates. An ISO 3166-1 alpha-2 code. Send this datapoint optionally if you're sending 'agency_name'. |
| agency_name | Purchase | Agency name | Type: string The name of the agency that facilitated the purchase. Example: Clubhotel Reisen GmbH |
| booking_invoice_number | Booking | Invoice number | Type: string The invoice number for the booking transaction. Refers to the booking of any types of goods or services like a ticket, trip, etc. Example: 45738/2021 |
| booking_is_flexi | Booking | Flexible cancellation | Type: bool Indicates if the booking has flexible cancellation. This allows the customer to make changes to the departure date and time for example, or cancel the event/service all together. |
| booking_is_restricted | Booking | Restricted | Type: bool Indicates whether the booking is restricted (non-refundable). |
| booking_persons_number | Booking | Persons in the booking | Type: int The number of persons included in the booking. Example: 1 |
| delivery_method | Purchase | Delivery method | Type: enum Indicates the delivery method of the purchased goods. |
| exchange_ticket_price | Ticket | Exchange price | Type: float The price of the exchange ticket before any discounts or vouchers are applied. Example: 155,70 |
| first_purchase | Purchase | First with the merchant | Type: bool Indicates if the user is making their first purchase with the merchant. For some products, the first purchase is considered less secure because the merchant doesn't have sufficient data to evaluate the user. |
| giftcard_message | Gift card | Message | Type: string The message added for the gift card being shipped. Example: Happy birthday! |
| includes_giftcard | Purchase | Includes gift card | Type: enum Indicates whether the purchase order includes gift cards as items. |
| includes_preorder | Purchase | Includes pre-ordered item | Type: bool Purchase includes one or more pre-ordered item. |
| item_is_subscription | Purchase | Subscription | Type: bool Indicates if the item purchased is a subscription. Generally, subscription products are less risky. |
| item_on_sale | Purchase | Item on sale | Type: bool Indicates if the item was purchased during a sale. |
| item_preorder | Purchase | Preorder | Type: bool Indicates if the purchased item is a preorder. Generally, preordered purchases are way less risky. |
| items | Purchase | Items | Type: ShoppingCartItem[] The attribute represents items in the shopping cart of the customer. Example: [ {"item_id":"DF42","item_desc":"Belt"} ] |
| loyalty_account_number | Purchase | Loyalty account number | Type: string The loyalty account number of the customer. Send this datapoint if you're sending 'loyalty_program_used = true'. Example: 2934-YS |
| loyalty_program_name | Purchase | Loyalty program name | Type: string Indicates what loyalty program the customer is part of. Send this datapoint if you're sending 'loyalty_program_used = true'. Example: SkyMiles |
| loyalty_program_used | Purchase | Loyalty program | Type: bool Indicates whether the customer belongs to a loyalty program. |
| order_id | Merchant | Order ID | Type: string The 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 transaction ID created by shufti ('frg_trans_id'). Example: 1128-4000050556-1 |
| order_method | Merchant | Order method | Type: enum The method used to make the order. |
| purchase_extra_services | Purchase | Extra services ordered | Type: enum Indicates any extra services that were ordered with the purchase. |
| region_locked | Purchase | Region locked | Type: enum Region locking prevents a product from being purchased and/or used outside of a region. The datapoint specifies if an item is locked to a specific region, i.e. can only be bought/used in that region. Often applies to video games or digital products. |
| sales_channel | Transaction | Sales channel | Type: enum The transaction's sales channel. |
| ship_comments | Purchase | Shipping comments | Type: string Additional comments regarding the shipping of the goods. Example: Deliver to the neighbor. |
| ship_giftcard_message | Gift card | Shipping message | Type: string The message of the shipping gift card. Example: Happy birthday! |
| ship_giftcard_type | Gift card | Type | Type: string The type of gift card being shipped. Example: Grandparents Day |
| ship_more | Purchase | Additional shipping comments | Type: string Additional shipping information. Example: 4th floor – left side |
| subscription_active | Purchase | Subscription active | Type: bool Indicates if the customer has an active subscription with the merchant. |
| subscription_end_date | Purchase | Subscription end date | Type: date Indicates the end date of an active subscription. If there is no active subscription available, use this datapoint to indicate the end date of the most recent subscription. The date part of an RFC3339-encoded UTC timestamp. Example: 2021-10-04T |
| third_party_booking | Purchase | Third-party booking | Type: bool Indicates whether the booking was made by a third-party entity. |
| ticket_currency | Purchase | Ticket currency | Type: enum The SO-3 currency code in which 'ticket_price' is given. |
| ticket_device_used | Purchase | Device and app type | Type: enum Indicates the device and app type used to make the booking for a ticket. |
| ticket_exchange_fee | Ticket | Exchange fee | Type: float The fee applied for exchanging an issued ticket. Example: 50,00 |
| ticket_issue_date | Ticket | Issue date | Type: timestamp An RFC3339-encoded UTC timestamp indicating the date when the ticket was issued. Example: 2021-10-04T15:20:44 |
| ticket_itinerary_legs_count | Ticket | Itinerary legs | Type: int Trip path information, i.e. the number of legs in the itinerary. Example: 2 |
| ticket_price | Purchase | Ticket price | Type: float The full price of the ticket before any discounts or vouchers are applied. Example: 349 |
| ticket_transaction_type | Ticket | Transaction type | Type: enum The type of transaction carried out for the ticket. |
| time_from_first_visit | Purchase | Time from first visit | Type: int Indicates the number of days that have passed from the moment a customer first visited the e-commerce site and the moment when they initiated the transaction. This period of time covers multiple browser sessions. |
| time_to_purchase | Purchase | Time to purchase | Type: int Indicates the number of seconds that have passed from the moment a customer accessed the e-commerce website to the moment when they initiated the transaction. Use this datapoint to indicate the time within one browser session. |
| voucher_used | Purchase | Promo voucher used | Type: bool Indicates if the item was purchased with a promo voucher. |
General | Shipping Address
| Name | Display Name | Description |
|---|---|---|
| packstation_id_dp | Shipping address | DHL Packstation ID | Type: string A 3-digit ID of a DHL Packstation. Use this datapoint in rules if you're sending this information in the API request. If you'd like this information to be calculated by shufti, use 'packstation_id' instead. Make sure you send the datapoint 'ship_ad_line1' in this case. Example: 123, 445 |
| postnummer_dp | Shipping address | Personal customer number | Type: string The personal customer number (Postnummer) used at the DHL Packstation. Use this datapoint in rules if you're sending this information in the API request. If you'd like this information to be calculated by shufti, use 'postnummer' instead. Make sure you send the datapoint 'ship_ad_line1' in this case. Example: 12345678, 44566741 |
| ship_ad_city | Shipping address | City | Type: string The city on the shipping address. Example: London |
| ship_ad_city_norm_dp | Shipping address | City normalized by the payment company | Type: string The normalized value of the city on the shipping address provided by the payment company. Example: buenosaires, newyork |
| ship_ad_ctry | Shipping address | Country | Type: enum The country on the shipping address. An ISO 3166-1 alpha-2 code. |
| ship_ad_ctry_norm_dp | Shipping address | Country normalized by payment company | Type: enum The normalized value of the country on the shipping address provided by the payment company. |
| ship_ad_email | Shipping address | Email | Type: string The email address of the customer on the shipping address. Example: [email protected] |
| ship_ad_first_name | Shipping address | First name | Type: string The first name of the customer on the shipping address. Example: Grace |
| ship_ad_house_num | Shipping address | House number | Type: string The house number on the shipping address. Example: 7, 27/4 |
| ship_ad_house_num_norm_dp | Shipping address | House number normalized by payment company | Type: string The normalized value of the house number on the shipping address provided by the payment company. Example: 4, 40 |
| ship_ad_last_name | Shipping address | Last name | Type: string The last name of the customer on the shipping address. Example: Hopper |
| ship_ad_line1 | Shipping address | Street and building number | Type: string The street and building number on the shipping address. Example: 44 Ashgrove Road |
| ship_ad_line1_norm_dp | Shipping address | Street and building number normalized by payment company | Type: string The normalized value of the street and building number on the shipping address provided by the payment company. Example: 44 Ashgrove Road |
| ship_ad_line2 | Shipping address | Apartment number | Type: string The apartment or flat number on the shipping address. Example: Apt. 4 |
| ship_ad_line3 | Shipping address | Additional info | Type: string Further additional address information on the shipping address. Example: 2nd floor – left side, 2nd floor |
| ship_ad_line3_norm_dp | Shipping address | Additional info normalized | Type: string The normalized value of additional details on the shipping address. Example: 2nd floor |
| ship_ad_middle_name | Shipping address | Middle name | Type: string The middle name of the customer on the shipping address. Example: Brewster Murray |
| ship_ad_name | Shipping address | Full name | Type: string The full name of the customer on the shipping address. 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. Example: Grace Brewster Murray Hopper |
| ship_ad_phone | Shipping address | Phone number | Type: string The phone number that the customer specified for the shipping address. Example: 030-4247582047 |
| ship_ad_state | Shipping address | State | Type: string The state or another unit of administrative division on the shipping address. Example: New York, Bavaria |
| ship_ad_zip | Shipping address | Postal code | Type: string The postal code on the shipping address. Example: 10179 |
| ship_ad_zip_norm_dp | Shipping address | Postal code normalized by payment company | Type: string The normalized value of the postal code on the shipping address provided by the payment company. Example: 10179 |
| ship_name_title | Shipping address | Courtesy title | Type: string The courtesy title of the customer on the shipping address. Example: Dr. |
General | Transaction
| Name | Display Name | Description |
|---|---|---|
| acquirer_ctry | Transaction | Acquirer country | Type: enum The country of the acquiring bank. An ISO 3166-1 alpha-2 code. |
| custom | Custom attributes | Type: custom An object that contains arbitrary fields not directly managed by shufti. Can be sent with each transaction and used for rule creation. |
| is_3ds_approved | Transaction | Is 3D approved | Type: enum Indicates whether the transaction was authenticated with 3D Secure. Relevant in cases where shufti is integrated after authentication and/or authorization. |
| is_recurring | Transaction | Is recurring | Type: bool Indicates whether a transaction is a subsequent transaction following a previous authorization. Please note that shufti cannot validate whether the transaction is indeed linked to a previous transaction flagged with the acquirer as starting a recurring operation. |
| recurrence_type | Transaction | Recurrence type | Type: string Specifies what recurrence type the transaction has. Only relevant to recurrent transactions. Example: FirstRecurring |
| trans_amt | Transaction | Amount | Type: float The transaction amount in the original currency. Example: 23.15 |
| trans_currency | Transaction | Currency | Type: enum SO-3 currency code in which 'trans_amt' is given. |
| trans_id | Transaction | ID | Type: string The ID of the transaction as identified by the PSP. Do not to confuse with the ID assigned by the merchant ('order_id') or the transaction ID created by shufti ('frg_trans_id'). Example: X1234567 |
| trans_is_b2b | Transaction | Is B2B | Type: bool Indicates if the transaction is a B2B transaction. |
| trans_status | Transaction | Status | Type: string Specifies the transaction approval status communicated by the client. Example: Approved, Declined |
| trans_ts | Transaction | Timestamp | Type: timestamp Transaction timestamp reported by the client. Example: 2009-11-10T23:00:00Z |
Industry | Airlines
| Name | Display Name | Description |
|---|---|---|
| airticket_agency_code | Airlines | IATA agency code | Type: string IATA code for the travel agency that issued the ticket. Example: 13-3 4637 004 |
| airticket_airline_name | Airlines | Airline name | Type: string The name of the airline. Example: Lufthansa, Delta |
| airticket_arrival_ts | Airlines | Arrival timestamp | Type: timestamp An RFC3339-encoded UTC timestamp indicating the local date and time of the arrival. The timezone accepts either the character 'Z' to indicate UTC or a time offset in the format '+02:00' or '-07:30'. Example: 2021-11-10T23:00:00Z |
| airticket_booking_pos_city | Airlines | Booking (POS) city | Type: string The city where the customer made the payment for the ticket and where sales taxes may become applicable. Example: Santiago |
| airticket_class | Airlines | Ticket class | Type: enum IATA code for the class of service for the leg of the trip. The code is used by airlines to identify a fare type and corresponding services applicable to that fare. |
| airticket_days_to_departure | Airlines | Days to departure | Type: int Indicates the number of days before the airplane departure. Example: 3 |
| airticket_delivery_method | Airlines | Ticket delivery method | Type: string The delivery method for the airline ticket. Example: electronic |
| airticket_departure_ts | Airlines | Departure timestamp | Type: timestamp An RFC3339-encoded UTC timestamp indicating the local date and time of the departure. The timezone accepts either the character 'Z' to indicate UTC or a time offset in the format '+02:00' or '-07:30'. Example: 2009-11-10T23:00:00Z |
| airticket_electronic_ticket | Airlines | Electronic ticket | Type: bool Indicates whether the ticket booking was made electronically. |
| airticket_first_departure_airport | Airlines | First departure airport | Type: string IATA code for the first departure airport in the itinerary. Example: BER |
| airticket_issuer_address | Airlines | Issuer address | Type: string The address of the company issuing the ticket. Example: Place Georges-Pompidou, 75004 Paris |
| airticket_issuer_name | Airlines | Issuer name | Type: string The name of the ticket issuer. May differ from the airline name. Example: ExpediaTravel |
| airticket_last_arrival_airport | Airlines | Last arrival airport | Type: string IATA code for the last arrival airport in the itinerary. Example: NAP |
| airticket_leg1_arrival_airport | Airlines | Arrival airport | Leg 1 | Type: string IATA code for the arrival airport in the first leg of the trip. Example: FCO |
| airticket_leg1_arrival_time_segment | Airlines | Arrival time segment | Leg 1 | Type: enum The arrival time segment for the first leg of the trip. |
| airticket_leg1_arrival_ts | Airlines | Arrival time | Leg 1 | Type: timestamp An RFC3339-encoded UTC timestamp indicating the local date and time of the arrival for the first leg of the trip. The timezone accepts either the character 'Z' to indicate UTC or a time offset in the format '+02:00' or '-07:30'. Example: 2021-10-04T15:20:44 |
| airticket_leg1_carrier_code | Airlines | IATA carrier code | Leg 1 | Type: string IATA code for the airline for the first leg of the trip. Example: 7H |
| airticket_leg1_class | Airlines | Ticket class | Leg 1 | Type: enum IATA code for the class of service for the first leg of the trip. The code is used by airlines to identify a fare type and corresponding services applicable to that fare. |
| airticket_leg1_departure_airport | Airlines | Departure airport | Leg 1 | Type: string IATA code for the departure airport in the first leg of the trip. Example: FCO |
| airticket_leg1_departure_time_segment | Airlines | Departure time segment | Leg 1 | Type: enum The departure time segment for the first leg of the trip. |
| airticket_leg1_departure_ts | Airlines | Departure time | Leg 1 | Type: timestamp An RFC3339-encoded UTC timestamp indicating the local date and time of the departure for the first leg of the trip. The timezone accepts either the character 'Z' to indicate UTC or a time offset in the format '+02:00' or '-07:30'. Example: 2021-10-04T15:20:44 |
| airticket_leg1_flight_number | Airlines | Flight number | Leg 1 | Type: string The flight number for the first leg of the trip. Example: DF3409 |
| airticket_leg1_price | Airlines | Ticket price | Leg 1 | Type: float The full price of the ticket for the first leg of the trip, before any discounts or vouchers are applied. Example: 49,99 |
| airticket_leg1_stopover | Airlines | Stopover allowed | Leg 1 | Type: bool Indicates whether a stopover is allowed on the first leg of the trip. |
| airticket_leg2_arrival_airport | Airlines | Arrival airport | Leg 2 | Type: string IATA code for the arrival airport in the second leg of the trip. Example: CDG |
| airticket_leg2_arrival_time_segment | Airlines | Arrival time segment | Leg 2 | Type: enum The arrival time segment for the second leg of the trip. |
| airticket_leg2_arrival_ts | Airlines | Arrival time | Leg 2 | Type: timestamp An RFC3339-encoded UTC timestamp indicating the local date and time of the arrival for the second leg of the trip. The timezone accepts either the character 'Z' to indicate UTC or a time offset in the format '+02:00' or '-07:30'. Example: 2021-10-04T15:20:44 |
| airticket_leg2_carrier_code | Airlines | IATA carrier code | Leg 2 | Type: string IATA code for the airline for the second leg of the trip. Example: 7H |
| airticket_leg2_class | Airlines | Ticket class | Leg 2 | Type: enum IATA code for the class of service for the second leg of the trip. The code is used by airlines to identify a fare type and corresponding services applicable to that fare. |
| airticket_leg2_departure_airport | Airlines | Departure airport | Leg 2 | Type: string IATA code for the departure airport in the second leg of the trip. Example: FCO |
| airticket_leg2_departure_time_segment | Airlines | Departure time segment | Leg 2 | Type: enum The departure time segment for the second leg of the trip. |
| airticket_leg2_departure_ts | Airlines | Departure time | Leg 2 | Type: timestamp An RFC3339-encoded UTC timestamp indicating the local date and time of the departure for the second leg of the trip. The timezone accepts either the character 'Z' to indicate UTC or a time offset in the format '+02:00' or '-07:30'. Example: 2021-10-04T15:20:44 |
| airticket_leg2_flight_number | Airlines | Flight number | Leg 2 | Type: string The flight number for the second leg of the trip. Example: DF3409 |
| airticket_leg2_price | Airlines | Ticket price | Leg 2 | Type: float The full price of the ticket for the second leg of the trip, before any discounts or vouchers are applied. Example: 49,99 |
| airticket_leg2_stopover | Airlines | Stopover allowed | Leg 2 | Type: bool Indicates whether a stopover is allowed on the second leg of the trip. |
| airticket_loyalty_program_num | Airlines | Loyalty account number | Type: string The number of the customer that belongs to a loyalty program. Send this datapoint if you're sending 'airticket_loyalty_program_used = true'. Example: 2934-YS |
| airticket_nr | Airlines | Ticket number | Type: string A 13-digit number that uniquely identifies the issued airline ticket. Example: 8382124676356 |
| airticket_pnr | Airlines | Passenger name record | Type: string The passenger name record for the ticket. Example: 230-U8F16G |
| airticket_purchase_type | Airlines | Purchase type | Type: enum Indicates the type of purchase in the booking. |
| airticket_third_party_booking | Airlines | Third-party booking | Type: bool Indicates whether the booking was made by a third-party entity. |
Industry | Digital
| Name | Display Name | Description |
|---|---|---|
| digital_delivery_email | Digital | Delivery email | Type: string The email address where the digital product is supposed to be delivered. Example: [email protected] |
| digital_event_date | Digital | Event date | Type: date Indicates the date of the event the customer is buying tickets for. The date part of an RFC3339 -encoded UTC timestamp. Example: 2021-10-04T |
| digital_lifetime_license | Digital | Lifetime license | Type: bool Indicates if the customer has a lifetime subscription with a merchant. |
| digital_product_category | Digital | Product category | Type: enum Indicates the category of digital products purchased by the customer. This datapoint has a less granular categorization than 'digital_product_type'. Use both to be able to write more granular rules. |
| digital_product_type | Digital | Product type | Type: enum Indicates the type of digital products purchased by the customer. This datapoint has a more granular categorization than 'digital_product_category'. Use both to be able to write more granular rules. |
Industry | Gaming
| Name | Display Name | Description |
|---|---|---|
| gaming_donatable_item | Gaming | Donatable item | Type: bool Specifies if the item purchased is donatable. |
| gaming_locked_country | Gaming | Locked country availability | Type: enum Indicates the country where an item is available. An ISO 3166-1 alpha-2 code. |
| gaming_platform | Gaming | Platform | Type: enum Specifies the platform where the game is available. |
| gaming_product_type | Gaming | Product type | Type: enum Specifies the type of the gaming product being purchased. |
| gaming_tutorial_finished | Gaming | Tutorial finished | Type: bool Indicates if the user finished the tutorial before initiating their first purchase. For some products, a purchase before completing the tutorial may indicate fraudulent activity. In some products, purchases are not available at all before the user completes a tutorial. |
| gaming_user_ranking | Gaming | User ranking | Type: string Indicates the status/ranking the user has reached in a product. In some cases, a lower/non-existent ranking may indicate fraudulent activity. Example: advanced |
Industry | Hotels
| Name | Display Name | Description |
|---|---|---|
| hotels_days_until_stay | Hotels | Days until stay begins | Type: int The number of days until the arrival at the hotel. Example: 25 |
| hotels_final_price | Hotels | Final price | Type: float The final amount that was paid for the stay at the hotel. The final amount is calculated after discounts, or gift cards are applied to the order total. Example: 435,50 |
| hotels_hotel_name | Hotels | Hotel name | Type: int The name of the hotel. Example: Grand Hotel Saint Lucia |
| hotels_lodging_days | Hotels | Lodging days | Type: int The number of lodging days at the hotel. Example: 14 |
| hotels_number_of_rooms | Hotels | Rooms in the booking | Type: int The number of rooms in the hotel booking. Example: 1 |
| hotels_payment_type | Hotels | Payment type | Type: enum The payment type used to pay for the stay at the hotel. |
| hotels_room_type | Hotels | Room type | Type: string The type of the hotel room. Example: Sea view suite |
| hotels_stay_end_date | Hotels | Stay end date | Type: date The date of the departure from the hotel. The date part of an RFC3339 -encoded UTC timestamp. Example: 2022-01-02Z |
| hotels_stay_incl_weekend | Hotels | Stay includes weekend | Type: bool Indicates if the stay at the hotel includes at least one weekend. |
| hotels_stay_start_date | Hotels | Stay start date | Type: date The date of the arrival at the hotel. The date part of an RFC3339 -encoded UTC timestamp. Example: 2022-01-02Z |
Payment Method | Bank Transfer
| Name | Display Name | Description |
|---|---|---|
| ba_bic | Bank account | BIC | Type: string The BIC (bank identifier code) of the bank account. Up to 11 characters. Example: DEUTDEDBBER, BOFIIE2D |
| ba_first_name | Bank account | Account holder first name | Type: string The first name of the bank account holder. Example: Grace |
| ba_iban | Bank account | IBAN | Type: string IBAN (International bank account number). Up to 34 alphanumeric characters. Example: IE64BOFI90583812345678 |
| ba_last_name | Bank account | Account holder last name | Type: string The last name of the bank account holder. Example: Hopper |
| ba_middle_name | Bank account | Account holder middle name | Type: string The middle name of the bank account holder. Example: Brewster Murray |
| ba_name | Bank account | Account holder full name | Type: string The full name of the bank account holder. Send this datapoint if you collect the full name. Otherwise send parts of the name separately in 'ba_first_name', 'ba_middle_name', and 'ba_last_name'. Example: Grace Brewster Murray Hopper |
| ba_rtn_num | Bank account | Routing number | Type: string The routing number of the bank account. Example: 122105155 |
| first_payment_day | Open invoice | First payment day | Type: int The day of the month for the first installment. Example: 1 |
| pmt_due_date | Open invoice | Payment due date | Type: date The date on which the invoice payment is due. Example: 2018-01-25Z |
Payment Method | Bnpl
| Name | Display Name | Description |
|---|---|---|
| bnpl_active_order | BNPL | Active order | Type: bool Indicates if the customer has an active order with the merchant and is still paying installments on it. |
| bnpl_active_order_count | BNPL | Active order count | Type: int The number of active orders the customer has and is still paying installments on. Example: 2 |
| bnpl_collection_frequency | BNPL | Collection frequency | Type: int Indicates the frequency of installment collections in weeks. Example: if the collection happens once a month, the frequency is defined as every 4 weeks. Example: 4 |
| bnpl_credit_check_performed | BNPL | Credit check performed | Type: bool Indicates if a credit check was performed for the customer. Use 'bnpl_credit_score' if you want to send the credit score also. |
| bnpl_credit_score | BNPL | Credit score | Type: int Indicates the credit score of the customer as assessed by you or a third-party provider. If you receive the result of a check as a range, please send either the lower or the higher value of the range in this datapoint, depending on your analytical needs. Example: 850 |
| bnpl_first_installment_due_date | BNPL | First installment | Due date | Type: timestamp An RFC3339-encoded UTC timestamp indicating the date on which the first installment is due. Example: 2019-02-04T15:04:05Z |
| bnpl_installments_count | BNPL | Installments count | Type: int The number of installments the customer chose to split their payment into. If the company provides only one specific number of installments for each purchase, specify it accordingly. Example: 3 |
| bnpl_missed_payment | BNPL | Missed payment | Type: bool Indicates if the customer has ever missed an installment payment on previous orders. |
| bnpl_missed_payment_count | BNPL | Missed payment count | Type: int Indicates the number of times the customer missed installment payments on previous orders. Example: 5 |
| bnpl_order_count | BNPL | Order count | Type: int This count indicates the number of times the customer placed an order with this merchant. Example: 4 |
| bnpl_order_paid_off | BNPL | Previous order paid off | Type: bool Indicates if the customer paid off all the installments of the previous order. If the customer has had more than one order with the merchant, consider the latest order. |
| bnpl_previous_order_value | BNPL | Previous order value | Type: float Indicates the total value of the items in the previous order. Example: 159,99 |
Payment Method | Cards
| Name | Display Name | Description |
|---|---|---|
| bin_ctry | BIN | Country | Type: enum The country of the credit card issuer. An ISO 3166-1 alpha-2 code. |
| cc_bin | BIN | Number | Type: string The BIN number of the credit card (the first 6 digits). Example: 572543 |
| cc_cardholder | Credit card | Cardholder full name | Type: string The 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'. Example: Grace Brewster Murray Hopper |
| cc_exp_dt | Credit card | Expiry date | Type: string The expiry date of the credit card in format MMYYYY. Example: 042023 |
| cc_exp_month | Credit card | Expiry month | Type: string The expiry month of the credit card. Example: 10 |
| cc_exp_year | Credit card | Expiry year | Type: string The expiry year of the credit card. Example: 2020 |
| cc_first_name | Credit card | Cardholder first name | Type: string The first name of the credit card holder. Example: Grace |
| cc_last_4_dig | Credit card | Last 4 digits | Type: string The last 4 digits of the credit card. Example: 1234 |
| cc_last_name | Credit card | Cardholder last name | Type: string The last name of the credit card holder. Example: Hopper |
| cc_middle_name | Credit card | Cardholder middle name | Type: string The middle name of the credit card holder. Example: Brewster Murray |
| cc_num_hash | Credit card | Hashed number | Type: string The 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'. Example: 6T5tdyWRiuhPuFhupAZYZzFESBYrOiOoYyqO8Zb4WEw= |
| cc_num_type | Credit card | Number type | Type: string The type of the credit card number. Example: PAN |
| cc_num | Credit card number | Type: string The credit card number (PAN) of the customer. It gets replaced with a token when it reaches the shufti PCI-compliant environment. Example: 1111222233334444555566 |
| cc_sub_brand | Credit card | Sub-brand | Type: string The sub-brand of the credit card. Example: Visa Online |
| cvc | Credit card | CVC | Type: string The CVC (card verification code). The 3 digits on the back of the card. Example: 123 |
| cvc_error_code | Credit card | CVC error code | Type: string The error code captured for the CVC information. Example: 103 |
| cvc_error_message | Credit card | CVC error message | Type: string The error message captured for the CVC information. Example: CVC is not the right length. |
| cvc_source | Credit card | CVC source | Type: string The source of the CVC value. Example: GeneralValidation |
Payment Method | General
| Name | Display Name | Description |
|---|---|---|
| pmt_method | Transaction | Payment method | Type: enum The payment method used for the transaction. |
| pmt_method_brand | Transaction | Payment method brand | Type: enum Indicates the specific payment method brand used by the customer. |
Todo
| Name | Display Name | Description |
|---|---|---|
| cust_tmz_offset | Customer Timezone Offset | Type: string TODO. Example: -0500 |
AML Screening
| Name | Display Name | Description |
|---|---|---|
| aml_screening | AML Screening | Type: object AML screening object for the customer. |
| aml_screening.name | AML Screening Name | Type: object Name object used for AML screening checks. |
| aml_screening.name.full_name | AML Screening Full Name | Type: string Customer full name used for AML screening. Example: Sarah Martinez |
| aml_screening.filters | AML Screening Filters | Type: string[] AML filters to apply during screening. Example: Sanctions, PEP |
Beneficiary AML Screening
| Name | Display Name | Description |
|---|---|---|
| beneficiary_aml_screening | Beneficiary AML Screening | Type: object AML screening object for beneficiary screening. |
| beneficiary_aml_screening.name | Beneficiary AML Screening Name | Type: object Name object used for beneficiary AML checks. |
| beneficiary_aml_screening.name.full_name | Beneficiary AML Screening Full Name | Type: string Beneficiary full name used for AML screening. Example: Michael Chen |
| beneficiary_aml_screening.filters | Beneficiary AML Screening Filters | Type: string[] AML filters to apply for beneficiary screening. Example: Sanctions, Adverse Media |