Radar
Real-time fraud protection with customizable rules and lists
Radar provides real-time fraud protection and requires no additional development time. Fraud professionals can add Radar for Fraud Teams to customize protection and get deeper insights.
Set Up
Head on to dashboard.chapa.co and Sign Up or Sign In. Click on the Radar from the side tab. If the toggle is not already on, you can start the radar service by turning the toggle on.
Lists
Create your own lists of information to block, allow, or review matching payments.
You can create lists of specific types of information and use them in rules. For example, you might want to create rules using a list of:
- Blocked List. Use this list to automatically deny payments by these customers.
- Maximum Withdrawal Amount. Use this list to set the maximum withdrawal amount you can make.
How to Add a List
-
Click the Lists tab in the toolbar, then click the Add Lists button on the far right.
-
Fill out the form with the following fields:
List Fields
| Field | Required | Description |
|---|---|---|
Name | Yes | A unique identifier for the list item. This name should be descriptive and help you easily recognize the purpose of the list. |
Slug | No | A URL-friendly version of the name. It is often used for creating permalinks or for SEO purposes. |
Type | Yes | Determines the type of data that will be included in the list. Options include: Phone Number, Account Number, IP Address, Amount, Email Address, Card Number, Customer ID, Device ID, Location, or Name. Select the appropriate type based on the nature of the data you will be storing in the list. |
Lists | Yes | Where you will input the actual list items. You can either enter the list items as a comma-separated list or provide them in a CSV file format. Ensure that the list items are formatted correctly according to the selected data type (e.g., phone numbers in the correct format, email addresses with the proper syntax, etc.). |
- After you've filled out all the needed fields, click the Add button. You'll get a toast notification telling you that you've successfully added a list.
Rules
Radar prevention rules allow you to take action whenever a payment matches certain criteria.
Chapa's Radar provides built-in rules to help detect and guard against fraud risk for all users:
- Authorization Rules: Criteria to determine whether a payment should proceed after a review.
- Block Rules: Conditions to block payments based on specific criteria.
How to Add Authorization Rules
-
Click the Rules tab in the toolbar, then click the Add Rule button on the far right.
-
Fill out the form with the following fields:
Authorization Rule Fields
| Field | Required | Description |
|---|---|---|
Attribute | Yes | Determines the type of data that will be used for the authorization rule. Options: Mobile, Email, Amount, or Daily Amount. Select the appropriate attribute based on the type of data you need to authorize. |
Operator | No | Specifies how the data should be equated or compared. Options: Equal To (=), Not Equal To (!=), Greater Than (>), Less Than (<), Greater Than or Equal To (>=), Less Than or Equal To (<=), Like (LIKE), Contains (@), Does Not Contain (!). The operator you choose will determine how the data is evaluated against the list you select. |
List | Yes | Select a list that you have previously created. The list should contain the data that you want to authorize against, such as a list of approved email addresses, phone numbers, or transaction amounts. |
Rule Type (Applied to) | Yes | Specifies whether the authorization rule should be applied to all payouts or all payins. Payouts refer to outgoing transactions, while payins refer to incoming transactions. |
-
Click the Test Rule button to evaluate the selected data point against the chosen list and operator. This will display the result of the test and help you fine-tune the authorization rule before implementing it.
-
By default, the status of a new authorization rule is set to Disabled. This gives you the opportunity to thoroughly review and test the rule before activating it. When you're satisfied that the rule is set up correctly, you can change the status to Enabled by clicking the Edit option and selecting the Enabled setting.
-
After you've filled out all the needed fields, click the Add button. You'll get a toast notification telling you that you've successfully added a rule.
How to Add Block Rules
-
Click the Rules tab in the toolbar, then click the Add Rule button on the far right.
-
Fill out the form with the following fields:
Block Rule Fields
| Field | Required | Description |
|---|---|---|
Attribute | Yes | Determines the type of data that will be used for the block rule. Options: Mobile, Email, Amount, or Daily Amount. Select the appropriate attribute based on the type of data you need to block. |
Operator | No | Specifies how the data should be equated or compared. Options: Equal To (=), Not Equal To (!=), Greater Than (>), Less Than (<), Greater Than or Equal To (>=), Less Than or Equal To (<=), Like (LIKE), Contains (@), Does Not Contain (!). |
List | Yes | Select a list that you have previously created. The list should contain the data that you want to block against, such as a list of blocked email addresses, phone numbers, or transaction amounts. |
Rule Type (Applied to) | Yes | Specifies whether the block rule should be applied to all payouts or all payins. Payouts refer to outgoing transactions, while payins refer to incoming transactions. |
-
Click the Test Rule button to evaluate the selected data point against the chosen list and operator. This will display the result of the test and help you fine-tune the block rule before implementing it.
-
By default, the status of a new block rule is set to Disabled. This gives you the opportunity to thoroughly review and test the rule before activating it. When you're satisfied that the rule is set up correctly, you can change the status to Enabled by clicking the Edit option and selecting the Enabled setting.
-
After you've filled out all the needed fields, click the Add button. You'll get a toast notification telling you that you've successfully added a rule.
Best Practices
- Test Before Enabling: Always test your rules before enabling them to ensure they work as expected
- Start with Disabled: Keep rules disabled initially and enable them after thorough testing
- Regular Review: Regularly review your lists and rules to ensure they're still relevant
- Monitor Results: Monitor the results of your rules to fine-tune them over time
- Use Descriptive Names: Use clear, descriptive names for your lists and rules for easy management
Next Steps
- Security Guide - Learn about Chapa's security practices
- High Risk Businesses - Learn about high-risk business considerations
- Webhooks - Set up real-time notifications