{"title":"Configure notifications for risk signals","category":"Classic Platforms","creationDate":1658923380,"content":"<div class=\"sc-notice info\"><div>\n<p>This page is for classic Adyen for Platforms integrations. If you are just starting your implementation, refer to our <a href=\"\/pt\/adyen-for-platforms-model\">new integration guide<\/a> instead.<\/p>\n<\/div><\/div>\n<p>When a new risk signal triggers for an account holder, Adyen can send webhooks to your server. If you want to get notified of these events, you can subscribe to the webhook.<\/p>\n<p>This works the same way as adding other <a href=\"\/pt\/classic-platforms\/configure-notifications\">webhooks<\/a>. The event type for risk signals is <code>SCORE_SIGNAL_TRIGGERED<\/code>.<\/p>\n<p>You can add a <a href=\"#create-a-notification-configuration\">new notification configuration<\/a>, or you can <a href=\"#update-notification-configurations\">update your existing configuration<\/a>.<\/p>\n<p>After you have completed your setup, notify us so that we can turn on the webhook notification.<\/p>\n<h2 id=\"create-a-notification-configuration\">Create a notification configuration<\/h2>\n<p>Make a POST  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/NotificationConfiguration\/latest\/post\/createNotificationConfiguration\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/createNotificationConfiguration<\/a> call, passing the URL where the notifications should be sent, and the notification type.<\/p>\n<div data-component-wrapper=\"code-sample\">\n    <code-sample :title=\"'Create notification configuration'\" :id=\"'request'\" :code-data=\"[{&quot;language&quot;:&quot;bash&quot;,&quot;tabTitle&quot;:&quot;&quot;,&quot;content&quot;:&quot;curl https:\\\/\\\/cal-test.adyen.com\\\/cal\\\/services\\\/Notification\\\/v6\\\/createNotificationConfiguration \\\\\\n-H 'x-API-key: YOUR_X-API-KEY' \\\\\\n-H 'content-type: application\\\/json' \\\\\\n-d '{\\n  \\&quot;configurationDetails\\&quot;:{\\n  \\t\\&quot;active\\&quot;: false,\\n    \\&quot;eventConfigs\\&quot;:[\\n      {\\n        \\&quot;eventType\\&quot;:\\&quot;SCORE_SIGNAL_TRIGGERED\\&quot;,\\n        \\&quot;includeMode\\&quot;:\\&quot;INCLUDE\\&quot;\\n      }\\n    ],\\n    \\&quot;notifyURL\\&quot;:\\&quot;https:\\\/\\\/www.merchant-domain.com\\\/notification-handler\\&quot;\\n  }\\n}'&quot;}]\" :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<div data-component-wrapper=\"code-sample\">\n    <code-sample :title=\"'Response'\" :id=\"''\" :code-data='[{\"language\":\"json\",\"tabTitle\":\"\",\"content\":\"{\\n    \\\"pspReference\\\": \\\"XB7XNCQ8HXSKGK82\\\",\\n    \\\"configurationDetails\\\": {\\n        \\\"active\\\": true,\\n        \\\"eventConfigs\\\": [\\n            {\\n                \\\"eventType\\\": \\\"SCORE_SIGNAL_TRIGGERED\\\",\\n                \\\"includeMode\\\": \\\"INCLUDE\\\"\\n            }\\n        ],\\n        \\\"notificationId\\\": 12345,\\n        \\\"notifyURL\\\": \\\"https:\\\/\\\/www.merchant-domain.com\\\/notification-handler\\\",\\n    }\\n}\"}]' :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<h2 id=\"update-notification-configurations\">Update a notification configuration<\/h2>\n<p>If you have already have an existing notification configuration, you can update your notification setup.<\/p>\n<p>Make a POST  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/NotificationConfiguration\/latest\/post\/updateNotificationConfiguration\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/updateNotificationConfiguration<\/a> call and pass the new setting as its parameters. The notification to be updated is specified by the <code>notificationId<\/code> value.<\/p>\n<div data-component-wrapper=\"code-sample\">\n    <code-sample :title=\"'Update a notification configuration'\" :id=\"'request-1'\" :code-data=\"[{&quot;language&quot;:&quot;bash&quot;,&quot;tabTitle&quot;:&quot;&quot;,&quot;content&quot;:&quot;curl https:\\\/\\\/cal-test.adyen.com\\\/cal\\\/services\\\/Notification\\\/v6\\\/updateNotificationConfiguration \\\\\\n-H 'x-API-key: YOUR_X-API-KEY' \\\\\\n-H 'content-type: application\\\/json' \\\\\\n-d '{\\n   \\&quot;configurationDetails\\&quot;:{\\n      \\&quot;active\\&quot;:false,\\n      \\&quot;eventConfigs\\&quot;:[\\n         {\\n            \\&quot;eventType\\&quot;:\\&quot;ACCOUNT_CREATED\\&quot;,\\n            \\&quot;includeMode\\&quot;:\\&quot;INCLUDE\\&quot;\\n         },\\n         {\\n           \\&quot;eventType\\&quot;:\\&quot;SCORE_SIGNAL_TRIGGERED\\&quot;,\\n           \\&quot;includeMode\\&quot;:\\&quot;INCLUDE\\&quot;\\n         }\\n      ],\\n      \\&quot;notificationId\\&quot;:12345,\\n      \\&quot;notifyURL\\&quot;:\\&quot;https:\\\/\\\/www.merchant-domain.com\\\/notification-handler\\&quot;\\n   }\\n}'&quot;}]\" :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<div data-component-wrapper=\"code-sample\">\n    <code-sample :title=\"'Response'\" :id=\"'response-1'\" :code-data='[{\"language\":\"json\",\"tabTitle\":\"\",\"content\":\"{\\n   \\\"pspReference\\\":\\\"R5CZ2NWPJTGV9D82\\\",\\n   \\\"configurationDetails\\\":{\\n      \\\"active\\\":false,\\n      \\\"eventConfigs\\\":[\\n         {\\n               \\\"eventType\\\":\\\"ACCOUNT_CREATED\\\",\\n               \\\"includeMode\\\":\\\"INCLUDE\\\"\\n         },\\n         {\\n               \\\"eventType\\\":\\\"SCORE_SIGNAL_TRIGGERED\\\",\\n               \\\"includeMode\\\":\\\"INCLUDE\\\"\\n         }\\n      ],\\n      \\\"notificationId\\\":12345,\\n      \\\"notifyURL\\\":\\\"https:\\\/\\\/www.merchant-domain.com\\\/notification-handler\\\",\\n   }\\n}\"}]' :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<h2>Example notification<\/h2>\n<p>The following is an example notification body for the <code>SCORE_SIGNAL_TRIGGERED<\/code> event type, triggered by the <code>EmailSyntaxCheck<\/code> risk signal.<\/p>\n<div data-component-wrapper=\"code-sample\">\n    <code-sample :title=\"'Example notification'\" :id=\"''\" :code-data='[{\"language\":\"json\",\"tabTitle\":\"\",\"content\":\"{\\n  \\\"eventDate\\\": \\\"2022-04-05T13:29:15+02:00\\\",\\n  \\\"eventType\\\": \\\"SCORE_SIGNAL_TRIGGERED\\\",\\n  \\\"executingUserKey\\\": \\\"IdentityRisk\\\",\\n  \\\"live\\\": \\\"false\\\",\\n  \\\"mimeType\\\": \\\"genericNotification\\\",\\n  \\\"pspReference\\\": \\\"JDD6LKT8MBLZNN84\\\",\\n  \\\"content\\\": {\\n      \\\"accountHolderCode\\\": \\\"YOUR_ACCOUNT_HOLDER_CODE\\\",\\n      \\\"riskScore\\\": 80,\\n      \\\"scoreSignalsTriggered\\\": [\\n        \\\"EmailSyntaxCheck\\\"]\\n      }\\n}\"}]' :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n","url":"https:\/\/docs.adyen.com\/pt\/classic-platforms\/identify-account-holder-risk\/configure-notifications-for-risk-signals","articleFields":{"description":"Learn how to set up and test notifications for risk signals in your platform.","search_category":"Classic Platforms","feedback_component":true,"parameters":{"directoryPath":"\/classic-platforms","integration":"classic"},"last_edit_on":"27-07-2022 14:04"},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/classic-platforms\/identify-account-holder-risk\/configure-notifications-for-risk-signals","title":"Configure notifications for risk signals","content":"\nThis page is for classic Adyen for Platforms integrations. If you are just starting your implementation, refer to our new integration guide instead.\n\nWhen a new risk signal triggers for an account holder, Adyen can send webhooks to your server. If you want to get notified of these events, you can subscribe to the webhook.\nThis works the same way as adding other webhooks. The event type for risk signals is SCORE_SIGNAL_TRIGGERED.\nYou can add a new notification configuration, or you can update your existing configuration.\nAfter you have completed your setup, notify us so that we can turn on the webhook notification.\nCreate a notification configuration\nMake a POST  \/createNotificationConfiguration call, passing the URL where the notifications should be sent, and the notification type.\n\n    \n\n\n    \n\nUpdate a notification configuration\nIf you have already have an existing notification configuration, you can update your notification setup.\nMake a POST  \/updateNotificationConfiguration call and pass the new setting as its parameters. The notification to be updated is specified by the notificationId value.\n\n    \n\n\n    \n\nExample notification\nThe following is an example notification body for the SCORE_SIGNAL_TRIGGERED event type, triggered by the EmailSyntaxCheck risk signal.\n\n    \n\n","type":"page","locale":"pt","boost":17,"hierarchy":{"lvl0":"Home","lvl1":"Classic integration","lvl2":"Identify and mitigate account holder risk","lvl3":"Configure notifications for risk signals"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/pt","lvl1":"https:\/\/docs.adyen.com\/pt\/classic-platforms","lvl2":"https:\/\/docs.adyen.com\/pt\/classic-platforms\/identify-account-holder-risk","lvl3":"\/pt\/classic-platforms\/identify-account-holder-risk\/configure-notifications-for-risk-signals"},"levels":4,"category":"Classic Platforms","category_color":"green","tags":["Configure","notifications","signals"]}}
