Rule Attributes

🚧
Beta testing phase
This is not the final version of the product, and is still subject to change.
If you are interested in early access to this feature, please contact [email protected]!

PayMongo Protect allows you to create custom fraud rules based on specific transaction attributes. Each attribute targets certain characteristics or behaviors, enabling you to automate fraud decisions and quickly adapt to changing threats.

To create a rule, you must specify at least one attribute. Combine attributes using "AND" or "OR" logic for advanced targeting.

Available Rule Attributes

Below are the current rule attributes available for use in PayMongo Protect. Each attribute can be used individually or in combination.

Attribute Name	Data Type	Description
`risk_score_gte`	Number	Matches transactions when the risk score is greater than or equal to the provided value.
`risk_score_lte`	Number	Matches transactions when the risk score is less than or equal to the provided value.
`card_country_id`	String	Matches transactions where the card’s country code matches the provided two-letter ISO code.
`billing_country_id`	String	Matches transactions where the customer's billing country code matches the provided ISO code.
`payment_amount_gte`	Number	Matches transactions when the payment amount is greater than or equal to the provided value.
`payment_amount_lte`	Number	Matches transactions when the payment amount is less than or equal to the provided value.
`ip_address`	String	Matches transactions where the IP address matches the provided value.
`ip_address_cidr`	String	Matches transactions where the IP address matches the provided CIDR value. (coming soon)
`billing_email`	String	Matches transactions where the billing email address matches the provided value. (coming soon)
`risk_level`	String	Matches transactions where the risk level matches the provided value.

How to Use These Attributes

When creating a rule, select one or more attributes to target.
Define the matching value or threshold for each attribute.
Combine multiple attributes using "AND" or "OR" logic for advanced rules.

Example Rules

Block transactions with risk score ≥ 700 and card country = 'NG':

block if risk_score_gte: 700 AND card_country_id: ['NG']

Review transactions if payment amount ≥ 10,000 or billing country = 'PH':

review if payment_amount_gte: 10000 OR billing_country_id: ['PH']

Allow transactions if risk score ≤ 399:

allow if risk_score_lte: 399

For more details on rule creation and management, see the Rules documentation.