Are you looking for test card numbers?

Would you like to contact support?

Marketpay icon

Configure webhooks for risk signals

Learn how to set up and test webhooks for risk signals in your platform.

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.

To keep track of risk signal-related events in your platform, make sure that:

Once you complete your setup, reach out to your Adyen contact so we can enable sending the webhook type balancePlatform.score.triggered.

Example webhook

The following is an example request body for a configuration webhook of the type balancePlatform.score.triggered.

In the example, the risk signals listed in the scoreSignalsTriggered array triggered the webhook to be sent.
The value of the data.id field represents an ID that is connected to this specific score calculation. This ID changes for every score calculation and recalculation, and does not appear in your Balance Platform Customer Area.

Example webhook
  {
    "data": {
      "balancePlatform": "YOUR_BALANCE_PLATFORM",
      "creationDate": "2023-03-16T13:58:31+01:00",
      "id": "V4HZ4RBFJGXXGN82",
      "accountHolder": {
        "reference": "YOUR_ACCOUNT_HOLDER_REFERENCE",
        "description": "S.Hopper - Staff 123",
        "id": "AH00000000000000000000001"
      },
      "riskScore": 47,
      "scoreSignalsTriggered": [
        "DistinctAddressUsage",
        "HighNumberOfLegalEntitiesInIdentity",
        "HighNumberOfAccountsInIdentity",
        "AccountAge",
        "LEMCountry"
      ]
    },
    "environment": "test",
    "type": "balancePlatform.score.triggered"
  }

See also