Intermediate
How to configure fraud rules radar on Stripe
Quick Answer
Stripe Radar fraud rules can be configured through the Stripe Dashboard by navigating to the Radar section and creating custom rules based on risk factors like card country, IP address, and transaction patterns. You can set rules to block, allow, or review transactions automatically based on your defined criteria.
Prerequisites
- Active Stripe account with payments enabled
- Admin access to Stripe Dashboard
- Basic understanding of fraud indicators and risk factors
- Stripe Radar enabled on your account
1
Access Stripe Radar in Dashboard
Log into your Stripe Dashboard and navigate to Radar in the left sidebar. Click on Rules to access the fraud rules configuration page. You'll see a list of existing rules and the option to create new ones.
Tip
Ensure you have the necessary permissions to modify Radar settings, as this typically requires admin access.
2
Review Default Machine Learning Rules
Examine the built-in ML-powered rules that Stripe provides by default. These include rules for 3D Secure, CVC verification, and risk score thresholds. You can enable or disable these by toggling the switches next to each rule.
Tip
Start with Stripe's default rules before creating custom ones, as they're based on extensive fraud data analysis.
3
Create a Custom Rule
Click Add rule to create a new custom fraud rule. Choose from rule types: Block (decline payment), Allow (approve payment), or Review (flag for manual review). Enter a descriptive name for your rule in the Rule name field.
Tip
Use clear, descriptive names for your rules to make them easy to identify and manage later.
4
Define Rule Conditions
Set up your rule logic using Stripe's rule builder. Common conditions include:
:ip_country:for IP-based location filtering:card_country:for card issuing country:risk_score:for Stripe's machine learning risk assessment:email_domain:for email domain restrictions
is, is_not, is_in, or is_greater_than to define your criteria.Tip
Start with broader rules and gradually refine them based on your fraud patterns and false positive rates.
5
Set Rule Priority and Testing
Configure the rule priority by dragging it to the appropriate position in your rules list. Higher rules execute first. Enable Test mode to simulate the rule's behavior without affecting live payments. Review the estimated impact shown in the rule preview.
Tip
Always test new rules in test mode first to understand their potential impact on legitimate transactions.
6
Configure Advanced Options
Set up advanced options including rule exceptions for specific customers or situations. Configure time-based conditions if needed, and set up velocity rules to detect rapid-fire transaction attempts. Enable email notifications for rule triggers if desired.
Tip
Consider creating exception rules for trusted customers or business partners to avoid blocking legitimate high-value transactions.
7
Activate and Monitor Rules
Click Add rule to save and activate your configuration. Monitor rule performance in the Radar > Overview section, where you can see metrics like blocked payments, false positives, and accuracy rates. Regularly review and adjust rules based on performance data.
Tip
Set up regular reviews of your rule performance to optimize for both fraud prevention and customer experience.
Troubleshooting
Rule is blocking legitimate customers
Check the rule conditions and consider adding exceptions for trusted customer segments. Review the false positive rate in Radar analytics and adjust thresholds or add
:is_not conditions for legitimate patterns.Radar rules not appearing or saving
Verify that Stripe Radar is enabled on your account and you have sufficient permissions. Check that your rule syntax is correct and all required fields are filled. Contact Stripe support if the issue persists.
High false positive rates on new rules
Start with Review actions instead of Block to manually assess flagged transactions. Gradually tighten rule conditions based on actual fraud patterns rather than assumptions.
Rules not triggering as expected
Check rule priority order as higher rules may override lower ones. Verify that rule conditions match the actual transaction data format. Use the Test mode to debug rule logic with sample transactions.
Ready to get started with Stripe?
Put this tutorial into practice. Visit Stripe and follow the steps above.
Visit Stripe →