Supported variables

2025-12-25 08:44

To enhance the precision and flexibility of risk management, Antom Shield provides multiple categories of rule configuration variables, covering general scenarios, industry-specific requirements, and personalized customization. By appropriately selecting and configuring these variables, you can develop more efficient and practical risk control rules tailored to different business models and real-time risk conditions, including:

Default variables
Industry variables

Default variables

The following are the built‑in common rule configuration variables in Antom Shield. Refer to the variables below to understand how to define effective rules.

Amount

Variable	Data type	Description
amount_in_usd	FLOAT	Total payment amount converted to USD.
amount_in_xyz	FLOAT	xyz represents the corresponding currency type (e.g., `amount_in_usd`). When configuring rules for non-USD currencies, the transaction amount will be automatically calculated and converted, with USD as the final display unit. The following currency options are supported for configuration: USD, CNY, EUR, SAR, GBP, JPY, CHF, CAD, AUD, SGD, HKD, SEK, MXN. For all these currencies, the base currency unit is used instead of subunits (e.g., US dollars instead of cents).

Card info

Variable	Data type	Description
card_bin	STRING	The Bank Identification Number (BIN) of the card used for payment. Usually the first six or eight digits of the card number.
card_brand	STRING	The brand of the card used for payment. The valid values include VISA, MASTERCARD, AMEX (American Express), DISCOVER, JCB, etc.
card_country	STRING	The issuing country of the card, represented by a two-letter country or region code.
card_success_amount_1d	FLOAT	The cumulative successful transaction amount (in USD) using the same payment card in the past 24 hours.
card_success_amount_3d	FLOAT	The cumulative successful transaction amount (in USD) using the same payment card in the past 72 hours.
card_success_amount_7d	FLOAT	The cumulative successful transaction amount (in USD) using the same payment card in the past 7 days.
card_success_amount_30d	FLOAT	The cumulative successful transaction amount (in USD) using the same payment card in the past 30 days.
card_success_amount_90d	FLOAT	The cumulative successful transaction amount (in USD) using the same payment card in the past 90 days.
card_success_count_1d	LONG	The cumulative successful transaction count using the same payment card in the past 24 hours.
card_success_count_3d	LONG	The cumulative successful transaction count using the same payment card in the past 72 hours.
card_success_count_7d	LONG	The cumulative successful transaction count using the same payment card in the past 7 days.
card_success_count_30d	LONG	The cumulative successful transaction count using the same payment card in the past 30 days.
card_success_count_90d	LONG	The cumulative successful transaction count using the same payment card in the past 90 days.
card_fail_count_1d	LONG	The cumulative failed transaction count using the same payment card in the past 24 hours.
card_fail_count_3d	LONG	The cumulative failed transaction count using the same payment card in the past 72 hours.
card_fail_count_7d	LONG	The cumulative failed transaction count using the same payment card in the past 7 days.
card_fail_count_30d	LONG	The cumulative failed transaction count using the same payment card in the past 30 days.
card_fail_count_90d	LONG	The cumulative failed transaction count using the same payment card in the past 90 days.
card_change_device_1d	LONG	The number of devices used with the same payment card in the past 24 hours. For example, if the same card was used by only one device in the past 24 hours, the input value is `1`.
card_change_device_3d	LONG	The number of devices used with the same payment card in the past 72 hours. For example, if the same card was used by only one device in the past 72 hours, the input value is `1`.
card_change_device_7d	LONG	The number of devices used with the same payment card in the past 7 days. For example, if the same card was used by only one device in the past 7 days, the input value is `1`.
card_change_device_30d	LONG	The number of devices used with the same payment card in the past 30 days. For example, if the same card was used by only one device in the past 30 days, the input value is `1`.
card_change_device_90d	LONG	The number of devices used with the same payment card in the past 90 days. For example, if the same card was used by only one device in the past 90 days, the input value is `1`.
card_change_user_1d	LONG	The number of buyers using the same payment card in the past 24 hours. For example, if a card was used by two buyers in the past 24 hours, the input value is `2`.
card_change_user_3d	LONG	The number of buyers using the same payment card in the past 72 hours. For example, if a card was used by two buyers in the past 72 hours, the input value is `2`.
card_change_user_7d	LONG	The number of buyers using the same payment card in the past 7 days. For example, if a card was used by two buyers in the past 7 days, the input value is `2`.
card_change_user_30d	LONG	The number of buyers using the same payment card in the past 30 days. For example, if a card was used by two buyers in the past 30 days, the input value is `2`.
card_change_user_90d	LONG	The number of buyers using the same payment card in the past 90 days. For example, if a card was used by two buyers in the past 90 days, the input value is `2`.

Buyer info

Variable	Data type	Description
user_success_amount_1d	FLOAT	In the past 24 hours, the total successful transaction amount of the same buyer (in USD).
user_success_amount_3d	FLOAT	In the past 72 hours, the total successful transaction amount of the same buyer (in USD).
user_success_amount_7d	FLOAT	In the past 7 days, the total successful transaction amount of the same buyer (in USD).
user_success_amount_30d	FLOAT	In the past 30 days, the total successful transaction amount of the same buyer (in USD).
user_success_amount_90d	FLOAT	In the past 90 days, the total successful transaction amount of the same buyer (in USD).
user_fail_count_1d	LONG	In the past 24 hours, the total failed transaction count of the same buyer.
user_fail_count_3d	LONG	In the past 72 hours, the total failed transaction count of the same buyer.
user_fail_count_7d	LONG	In the past 7 days, the total failed transaction count of the same buyer.
user_fail_count_30d	LONG	In the past 30 days, the total failed transaction count of the same buyer.
user_fail_count_90d	LONG	In the past 90 days, the total failed transaction count of the same buyer.
user_success_count_1d	LONG	In the past 24 hours, the total successful transaction count of the same buyer.
user_success_count_3d	LONG	In the past 72 hours, the total successful transaction count of the same buyer.
user_success_count_7d	LONG	In the past 7 days, the total successful transaction count of the same buyer.
user_success_count_30d	LONG	In the past 30 days, the total successful transaction count of the same buyer.
user_success_count_90d	LONG	In the past 90 days, the total successful transaction count of the same buyer.
user_change_card_1d	LONG	In the past 24 hours, the number of bank cards used by the buyer. For example, if the same buyer used only one bank card in the past 24 hours, the input value is `1`.
user_change_card_3d	LONG	In the past 72 hours, the number of bank cards used by the buyer. For example, if the same buyer used only one bank card in the past 72 hours, the input value is `1`.
user_change_card_7d	LONG	In the past 7 days, the number of bank cards used by the buyer. For example, if the same buyer used only one bank card in the past 7 days, the input value is `1`.
user_change_card_30d	LONG	In the past 30 days, the number of bank cards used by the buyer. For example, if the same buyer used only one bank card in the past 30 days, the input value is `1`.
user_change_card_90d	LONG	In the past 90 days, the number of bank cards used by the buyer. For example, if the same buyer used only one bank card in the past 90 days, the input value is `1`.
user_change_device_1d	LONG	In the past 24 hours, the number of devices used by the same buyer.
user_change_device_3d	LONG	In the past 72 hours, the number of devices used by the same buyer.
user_change_device_7d	LONG	In the past 7 days, the number of devices used by the same buyer.
user_change_device_30d	LONG	In the past 30 days, the number of devices used by the same buyer.
user_change_device_90d	LONG	In the past 90 days, the number of devices used by the same buyer.
user_change_ip_1d	LONG	In the past 24 hours, the number of IP addresses from which the same buyer initiated payments.
user_change_ip_3d	LONG	In the past 72 hours, the number of IP addresses from which the same buyer initiated payments.
user_change_ip_7d	LONG	In the past 7 days, the number of IP addresses from which the same buyer initiated payments.
user_change_ip_30d	LONG	In the past 30 days, the number of IP addresses from which the same buyer initiated payments.
user_change_ip_90d	LONG	In the past 90 days, the number of IP addresses from which the same buyer initiated payments.

Email info

Variable	Data type	Description
email_user_email	INSENSITIVE_STRING	The buyer's email address.

Shipping address info

Variable	Data type	Description
address_ship_to_country	INSENSITIVE_STRING	The country or region where the shipping address is located.
address_ship_to_state	INSENSITIVE_STRING	The name of the administrative division, country, or province where the shipping address is located.
address_ship_to_address1	INSENSITIVE_STRING	Shipping address line 1, such as street address, P.O. box, and company name.
address_ship_to_address2	INSENSITIVE_STRING	Shipping address line 2, such as apartment, suite, unit, and building information.
address_ship_to_full_address	INSENSITIVE_STRING	The full shipping address.
address_ship_to_country_inconsistent_card_country	BOOLEAN	Indicates whether the country or region of the shipping address is consistent with the country or region of the card issuer at the time the buyer initiates payment.
address_ship_to_country_inconsistent_ip_country	BOOLEAN	Indicates whether the country or region of the shipping address is consistent with the country or region of the buyer's IP address at the time the buyer initiates payment.
address_ship_to_change_card_country_1d	LONG	In the past 24 hours, the number of issuing countries associated with payments initiated by buyers from the same shipping address.
address_ship_to_change_card_country_3d	LONG	In the past 72 hours, the number of issuing countries associated with payments initiated by buyers from the same shipping address.
address_ship_to_change_card_country_7d	LONG	In the past 7 days, the number of issuing countries associated with payments initiated by buyers from the same shipping address.
address_ship_to_change_card_country_30d	LONG	In the past 30 days, the number of issuing countries associated with payments initiated by buyers from the same shipping address.
address_ship_to_change_card_country_90d	LONG	In the past 90 days, the number of issuing countries associated with payments initiated by buyers from the same shipping address.
address_ship_to_change_card_1d	LONG	In the past 24 hours, the number of payment cards associated with payments initiated by buyers from the same shipping address.
address_ship_to_change_card_3d	LONG	In the past 72 hours, the number of payment cards associated with payments initiated by buyers from the same shipping address.
address_ship_to_change_card_7d	LONG	In the past 7 days, the number of payment cards associated with payments initiated by buyers from the same shipping address.
address_ship_to_change_card_30d	LONG	In the past 30 days, the number of payment cards associated with payments initiated by buyers from the same shipping address.
address_ship_to_change_card_90d	LONG	In the past 90 days, the number of payment cards associated with payments initiated by buyers from the same shipping address.
address_ship_to_change_device_1d	LONG	In the past 24 hours, the number of payment devices associated with payments initiated by buyers from the same shipping address.
address_ship_to_change_device_3d	LONG	In the past 72 hours, the number of payment devices associated with payments initiated by buyers from the same shipping address.
address_ship_to_change_device_7d	LONG	In the past 7 days, the number of payment devices associated with payments initiated by buyers from the same shipping address.
address_ship_to_change_device_30d	LONG	In the past 30 days, the number of payment devices associated with payments initiated by buyers from the same shipping address.
address_ship_to_change_device_90d	LONG	In the past 90 days, the number of payment devices associated with payments initiated by buyers from the same shipping address.
address_ship_to_change_user_1d	LONG	In the past 24 hours, the number of buyers who have used the same shipping address.
address_ship_to_change_user_3d	LONG	In the past 72 hours, the number of buyers who have used the same shipping address.
address_ship_to_change_user_7d	LONG	In the past 7 days, the number of buyers who have used the same shipping address.
address_ship_to_change_user_30d	LONG	In the past 30 days, the number of buyers who have used the same shipping address.
address_ship_to_change_user_90d	LONG	In the past 90 days, the number of buyers who have used the same shipping address.
address_ship_to_fail_count_1d	LONG	In the past 24 hours, the number of transaction failures for the same shipping address.
address_ship_to_fail_count_3d	LONG	In the past 72 hours, the number of transaction failures for the same shipping address.
address_ship_to_fail_count_7d	LONG	In the past 7 days, the number of transaction failures for the same shipping address.
address_ship_to_fail_count_30d	LONG	In the past 30 days, the number of transaction failures for the same shipping address.
address_ship_to_fail_count_90d	LONG	In the past 90 days, the number of transaction failures for the same shipping address.

Device info

Variable	Data type	Description
device_type	INSENSITIVE_STRING	The type of device used when a buyer initiates a payment. Common values include `APP`, `WEB`, `WAP`, and `MINI_APP`.
device_success_amount_1d	FLOAT	The cumulative successful payment amount of the same payment device in the past 24 hours.
device_success_amount_3d	FLOAT	The cumulative successful payment amount of the same payment device in the past 72 hours.
device_success_amount_7d	FLOAT	The cumulative successful payment amount of the same payment device in the past 7 days.
device_success_amount_30d	FLOAT	The cumulative successful payment amount for the same payment device in the past 30 days.
device_success_amount_90d	FLOAT	The cumulative successful payment amount for the same payment device in the past 90 days.
device_change_card_country_1d	LONG	The number of issuing countries associated with the same payment device in the past 24 hours. For example, if the same device has associated with 2 issuing countries in the past 24 hours, the return value is `2`.
device_change_card_country_3d	LONG	The number of issuing countries associated with the same payment device in the past 72 hours. For example, if the same device has associated with 2 issuing countries in the past 24 hours, the return value is `2`.
device_change_card_country_7d	LONG	The number of issuing countries associated with the same payment device in the past 7 days. For example, if the same device has associated with 2 issuing countries in the past 7 days, the return value is `2`.
device_change_card_country_30d	LONG	The number of issuing countries associated with the same payment device in the past 30 days. For example, if the same device has associated with 2 issuing countries in the past 30 days, the return value is `2`.
device_change_card_country_90d	LONG	The number of issuing countries associated with the same payment device in the past 90 days. For example, if the same device has associated with 2 issuing countries in the past 90 days, the return value is `2`.
device_fail_count_1d	LONG	The number of failed payments by the same payment device in the last 24 hours.
device_fail_count_3d	LONG	The number of failed payments by the same payment device in the last 72 hours.
device_fail_count_7d	LONG	The number of failed payments for the same payment device in the last 7 days.
device_fail_count_30d	LONG	The number of failed payments on the same payment device in the last 30 days.
device_fail_count_90d	LONG	The number of failed payments on the same payment device in the last 90 days.

IP info

Variable	Data Type	Description
ip_city	INSENSITIVE_STRING	The name of the city, district, suburb, town, or village where the IP is located when the buyer initiates the payment.
ip_state	INSENSITIVE_STRING	The name of the administrative division, country, or province where the IP address is located when the buyer initiates the payment.
ip_country	INSENSITIVE_STRING	The country or region where the IP address is located when the buyer initiates the payment.
ip_country_inconsistent_card_country	BOOLEAN	Indicates whether the IP country in which the buyer initiates payment is consistent with the country in which the payment card is issued.

Industry variables

The following are industry variables designed by Antom Shield for different sectors (such as e‑commerce and travel).

Refer to the variables below to understand how to create effective rules for each industry.

E‑commerce industry

Variable	Data type	Description
address_ship_to_address1	INSENSITIVE_STRING	First line of the shipping address, such as street address, P.O. box, or company name.
address_ship_to_address2	INSENSITIVE_STRING	Second line of the shipping address, such as apartment, suite, unit, or building information.
address_ship_to_change_card_1d	LONG	Number of payment cards associated with payments sent from the same shipping address in the past 24 hours.
address_ship_to_change_card_3d	LONG	Number of payment cards associated with payments sent from the same shipping address in the past 72 hours.
address_ship_to_change_card_7d	LONG	Number of payment cards associated with payments sent from the same shipping address in the past 7 days.
address_ship_to_change_card_30d	LONG	Number of payment cards associated with payments sent from the same shipping address in the past 30 days.
address_ship_to_change_card_90d	LONG	Number of payment cards associated with payments sent from the same shipping address in the past 90 days.
address_ship_to_change_card_country_1d	LONG	Number of issuing countries of payment cards used from the same shipping address in the past 24 hours.
address_ship_to_change_card_country_3d	LONG	Number of issuing countries of payment cards used from the same shipping address in the past 72 hours.
address_ship_to_change_card_country_30d	LONG	Number of issuing countries of payment cards used from the same shipping address in the past 30 days.
address_ship_to_change_card_country_90d	LONG	Number of issuing countries of payment cards used from the same shipping address in the past 90 days.
address_ship_to_change_device_1d	LONG	Number of unique devices used for payments from the same shipping address in the past 24 hours.
address_ship_to_change_device_3d	LONG	Number of unique devices used for payments from the same shipping address in the past 72 hours.
address_ship_to_change_device_7d	LONG	Number of unique devices used for payments from the same shipping address in the past 7 days.
address_ship_to_change_device_30d	LONG	Number of unique devices used for payments from the same shipping address in the past 30 days.
address_ship_to_change_device_90d	LONG	Number of unique devices used for payments from the same shipping address in the past 90 days.
address_ship_to_change_user_1d	LONG	Number of buyers who used the same shipping address in the past 24 hours.
address_ship_to_change_user_3d	LONG	Number of buyers who used the same shipping address in the past 72 hours.
address_ship_to_change_user_7d	LONG	Number of buyers who used the same shipping address in the past 7 days.
address_ship_to_change_user_30d	LONG	Number of buyers who used the same shipping address in the past 30 days.
address_ship_to_change_user_90d	LONG	Number of buyers who used the same shipping address in the past 90 days.
address_ship_to_country	LONG	Country or region of the shipping address.
address_ship_to_country_inconsistent_card_country	BOOLEAN	Indicates whether the country/region of the shipping address and the country of the issuing bank match when the buyer initiates the transaction.
address_ship_to_country_inconsistent_ip_country	BOOLEAN	Indicates whether the country/region of the shipping address matches the buyer’s IP location when the payment is initiated.
address_ship_to_fail_count_1d	LONG	Number of failed transactions associated with the same shipping address in the past 24 hours.
address_ship_to_fail_count_3d	LONG	Number of failed transactions associated with the same shipping address in the past 72 hours.
address_ship_to_fail_count_7d	LONG	Number of failed transactions associated with the same shipping address in the past 7 days.
address_ship_to_fail_count_30d	LONG	Number of failed transactions associated with the same shipping address in the past 30 days.
address_ship_to_fail_count_90d	LONG	Number of failed transactions associated with the same shipping address in the past 90 days.
address_ship_to_full_address	INSENSITIVE_STRING	Complete shipping address.
address_ship_to_state	LONG	Administrative division, state, or province of the shipping address.
phone_ship_phone_change_card_country_1d	LONG	Number of issuing countries of cards linked to the same shipping phone number in the past 24 hours.
phone_ship_phone_change_card_country_3d	LONG	Number of issuing countries of cards linked to the same shipping phone number in the past 72 hours.
phone_ship_phone_change_card_country_7d	LONG	Number of issuing countries of cards linked to the same shipping phone number in the past 7 days.
phone_ship_phone_change_card_country_30d	LONG	Number of issuing countries of cards linked to the same shipping phone number in the past 30 days.
phone_ship_phone_change_card_country_90d	LONG	Number of issuing countries of cards linked to the same shipping phone number in the past 90 days.
phone_ship_phone_change_user_1d	LONG	Number of buyers who used the same shipping phone number in the past 24 hours.
phone_ship_phone_change_user_3d	LONG	Number of buyers who used the same shipping phone number in the past 72 hours.
phone_ship_phone_change_user_7d	LONG	Number of buyers who used the same shipping phone number in the past 7 days.
phone_ship_phone_change_user_30d	LONG	Number of buyers who used the same shipping phone number in the past 30 days.
phone_ship_phone_change_user_90d	LONG	Number of buyers who used the same shipping phone number in the past 90 days.

Digital entertainment industry

Variable	Data type	Description
gaming_topped_up_email	INSENSITIVE_STRING	Email address of the player who has recharged funds.
gaming_topped_up_user	INSENSITIVE_STRING	User ID of the player who has recharged funds.

Travel industry

Variable	Data type	Description
transit_arrival_airport_code	INSENSITIVE_STRING	IATA code of the arrival airport.
transit_arrival_country	INSENSITIVE_STRING	Country of the arrival airport.
transit_departure_airport_code	INSENSITIVE_STRING	IATA code of the departure airport.
transit_departure_country	INSENSITIVE_STRING	Country of the departure airport.
transit_departure_purchase_gap_day	LONG	Time gap (in days) between ticket purchase and travel date.
transit_passenger_name	BASIC	Passenger name.