如何解决诸如“未处理的事件”以及 301、302、401 或 500 错误之类的 webhook 问题?

Troubleshooting webhooks

Webhook event issues can be related to misconfigured webhooks or an issue with cronjob.

Webhooks are responsible for sending the notifications from the Adyen platform to your server. Then, the server sends a notification to the Adobe Commerce integration.

If you’re testing the notification endpoint in Customer Area > Developers > Webhooks > Troubleshoot and the plugin returns with a 301, 302 or 401 error instead of an [accepted] response, there might be something wrong in the webhook endpoint settings.

 

image1.png

Webhook response

Meaning

Check


200 [accepted]

Webhook is working fine


300 errors

Your account’s endpoint isn’t accepting webhooks properly

  • Authentication errors: are the webhook username and password the same in Adobe Commerce and Adyen?
  • If the HMAC key is configured, is it the same in Adobe Commerce and Adyen?
  • Make sure the endpoint URL matches the format in our documentation.

400 errors

The request wasn’t applied. Valid authentication credentials are missing.

  • Authentication errors; are the webhook username and password the same in Adobe Commerce and Adyen?
  • If the HMAC key is configured, is it the same in Adobe Commerce and Adyen?

500 errors

Your server isn’t correctly responding to our backend system.

We can’t perform further action as we have no insight into your server configuration.

The error "Maximum line length limit exceeded" means that the response we receive from the webhook is incorrect. It’s possible it includes [accepted] but it still exceeds the maximum number of characters in the headers or content.

We suggest removing extra headers from the request.

Note: If you’re configuring the endpoint with http, try using https instead.

Note: If you set the SSL version to SSL, try setting it on TLSv1.2 instead.

Issues with webhooks related to cron job

If Adobe Commerce shows the message you have [number] unprocessed notifications when testing the endpoint, there’s a problem with the system's cron job. The Adobe Commerce cron doesn’t only accept the webhooks, but also has to process the webhooks to update the status in Adobe Commerce.

Sometimes the issue is related to your server communication and cron. In that case, the comment history on your order page wouldn't show the Adyen HTTP Notification(s) messages.

To process payments, the Adobe Commerce cron will have to acknowledge each of the webhook events we send to your server with an [accepted]. Second, your cron will need to process the webhook events.

Tip: Find more possible reasons you don’t receive webhook events.

 

image4.png

Processing notifications

If the notifications are being accepted, it's possible the cron isn't processing the notifications. Check this by testing the configuration in the Webhooks (with the Edit & Test button).

Note: In those cases, please check your cron.

Tip: If this didn’t help, contact our support and attach the order page screenshot and log files.

 

让我们来练习一下吧

了解有关此主题的更多信息并练习运用所学的内容。

Stylized illustration of a customer support representative with headset.

您是否需要其他帮助?

联系我们的支持团队

通过添加图像或屏幕截图向我们发送您的问题的详细信息。

提交请求