Skip to content

Maintenance

boxblinkracer edited this page May 6, 2021 · 1 revision

Lots of shops use a separate maintenance page and mode if anything is being changed or modified. This is usually no problem, but still you might want to consider webhook notification handling in combination with a maintenance mode.

What is happening?

If your shop is in maintenance mode, then no page or data is coming through. In most cases it's all "blocked" and only the maintenance page is visible.

This does also mean, that Mollie cannot send you notifications about payment updates.

Normally Mollie would retry it, but if your HTTP Status code of your maintenance page is accidentally 200 (OK), then Mollie thinks you got the update and that you have processed it.

Thus it won't be sent again and you will miss payment updates that have been sent while your shop is in maintenance mode!

How to handle this?

The best option would be, to have a system for your online shop, that is always ready to receive notifications. If that's not possible, we recommend one of these 2 options:

  1. Try to whitelist the webhook notification URL, so that updates still get through. Please note - this will only work if the shop isn't broken while updating it. It might work in most cases, but if you want to be 100% sure, please go with option #2.

  2. Make sure your maintenance page does NOT use HTTP Status Code 200 OK. Please use something else that indicates a temporary problem with your service. Status 503 (Service Unavailable) would be a good fit for Mollie as well as for Google to indicate that you are currently working on the site.

Clone this wiki locally