Skip to content

Commit 9a9a839

Browse files
authored
Merge pull request #6683 from arti-bol/patch-1
Updated webhook docs for clarity
2 parents a508045 + 8831b11 commit 9a9a839

File tree

1 file changed

+16
-5
lines changed

1 file changed

+16
-5
lines changed

commerce-add-ons/payment-providers/mollie/how-to-guides/testing-mollie-webhooks-locally.md

Lines changed: 16 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -5,17 +5,28 @@ description: >-
55
Webhooks.
66
---
77

8-
# How to test Mollie webhooks locally
8+
# How to Test Mollie Webhooks Locally
99

10-
The Mollie payment provider uses webhooks to finalize payments. Due to this, it can be tricky to test payments locally as Mollie must have a public-facing URL to be able to notify you.
10+
Mollie uses webhooks to finalize payments, but testing them locally can be challenging because Mollie requires a public-facing URL to send notifications. Local URLs like `http://localhost:3000` or `http://localhost:8080` are not accessible from the internet.
1111

12-
You could expose your website through your network's firewall or use tools that to create temporary tunnels through your network.
12+
**Solution: Use a Local Tunnel**
1313

14-
The following guide will use [ngrok](https://ngrok.com/) to create temporary tunnels through your network.
14+
A local tunnel is a port-forwarding technique that exposes a local API service (running on a specific port) to the internet. This is done through a public HTTPS URL. It allows you to:
15+
16+
1. Make your local server accessible online temporarily.
17+
2. Use the generated public URL in Mollie’s webhook settings.
18+
3. Receive webhook events directly on your local development machine.
19+
20+
With a local tunnel, you can test and debug Mollie webhooks without deploying your application to a live environment. Here are two popular tools to create a secure public URL for testing Mollie webhooks:
21+
22+
1. [Ngrok](https://ngrok.com/?utm_source=docs.umbraco.com) is a widely used tool that creates a secure tunnel from your local machine to a public URL. It supports advanced configurations and works well with webhook-based systems.
23+
2. [Beeceptor’s Local Tunnel](https://beeceptor.com/local-tunnel/?utm_source=docs.umbraco.com) gives a public HTTP mock server that allows you to expose your local server to the internet securely. Supports HTTPs, mock rules and comes with request history. The Free plan includes 50 requests/day per tunnel or endpoint.
24+
25+
The following guide will use [ngrok](https://ngrok.com/?utm_source=docs.umbraco.com) to create temporary tunnels through your network.
1526

1627
## Step 1: Install ngrok
1728

18-
1. Head on over to [ngrok.com](https://ngrok.com/).
29+
1. Head on over to [ngrok.com](https://ngrok.com/?utm_source=docs.umbraco.com).
1930
2. Download and install the tool on your system.
2031

2132
## Step 2: Launch ngrok

0 commit comments

Comments
 (0)