Configuring the notification webhooks
How to set up Adyen's notification system
You want to rely on Adyen's webhooks notification system, which is the only way can receive automatic updates about requests that are processed asynchronously (e.g. iDEAL transactions or payment modifications — captures, voids, and refunds).
You can enable Adyen's notification system in two separate steps:
- 1.
- 2.
To configure the notification system, first you need to access your Adyen's customer area and follow the procedure detailed here. On the Server configuration and Security sections, make sure to perform the following actions:
- Select JSON as the method.
- Select TLSv1.2 as the protocol.
- Generate the HMAC key to verify the integrity of notifications and copy it.
Commerce Layer does not support the Adyen webhooks SOAP or HTTP methods, but the JSON one only.
Once the notification webhooks are properly configured, you need to update your Adyen gateway and specify you're going to support the asynchronous notifications system.
To do that, send a
PATCH request to the /api/adyen_gateway/:id endpoint, setting the async_api attribute as true and passing the HMAC key you generated in the previous step as the webhook_endpoint_secret value.Request
Response
The following request updates the Adyen gateway identified by the "HGFvfREwAX" ID in order to use the Adyen asynchronous APIs:
curl -g -X PATCH \
'http://yourdomain.commercelayer.io/api/adyen_gateways/HGFvfREwAX' \
-H 'Accept: application/vnd.api+json' \
-H 'Authorization: Bearer your-access-token' \
-H 'Content-Type: application/vnd.api+json' \
-d '{
"data": {
"type": "adyen_gateways",
"id": "HGFvfREwAX",
"attributes": {
async_api: true,
webhook_endpoint_secret: 'xxxx-yyyy-zzzz'
}
}
}
}'
On success, the API responds with a
200 OK status code, returning the updated Adyen gateway object:{
"data": {
"id": "HGFvfREwAX",
"type": "adyen_payments",
"links": {
"self": "https://yourdomain.commercelayer.io/api/adyen_gateways/HGFvfREwAX"
},
"attributes": {
"name":"Adyen 01",
"live_url_prefix":"bdf1c25d-b4e3-4c97-a51c-105e35dcbe27-AdyenDemo",
"async_api": true,
"webhook_endpoint_secret": "xxxx-yyyy-zzzz",
"webhook_endpoint_url":"http://core.commercelayer.dev/webhook_callbacks/adyen_gateways/HGFvfREwAX",
"created_at": "2018-01-01T12:00:00.000Z",
"updated_at": "2018-01-01T12:00:00.000Z",
"reference": null,
"reference_origin": null,
"metadata": {}
},
"relationships": {
"order": {
"links": {...}
}
},
"meta": {
"mode": "test"
}
}
}
Be sure to enable webhooks on the Adyen dashboard as the very first step, and by the way always before setting the gateway's
async_api attribute to true, otherwise you risk all of your payment modifications failing silently.Last modified 8mo ago