Rule Attributes

Overview

To empower your business with flexible and effective fraud prevention, Paymongo FraudDetector allows you to create custom rules based on a wide set of transaction attributes. Each rule is constructed by specifying one or more attributes to target suspicious or high-risk behavior. By tailoring these rule attributes, you can automate fraud decisioning and adapt quickly to evolving threats.

To create a rule, you must set a rule attribute. Rule attributes define the specific data points evaluated by the Fraud Management Tool when deciding whether to block, allow, or review a transaction.

Available Rule Attributes

Below are the full set of rule attributes available for creating custom rules. Each attribute can be used individually or in combination (using logical "AND"/"OR" operators) for precise control over fraud interventions.

Attribute Name	Description
`card_fraud_detector_v1_insightscore`	Risk score assigned by the fraud detector model.
`amount`	The transaction amount.
`billing_address_address_1`	Street address from the billing details.
`billing_address_city`	City from the billing address.
`billing_address_country`	Country from the billing address (ISO code).
`billing_address_name`	Name as entered in the billing address.
`billing_address_phone`	Phone number from the billing address.
`billing_address_zipcode`	Zip/postal code from the billing address.
`creditcard_bank`	Bank that issued the credit card.
`creditcard_brand`	Brand of the credit card (Visa, Mastercard, etc.).
`creditcard_country`	Country where the credit card was issued (ISO code).
`creditcard_level`	Card level (e.g., Platinum, Gold, etc.).
`creditcard_type`	Card type (e.g., credit, debit, prepaid).
`paymentfingerprint_cardbin_cardlast4`	Unique fingerprint combining card BIN and last 4 digits.
`paymentmethod_card_bin`	Bank Identification Number (BIN) of the card.
`paymentmethod_card_last4`	Last 4 digits of the card number.
`paymentmethod_payment_gateway`	Payment gateway used for the transaction.
`user_id`	Unique identifier for the user making the transaction.
`usersperpaymentfingerprint_cardbin_cardlast4`	Number of distinct users associated with a particular card fingerprint (BIN + last 4).
`usersperpaymentfingerprint_cardbin_cardlast4_billingzip`	Number of distinct users associated with a particular card fingerprint and billing zip code.

How to use these attributes:

When creating a rule, select one or more attributes to target.
Define the condition (e.g., equals, greater than, less than, contains) and value.
Combine multiple attributes using "AND" or "OR" logic for advanced rules.

For example:

Block transactions where creditcard_country is not "PH".
Review transactions if card_fraud_detector_v1_insightscore ≥ 700 AND amount ≥ 10,000.
Allow transactions if user_id matches a trusted customer list.

For details on rule creation and management, please see the Fraud Rules API Reference.

Updated 29 days ago