Enable Adyen Notifications

Overview

Adyen uses notifications (webhooks) to send asynchronous updates about critical payment events such as authorisation, capture, cancellation, or refund.

In the SCAYLE setup, SCAYLE provides and operates the webhook endpoint that receives these notifications. You do not need to build or host your own webhook endpoint.

Instead, you must configure the SCAYLE webhook URL in the Adyen Customer Area so that Adyen can deliver all payment events directly to SCAYLE.

This guide explains how to enable Adyen notifications by correctly configuring Adyen to send webhooks to SCAYLE.

Webhook Responsibility Model

The following table outlines the responsibilities of each party in the notification flow:

Obtain the SCAYLE Adyen Webhook URL

SCAYLE provides a dedicated webhook URL that must be configured in Adyen.

• The webhook URL is provided by your SCAYLE Account Manager during the onboarding process.
• Important: Separate URLs are used for the Sandbox and Live environments. Ensure you use the correct URL for the corresponding environment to avoid service disruption.

Configure Notifications in the Adyen Customer Area

Follow these steps to set up the notification service in your Adyen account:

1. Log in to the Adyen Customer Area.
2. Navigate to: Developers → Webhooks.
3. Click Create new webhook (or select and edit an existing one).

🔒 Security Settings

SCAYLE validates all incoming notifications using Basic Auth.

• A specific username and password for this authentication will be shared with you by your SCAYLE Account Manager during the onboarding process.

⚙️ Event Configuration

Enable at least the following standard payment events:

• AUTHORISATION
• CAPTURE
• CANCELLATION
• REFUND

SCAYLE will automatically map these essential events to internal payment and order state updates.

Test the Webhook in Adyen

After saving your webhook configuration in the Adyen Customer Area, follow these steps to verify it is working correctly:

1. Send Test Notification: Use the Send test notification feature within the Adyen Customer Area.
2. Verify Delivery: Confirm that the test notification is marked as successfully delivered.
3. Expected SCAYLE Response: Upon successful delivery, SCAYLE will respond to Adyen with the required response body: accepted.

Troubleshooting a Failed Test

If the test notification is not marked as successfully delivered:

1. Check Adyen Error: Review the specific error message shown in the Adyen Customer Area.
2. Contact SCAYLE Support: Prepare the following essential information and contact SCAYLE Support for assistance:
   • Webhook ID
   • Timestamp of when the test was initiated.
   • Full Error Message shown in Adyen.

Environment Separation

Make sure you configure the correct webhook URL for each environment and avoid mixing Sandbox and Live URLs.