{"title":"Create and assign risk profiles","category":"default","creationDate":1779620071,"content":"<p>Risk profiles let you manage which risk rules you apply to payments made on a merchant account.<\/p>\n<p>When you use Protect, Adyen's risk management tool, and you have configured your <a href=\"\/risk-management\/configure-risk-settings\">risk settings<\/a>, you can create and use risk profiles. Each risk profile contains a set of risk rules and profile settings.<\/p>\n<p>You set up and configure risk profiles on your company account, and you can <a href=\"#set-a-risk-profile-as-default-action\">assign a profile<\/a> 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.<\/p>\n<h2>Requirements<\/h2>\n<p>Before you begin, take into account the following requirements and limitations.<\/p>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Requirement<\/th>\n<th style=\"text-align: left;\">Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\"><strong>Integration type<\/strong><\/td>\n<td style=\"text-align: left;\">Make sure that you have built an <a href=\"\/online-payments\/build-your-integration\/\">online payments integration<\/a> and that <a href=\"\/risk-management\/configure-risk-settings\/\">risk management is enabled<\/a>.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong><a href=\"\/account\/user-roles\/#risk\">Customer Area roles<\/a><\/strong><\/td>\n<td style=\"text-align: left;\">Make sure that you have one of the following role(s): <ul><li markdown=\"1\"><strong>Merchant change risk settings<\/strong><\/li><li markdown=\"1\"><strong>Risk admin<\/strong><\/li><\/ul><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>Limitations<\/strong><\/td>\n<td style=\"text-align: left;\">Some risk profile features are only available when you <a href=\"#risk-profile-basic-premium\">enable premium features<\/a>. <br>There are different considerations for creating a <a href=\"\/point-of-sale\/risk-management-pos\/\">risk profile for in-person payments<\/a>.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2 id=\"risk-profile-basic-premium\">Risk profile<\/h2>\n<p>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.<\/p>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Basic<\/th>\n<th style=\"text-align: left;\">Premium<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\">Block bot attacks<\/td>\n<td style=\"text-align: left;\">Block bot attacks<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Adyen-provided risk lists<\/td>\n<td style=\"text-align: left;\">Adyen-provided risk lists and custom lists<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Adyen-provided post-authorization rules<\/td>\n<td style=\"text-align: left;\">Adyen-provided post-authorization rules<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Dynamic 3D Secure<\/td>\n<td style=\"text-align: left;\">Dynamic 3D Secure in combination with custom rules<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><\/td>\n<td style=\"text-align: left;\">Machine learning powered fraud detection using global transaction data<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><\/td>\n<td style=\"text-align: left;\">Create, backtest, and label custom rules with a rule builder interface<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><\/td>\n<td style=\"text-align: left;\">Risk profile and rule analytics<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><\/td>\n<td style=\"text-align: left;\">Run risk experiments<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><\/td>\n<td style=\"text-align: left;\">Case management<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2 id=\"create-a-risk-profile-action\">Create a risk profile<\/h2>\n<p>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.<\/p>\n<p>To create a risk profile:<\/p>\n<ol>\n<li>Log in to your <a href=\"https:\/\/ca-test.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Customer Area<\/a> with your company account.<\/li>\n<li>Go to <strong>Revenue &amp; risk<\/strong> &gt; <strong>Risk profiles<\/strong>.<\/li>\n<li>Select <strong>Create new profile<\/strong>.<\/li>\n<li>In the <strong>Profile name<\/strong>, type a name for the new risk profile. Then, from the <strong>Based on profile<\/strong> drop down, select the risk profile that will be the template for your new profile.<\/li>\n<li>Select <strong>Create<\/strong>. Refresh the page to see your changes.<\/li>\n<\/ol>\n<p>After you create a risk profile, you can <a href=\"\/risk-management\/configure-your-risk-profile\">configure risk rules<\/a> for that profile, and you can:<\/p>\n<ul>\n<li><a href=\"#set-a-risk-profile-as-default-action\">Assign the risk profile to one or more merchant accounts<\/a>.\n<\/li>\n<li>(Optional) Find the risk profile reference to <a href=\"#dynamically-assign-a-risk-profile-to-a-payment\">assign a risk profile to a payment<\/a>.<\/li>\n<\/ul>\n<h2 id=\"set-a-risk-profile-as-default-action\">Assign a risk profile to a merchant account<\/h2>\n<p>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.<\/p>\n<p>To assign a risk profile to a merchant account:<\/p>\n<ol>\n<li>Open the <a href=\"#create-a-risk-profile-action\">profile you created<\/a>.<\/li>\n<li>Select <strong>Edit profile<\/strong>.<\/li>\n<li>Under <strong>Merchant accounts<\/strong>, select merchant accounts from the list.<\/li>\n<li>Select <strong>Save changes<\/strong>.<\/li>\n<\/ol>\n<p><\/p>\n<h2 id=\"dynamically-assign-a-risk-profile-to-a-payment\">Assign a risk profile to a payment<\/h2>\n<p>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.<\/p>\n<p>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.<\/p>\n<p>To assign a specific risk profile to a payment:<\/p>\n<ol>\n<li>Log in to your <a href=\"https:\/\/ca-test.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Customer Area<\/a> with your company account, go to <strong>Revenue &amp; risk<\/strong> &gt; <strong>Risk profiles<\/strong>, 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.<\/li>\n<li>\n<p>In payment request, add a <code>riskData.profileReference<\/code> field and set it to the profile's unique reference.<\/p>\n<p>Select which endpoint you use to send in payment requests:<\/p>\n   \n<div id=\"tabtZoMq\">\n    <div data-component-wrapper=\"tabs\">\n        <tabs\n                        :items=\"[{&quot;title&quot;:&quot;&lt;code&gt;\\\/sessions&lt;\\\/code&gt;&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;Using the  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Checkout\\\/latest\\\/post\\\/sessions\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;\\\/sessions&lt;\\\/a&gt; endpoint:&lt;br \\\/&gt;\\nProvide the  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Checkout\\\/latest\\\/post\\\/sessions#request-riskData-profileReference\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;profileReference&lt;\\\/a&gt; in the  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Checkout\\\/latest\\\/post\\\/sessions#request-riskData\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;riskData&lt;\\\/a&gt; object.&lt;\\\/p&gt;\\n&lt;div data-component-wrapper=\\&quot;code-sample\\&quot;&gt;\\n&lt;code-sample :title=\\&quot;&#039; Example \\\/sessions request using a risk profile reference&#039;\\&quot; :id=\\&quot;&#039;&#039;\\&quot; :code-data=&#039;[{\\&quot;language\\&quot;:\\&quot;json\\&quot;,\\&quot;tabTitle\\&quot;:\\&quot;\\&quot;,\\&quot;content\\&quot;:\\&quot;{\\\\n    \\\\\\&quot;merchantAccount\\\\\\&quot;:\\\\\\&quot;YOUR_MERCHANT_ACCOUNT\\\\\\&quot;,\\\\n    \\\\\\&quot;reference\\\\\\&quot;:\\\\\\&quot;YOUR_PAYMENT_REFERENCE\\\\\\&quot;,\\\\n    \\\\\\&quot;shopperReference\\\\\\&quot;:\\\\\\&quot;YOUR_UNIQUE_SHOPPER_ID\\\\\\&quot;,\\\\n    \\\\\\&quot;shopperEmail\\\\\\&quot;:\\\\\\&quot;s.hopper@example.com\\\\\\&quot;,\\\\n    \\\\\\&quot;amount\\\\\\&quot;:{\\\\n         \\\\\\&quot;value\\\\\\&quot;:1000,\\\\n         \\\\\\&quot;currency\\\\\\&quot;:\\\\\\&quot;EUR\\\\\\&quot;\\\\n    },\\\\n    \\\\\\&quot;riskData\\\\\\&quot;:{\\\\n         \\\\\\&quot;profileReference\\\\\\&quot;:\\\\\\&quot;9915885795954734\\\\\\&quot;\\\\n    }\\\\n}\\&quot;}]&#039; :enable-copy-link-to-code-block=\\&quot;true\\&quot; :code-sample-card-size=\\&quot;&#039;fullsize&#039;\\&quot;&gt;&lt;\\\/code-sample&gt;\\n&lt;\\\/div&gt;\\n   &quot;,&quot;altTitle&quot;:null,&quot;oldTabId&quot;:1,&quot;relation&quot;:&quot;&quot;},{&quot;title&quot;:&quot;&lt;code&gt;\\\/payments&lt;\\\/code&gt;&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;Using the  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Checkout\\\/latest\\\/post\\\/payments\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;\\\/payments&lt;\\\/a&gt; endpoint:&lt;br \\\/&gt;\\nProvide the  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Checkout\\\/latest\\\/post\\\/payments#request-riskData-profileReference\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;profileReference&lt;\\\/a&gt; in the  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Checkout\\\/latest\\\/post\\\/payments#request-riskData\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;riskData&lt;\\\/a&gt; object.&lt;\\\/p&gt;\\n&lt;div data-component-wrapper=\\&quot;code-sample\\&quot;&gt;\\n&lt;code-sample :title=\\&quot;&#039; Example \\\/payments request using a risk profile reference&#039;\\&quot; :id=\\&quot;&#039;&#039;\\&quot; :code-data=&#039;[{\\&quot;language\\&quot;:\\&quot;json\\&quot;,\\&quot;tabTitle\\&quot;:\\&quot;\\&quot;,\\&quot;content\\&quot;:\\&quot;{\\\\n    \\\\\\&quot;merchantAccount\\\\\\&quot;:\\\\\\&quot;YOUR_MERCHANT_ACCOUNT\\\\\\&quot;,\\\\n    \\\\\\&quot;reference\\\\\\&quot;:\\\\\\&quot;YOUR_PAYMENT_REFERENCE\\\\\\&quot;,\\\\n    \\\\\\&quot;shopperReference\\\\\\&quot;:\\\\\\&quot;YOUR_UNIQUE_SHOPPER_ID\\\\\\&quot;,\\\\n    \\\\\\&quot;shopperEmail\\\\\\&quot;:\\\\\\&quot;s.hopper@example.com\\\\\\&quot;,\\\\n    \\\\\\&quot;shopperIP\\\\\\&quot;:\\\\\\&quot;61.294.12.12\\\\\\&quot;,\\\\n    \\\\\\&quot;amount\\\\\\&quot;:{\\\\n         \\\\\\&quot;value\\\\\\&quot;:1000,\\\\n         \\\\\\&quot;currency\\\\\\&quot;:\\\\\\&quot;EUR\\\\\\&quot;\\\\n    },\\\\n    \\\\\\&quot;paymentMethod\\\\\\&quot;: {\\\\n         \\\\\\&quot;type\\\\\\&quot;: \\\\\\&quot;scheme\\\\\\&quot;,\\\\n         \\\\\\&quot;encryptedCardNumber\\\\\\&quot;: \\\\\\&quot;test_4111111111111111\\\\\\&quot;,\\\\n         \\\\\\&quot;encryptedExpiryMonth\\\\\\&quot;: \\\\\\&quot;test_03\\\\\\&quot;,\\\\n         \\\\\\&quot;encryptedExpiryYear\\\\\\&quot;: \\\\\\&quot;test_2030\\\\\\&quot;,\\\\n         \\\\\\&quot;encryptedSecurityCode\\\\\\&quot;: \\\\\\&quot;test_737\\\\\\&quot;\\\\n    },\\\\n    \\\\\\&quot;riskData\\\\\\&quot;:{\\\\n         \\\\\\&quot;profileReference\\\\\\&quot;:\\\\\\&quot;9915885795954734\\\\\\&quot;\\\\n    }\\\\n}\\&quot;}]&#039; :enable-copy-link-to-code-block=\\&quot;true\\&quot; :code-sample-card-size=\\&quot;&#039;fullsize&#039;\\&quot;&gt;&lt;\\\/code-sample&gt;\\n&lt;\\\/div&gt;\\n   &quot;,&quot;altTitle&quot;:null,&quot;oldTabId&quot;:1,&quot;relation&quot;:&quot;&quot;}]\"\n            :should-update-when-url-changes='false'>\n        <\/tabs>\n    <\/div>\n<\/div>\n\n<\/li>\n<\/ol>\n<h2>Next steps<\/h2>\n<div class=\"next-steps\" id=\"next-steps\" style=display:block;>\n<a href=\"\/risk-management\/configure-your-risk-profile\" class=\"next-steps__step\" style=\"width:45%;\" target=\"_self\"><div class=\"next-steps__title\">Configure your risk profile<\/div><p class=\"next-steps__body\"><p>Configure a risk profile to fit your business needs. <\/p><\/p><\/a><\/div>\n","url":"https:\/\/docs.adyen.com\/risk-management\/create-a-risk-profile","articleFields":{"section_label":"RISK PROFILES","description":"Create risk\u00a0profiles to manage risk.","parameters":{"engine":"latest","task":"create"},"id":"27529653","type":"page","_expandable":{"operations":""},"status":"current","last_edit_on":"04-03-2020 14:16"},"algolia":{"url":"https:\/\/docs.adyen.com\/risk-management\/create-a-risk-profile","title":"Create and assign risk profiles","content":"Risk profiles let you manage which risk rules you apply to payments made on a merchant account.\nWhen 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.\nYou 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.\nRequirements\nBefore you begin, take into account the following requirements and limitations.\n\n\n\nRequirement\nDescription\n\n\n\n\nIntegration type\nMake sure that you have built an online payments integration and that risk management is enabled.\n\n\nCustomer Area roles\nMake sure that you have one of the following role(s): Merchant change risk settingsRisk admin\n\n\nLimitations\nSome risk profile features are only available when you enable premium features. There are different considerations for creating a risk profile for in-person payments.\n\n\n\nRisk profile\nWhat is included in your risk profile depends on whether you use Protect basic, or if you have enabled premium features in the risk settings.\n\n\n\nBasic\nPremium\n\n\n\n\nBlock bot attacks\nBlock bot attacks\n\n\nAdyen-provided risk lists\nAdyen-provided risk lists and custom lists\n\n\nAdyen-provided post-authorization rules\nAdyen-provided post-authorization rules\n\n\nDynamic 3D Secure\nDynamic 3D Secure in combination with custom rules\n\n\n\nMachine learning powered fraud detection using global transaction data\n\n\n\nCreate, backtest, and label custom rules with a rule builder interface\n\n\n\nRisk profile and rule analytics\n\n\n\nRun risk experiments\n\n\n\nCase management\n\n\n\nCreate a risk profile\nYou 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.\nTo create a risk profile:\n\nLog in to your Customer Area with your company account.\nGo to Revenue &amp; risk &gt; Risk profiles.\nSelect Create new profile.\nIn 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.\nSelect Create. Refresh the page to see your changes.\n\nAfter you create a risk profile, you can configure risk rules for that profile, and you can:\n\nAssign the risk profile to one or more merchant accounts.\n\n(Optional) Find the risk profile reference to assign a risk profile to a payment.\n\nAssign a risk profile to a merchant account\nYou 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.\nTo assign a risk profile to a merchant account:\n\nOpen the profile you created.\nSelect Edit profile.\nUnder Merchant accounts, select merchant accounts from the list.\nSelect Save changes.\n\n\nAssign a risk profile to a payment\nYou 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.\nIf 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.\nTo assign a specific risk profile to a payment:\n\nLog in to your Customer Area with your company account, go to Revenue &amp; risk &gt; 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.\n\nIn payment request, add a riskData.profileReference field and set it to the profile's unique reference.\nSelect which endpoint you use to send in payment requests:\n   \n\n    \n        \n        \n    \n\n\n\n\nNext steps\n\nConfigure your risk profileConfigure a risk profile to fit your business needs. \n","type":"page","locale":"en","boost":18,"hierarchy":{"lvl0":"Home","lvl1":"Risk management","lvl2":"Create and assign risk profiles"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/","lvl1":"https:\/\/docs.adyen.com\/risk-management","lvl2":"\/risk-management\/create-a-risk-profile"},"levels":3,"category":"Risk Management","category_color":"green","tags":["Create","assign","profiles"]}}
