Risk profiles let you manage which risk rules you apply to payments made on a merchant account.
When you use Protect, Adyen's risk management tool, and you have configured your risk settings, you can create and use risk profiles. Each risk profile contains a set of risk rules and profile settings.
You set up and configure risk profiles on your company account, and you can assign a profile to one or multiple merchant accounts. When you configure risk management for the first time, a default risk profile is available to help you get started.
Requirements
Before you begin, take into account the following requirements and limitations.
| Requirement | Description |
|---|---|
| Integration type | Make sure that you have built an online payments integration and that risk management is enabled. |
| Customer Area roles | Make sure that you have one of the following role(s):
|
| Limitations | Some risk profile features are only available when you enable premium features. There are different considerations for creating a risk profile for in-person payments. |
Risk profile
What is included in your risk profile depends on whether you use Protect basic, or if you have enabled premium features in the risk settings.
| Basic | Premium |
|---|---|
| Block bot attacks | Block bot attacks |
| Adyen-provided risk lists | Adyen-provided risk lists and custom lists |
| Adyen-provided post-authorization rules | Adyen-provided post-authorization rules |
| Dynamic 3D Secure | Dynamic 3D Secure in combination with custom rules |
| Machine learning powered fraud detection using global transaction data | |
| Create, backtest, and label custom rules with a rule builder interface | |
| Risk profile and rule analytics | |
| Run risk experiments | |
| Case management |
Create a risk profile
You can use the default risk profile, configure it, and assign it to all your merchant accounts. If you want to create one or more additional risk profiles with different settings, you can create new risk profiles.
To create a risk profile:
- Log in to your Customer Area with your company account.
- Go to Revenue & risk > Risk profiles.
- Select Create new profile.
- In the Profile name, type a name for the new risk profile. Then, from the Based on profile drop down, select the risk profile that will be the template for your new profile.
- Select Create. Refresh the page to see your changes.
After you create a risk profile, you can configure risk rules for that profile, and you can:
- Assign the risk profile to one or more merchant accounts.
- (Optional) Find the risk profile reference to assign a risk profile to a payment.
Assign a risk profile to a merchant account
You can use the default risk profile for all your merchant accounts, or create different risk profiles with different rules and settings for some of your merchant accounts.
To assign a risk profile to a merchant account:
- Open the profile you created.
- Select Edit profile.
- Under Merchant accounts, select merchant accounts from the list.
- Select Save changes.
Assign a risk profile to a payment
You have the option to override the risk profile that is assigned to a merchant account if you want to use a different risk profile for a specific payment. To do this, you provide the risk profile reference in the payment request.
If you do not provide a risk profile reference in your payment request, the merchant account's default risk profile will be applied to the payment.
To assign a specific risk profile to a payment:
- Log in to your Customer Area with your company account, go to Revenue & risk > Risk profiles, and look up the unique reference of the risk profile that you want to use for the payment. You can find the risk profile reference in the profile overview when you select a risk profile.
-
In payment request, add a
riskData.profileReferencefield and set it to the profile's unique reference.Select which endpoint you use to send in payment requests: