{"title":"Create and assign risk profiles","category":"default","creationDate":1779620071,"content":"<div class=\"notices green\">\n<p>The content on this page applies to the classic risk engine. When you have transitioned to the latest risk engine, or if you are just starting to use risk, refer to <a href=\"\/risk-management\/create-a-risk-profile\">Create a risk profile<\/a>.  See the <a href=\"\/risk-management\">risk management overview<\/a> for the differences.<\/p>\n<\/div>\n<p>Risk profiles let you manage which risk rules you apply to payments made on a merchant account.<\/p>\n<p>When you use 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\">assign a profile<\/a> to merchant accounts.<\/p>\n<h2>Classic risk profile<\/h2>\n<p>Your configuration options depend on whether you use our basic risk solution, or if you have enabled premium features.<\/p>\n<p>You <a href=\"\/risk-management\/configure-manual-risk\/\">configure risk rules manually<\/a>, and configure a risk score that is added to or subtracted from the total risk score for a payment when that rule triggers.<\/p>\n<p>The riskier the payment, the higher the risk score. When the total risk score reaches 100, the payment is refused.<\/p>\n<p>A default risk profile is set up for you, with pre-configured settings that are based on your company's industry. By default, all new merchant accounts created in your company account use this default risk profile.<\/p>\n<p>You can update the default profile or create new risk profiles as you see fit. You are responsible for setting up the risk score settings and thresholds for risk rules, and maintaining the risk profiles.<\/p>\n<h2 id=\"create-a-risk-profile\">Create a risk profile<\/h2>\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>When you select a risk profile, you can:<\/p>\n<ul>\n<li><a href=\"#set-a-risk-profile-as-default\">Assign the risk profile to a merchant account<\/a>.<\/li>\n<li>Configure the risk profile settings, for example for <a href=\"#settings-case-management\">case management<\/a>.<\/li>\n<li><a href=\"\/risk-management\/configure-manual-risk\">Configure risk rules<\/a> for the risk profile.<\/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\">Assign a risk profile to a merchant account<\/h2>\n<p>You can assign a profile as the default profile for all your merchant accounts, or create different risk profiles with different risk rule 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\">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<div class=\"notices green\">\n<p>For larger lists, use the textbook to enter a comma-separated list.<\/p>\n<\/div>\n<h2 id=\"settings-case-management\">Case management settings<\/h2>\n<p>When you have enabled premium features, you can use <a href=\"\/risk-management\/case-management\">case management<\/a> to manually review certain transactions before they are captured. On the risk profile, you can configure two case management settings:<\/p>\n<h3 id=\"skip-case-management\">Skip manual review on liability shift<\/h3>\n<p>This option on the risk profile lets you control whether transactions with liability shift are sent to case management. You can choose not to manually review cases where the liability has shifted to the issuing bank, for example when the shopper has authenticated by using 3D Secure.<\/p>\n<div class=\"notices blue\">\n<p>If you have turned on <strong>Send to Case Management<\/strong> for an individual risk rule, this overrides <strong>Skip manual review on liability shift<\/strong>. The payment goes through 3D Secure and liability has shifted, but the payment still goes to case management.<\/p>\n<\/div>\n<h3 id=\"minimum-score-case-management\">Minimum score for manual review<\/h3>\n<p>This option on the risk profile lets you set a minimum risk score that a payment must have before it is sent to case management for manual review. This way, you have the option to limit the amount of cases.<\/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.<\/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. You can find the risk profile reference when you select a risk profile in your <a href=\"https:\/\/ca-test.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Customer Area<\/a>.<\/p>\n<p>To assign a specific profile to a payment, you provide the risk profile reference in the payment request. Select which endpoint you use to send in payment requests:<\/p>\n\n<div id=\"tabZDayJ\">\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;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;Provide 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;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&lt;div data-component-wrapper=\\&quot;code-sample\\&quot;&gt;\\n    &lt;code-sample :title=\\&quot;&#039; Example \\\/sessions request&#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;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;Provide 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;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&lt;div data-component-wrapper=\\&quot;code-sample\\&quot;&gt;\\n    &lt;code-sample :title=\\&quot;&#039; Example \\\/payments request&#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;},{&quot;title&quot;:&quot;&lt;code&gt;\\\/authorise&lt;\\\/code&gt;&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;Using the  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Payment\\\/latest\\\/post\\\/authorise\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;\\\/authorise&lt;\\\/a&gt; endpoint:&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;Provide the &lt;code&gt;riskdata.riskProfileReference&lt;\\\/code&gt; in the  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Payment\\\/latest\\\/post\\\/authorise#request-additionalData\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;additionalData&lt;\\\/a&gt; object of your payment request.&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&lt;div data-component-wrapper=\\&quot;code-sample\\&quot;&gt;\\n    &lt;code-sample :title=\\&quot;&#039;Example \\\/authorise request&#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;card\\\\\\&quot;:{\\\\n    \\\\\\&quot;number\\\\\\&quot;:\\\\\\&quot;4111111111111111\\\\\\&quot;,\\\\n    \\\\\\&quot;expiryMonth\\\\\\&quot;:\\\\\\&quot;03\\\\\\&quot;,\\\\n    \\\\\\&quot;expiryYear\\\\\\&quot;:\\\\\\&quot;2030\\\\\\&quot;,\\\\n    \\\\\\&quot;cvc\\\\\\&quot;:\\\\\\&quot;737\\\\\\&quot;,\\\\n    \\\\\\&quot;holderName\\\\\\&quot;:\\\\\\&quot;S. Hopper\\\\\\&quot;\\\\n  },\\\\n  \\\\\\&quot;additionalData\\\\\\&quot;:{\\\\n    \\\\\\&quot;riskdata.riskProfileReference\\\\\\&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","url":"https:\/\/docs.adyen.com\/risk-management\/create-and-use-risk-profiles","articleFields":{"section_label":"RISK PROFILES (CLASSIC)","description":"Create risk\u00a0profiles to manage risk.","robots":"noindex,nofollow","next_steps":[{"title":"Configure your risk profile (classic)","description":"Configure risk rules to fit your business needs.","url":"\/risk-management\/configure-manual-risk","required":false}],"id":"27529653","parameters":{"engine":"classic","task":"create"},"type":"page","_expandable":{"operations":""},"status":"current","last_edit_on":"04-03-2020 14:16"},"algolia":{"url":"https:\/\/docs.adyen.com\/risk-management\/create-and-use-risk-profiles","title":"Create and assign risk profiles","content":"\nThe content on this page applies to the classic risk engine. When you have transitioned to the latest risk engine, or if you are just starting to use risk, refer to Create a risk profile.  See the risk management overview for the differences.\n\nRisk profiles let you manage which risk rules you apply to payments made on a merchant account.\nWhen you use 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 merchant accounts.\nClassic risk profile\nYour configuration options depend on whether you use our basic risk solution, or if you have enabled premium features.\nYou configure risk rules manually, and configure a risk score that is added to or subtracted from the total risk score for a payment when that rule triggers.\nThe riskier the payment, the higher the risk score. When the total risk score reaches 100, the payment is refused.\nA default risk profile is set up for you, with pre-configured settings that are based on your company's industry. By default, all new merchant accounts created in your company account use this default risk profile.\nYou can update the default profile or create new risk profiles as you see fit. You are responsible for setting up the risk score settings and thresholds for risk rules, and maintaining the risk profiles.\nCreate 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\nWhen you select a risk profile, you can:\n\nAssign the risk profile to a merchant account.\nConfigure the risk profile settings, for example for case management.\nConfigure risk rules for the risk profile.\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 assign a profile as the default profile for all your merchant accounts, or create different risk profiles with different risk rule 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\nFor larger lists, use the textbook to enter a comma-separated list.\n\nCase management settings\nWhen you have enabled premium features, you can use case management to manually review certain transactions before they are captured. On the risk profile, you can configure two case management settings:\nSkip manual review on liability shift\nThis option on the risk profile lets you control whether transactions with liability shift are sent to case management. You can choose not to manually review cases where the liability has shifted to the issuing bank, for example when the shopper has authenticated by using 3D Secure.\n\nIf you have turned on Send to Case Management for an individual risk rule, this overrides Skip manual review on liability shift. The payment goes through 3D Secure and liability has shifted, but the payment still goes to case management.\n\nMinimum score for manual review\nThis option on the risk profile lets you set a minimum risk score that a payment must have before it is sent to case management for manual review. This way, you have the option to limit the amount of cases.\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.\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. You can find the risk profile reference when you select a risk profile in your Customer Area.\nTo assign a specific profile to a payment, you provide the risk profile reference in the payment request. Select which endpoint you use to send in payment requests:\n\n\n    \n        \n        \n    \n\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-and-use-risk-profiles"},"levels":3,"category":"Risk Management","category_color":"green","tags":["Create","assign","profiles"]},"articleFiles":{"create-profile.png":"<img alt=\"\" src=\"https:\/\/docs.adyen.com\/user\/pages\/docs\/10.risk-management\/03.create-and-use-risk-profiles\/create-profile.png\" \/>"}}
