Receiving Payments

Three primary ways customers pay you via Mollie. Each is suited to a different scenario.

A. Payment Request on an emailed invoice

The most common pattern for B2B. You email a Sales Invoice; the email includes a payment link; the customer clicks to pay.

1. Open the Sales Invoice → click Create Payment Request.

2. ERPNext creates a Payment Request linked to the Sales Invoice.

3. Click Get Payment URL on the Payment Request. ERPNext returns a URL like:

   https://<your-site>/api/method/mollie_integration.mollie.api.pay?doctype=Payment Request&docname=PR-00001

4. Use Email from the Payment Request form (or paste the URL into any email / message). The link is persistent — it doesn't expire, doesn't get stale, and always reflects the current outstanding amount.

5. When the customer clicks, our pay endpoint creates the Mollie payment on the fly using the invoice's current outstanding amount, then redirects them to Mollie's checkout.

6. After payment, Mollie webhooks our endpoint; we create the Payment Entry and mark the invoice paid.

Why this is the default mode. Customers ignore emails for weeks sometimes. With Create on Click, the URL still works two months later — the payment is created at click time. Compare Create Immediately mode below.

B. QR code on a printed invoice

Same flow as A, but the URL is embedded as a QR code on the printed invoice.

1. On the Sales Invoice, look for the QR-code section in the print format (Mollie integration adds a print-format snippet you can include).
2. Print and send the paper invoice; the QR code goes on it.
3. Customer scans, lands on the Mollie checkout via the same pay endpoint.

Useful for B2C in industries where paper invoices are still common (legal services, healthcare, some retail).

C. Web Shop checkout (immediate payment)

For ERPNext Web Shop, customers want to pay immediately at checkout, not after an email round-trip. Set Payment URL Type to Create Immediately in Mollie Settings:

1. Customer fills the cart and clicks Checkout.
2. ERPNext creates the Sales Order + Payment Request.
3. The integration calls Mollie's API right away to create a payment.
4. Mollie returns a checkout URL like https://checkout.mollie.com/pay/xxx.
5. Customer is redirected immediately.
6. After payment, the webhook arrives and the Sales Order / Sales Invoice transitions to Paid.

Trade-off: the Mollie checkout URL expires after a short window (typically a few hours). For cart checkout that's fine — customers pay right away. For emailed invoices, use Create on Click (mode A).

How the Payment Entry gets created

Regardless of which entry mode you use, the end state is the same:

1. Customer completes Mollie checkout.
2. Mollie POSTs to your webhook endpoint with the payment status.
3. The integration validates the webhook signature.
4. On paid status, the integration creates an ERPNext Payment Entry referencing the Sales Invoice (or Sales Order → Sales Invoice → Payment Entry chain).
5. The Sales Invoice's outstanding amount updates; status moves to Paid once fully covered.

You don't manually create the Payment Entry. The integration does it on receipt of a valid webhook.

What you'll see in the Mollie dashboard

Every payment in your Mollie dashboard maps to one ERPNext Payment Entry via the Mollie payment ID (tr_xxxxx). The ID is stored on the Payment Entry's custom field, so you can pivot from either side:

• From ERPNext — open the Payment Entry → see Mollie ID → search it in the Mollie dashboard for the full payment-method details.
• From Mollie — copy the payment ID → search Payment Entry by ID → see the Sales Invoice it paid.

When the webhook doesn't arrive

The most common production issue. Causes:

• Webhook URL unreachable. Mollie can't POST to your site — usually a firewall / SSL issue. Mollie's dashboard shows webhook delivery attempts under Developers → Logs.
• Webhook signature mismatch. Almost always means the Webhook Secret in Mollie Settings doesn't match what Mollie has. Re-save Mollie Settings to regenerate, then update the URL in Mollie's dashboard.
• ERPNext error during webhook handling. Check Integration Request List for the webhook receipt — there's usually a clear traceback.

Recovery: Mollie retries failed webhooks for up to 24 hours. If the issue is fixed within that window, the payment auto-reconciles. After 24 hours, you'll need to manually create the Payment Entry referencing the Mollie payment ID.