Step 4: Set up webhooks

To inform your Commerce Cloud store of payment status changes, Adyen uses webhooks, sent as HTTP callbacks to endpoints on your server. To receive webhooks, you need to enter your server's details in the Customer Area, and add the webhooks credentials to the Salesforce Business Manager.

1. Set up webhooks in the Customer Area

Log in to your Customer Area. If you want to configure webhooks for a merchant account, switch to that merchant account.
Go to Developers > Webhooks.
Select Webhook.
In the row for the Standard webhook, select Add.

Configure General settings:

Setting	Description
Server configuration	- URL: Your webhook server's URL, adding /Adyen-Notify at the end, for example: `https://zzft-xx.sandbox.XXXX.dx.commercecloud.salesforce.com/on/demandware.store/Sites-RefArch-Site/default/Adyen-Notify` - Method: HTTP POST. - Encryption Protocol: TLSv.1.3.
Merchant accounts	Select which merchant accounts this webhook is for.

Configure Security settings:

Setting	Description
Basic authentication	Enter your server's username and password. You need to enter these credentials in the Salesforce Business Manager later.
HMAC Key	Generate the HMAC Key, copy it, and store it securely in your system. You need to enter the HMAC key in the Salesforce Business Manager later. We strongly recommend that you use HMAC signatures to protect your server from unauthorised webhook events.

Select Save changes.

2. Add webhook credentials to the Salesforce Business Manager

In the Salesforce Business Manager, go to Merchant tools > Site Preferences > Adyen Settings.
In the Webhook settings section:
- In the Adyen Notifications User and Adyen Notifications Password box, enter the username and password for notifications from your Customer Area.
- If applicable, enter your HMAC key.
Select Save in the upper-right corner of the screen.

3. Test webhooks

To test your webhooks:

Your server must acknowledge webhooks with a successful HTTP response status code (like 200).

If the test webhook failed, you get an error message with the reason. Troubleshoot the problem.

4. Configure scheduled jobs

Webhooks are stored in Commerce Cloud as custom object instances to be processed by scheduled jobs.

After the metadata import, a scheduled job with ID Process is added to the Salesforce Business Manager: Administration > Operations > Jobs. This scheduled job has two steps (you can check this in the Job Steps tab):

Process – Processes the webhook and updates the payment status of the order.
Clean – Deletes the custom object instance, once it has been processed.

To optimize the processing of your instances, we recommend that you set the frequency of this scheduled job to 1 minute:

Go to the Schedule and History tab for the Process scheduled job.
Set Trigger to Recurring Interval.
In the Run Time pane, set Amount to 1, and Interval to Minutes.

Set up the cartridge

Next steps