PHPackages                             wp-pay-gateways/mollie - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Payment Processing](/categories/payments)
4. /
5. wp-pay-gateways/mollie

ActiveWordpress-plugin[Payment Processing](/categories/payments)

wp-pay-gateways/mollie
======================

Mollie driver for the WordPress payment processing library.

v4.19.0(3mo ago)635.2k↑41.7%1[5 issues](https://github.com/pronamic/wp-pronamic-pay-mollie/issues)8GPL-3.0-or-laterPHPPHP &gt;=8.2CI failing

Since Jan 19Pushed 3mo ago4 watchersCompare

[ Source](https://github.com/pronamic/wp-pronamic-pay-mollie)[ Packagist](https://packagist.org/packages/wp-pay-gateways/mollie)[ Docs](http://www.wp-pay.org/gateways/mollie/)[ RSS](/packages/wp-pay-gateways-mollie/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (25)Versions (91)Used By (8)

 [ ![WordPress Pay » Gateway » Mollie](https://camo.githubusercontent.com/b825b47e9306076778ad9eeadfdf8b81433d15fe2e7890f0c101776734aed6f5/68747470733a2f2f7777772e77702d7061792e6f72672f6173736574732f70726f6e616d69632d7061792e7376676f2d6d696e2e737667) ](https://www.wp-pay.org/)

WordPress Pay » Gateway » Mollie
================================

[](#wordpress-pay--gateway--mollie)

 Mollie driver for the WordPress payment processing library.

Table of contents
-----------------

[](#table-of-contents)

- [Status](#status)
- [Webhook URL](#webhook-url)
- [Simulate Requests](#simulate-requests)
- [REST API](#rest-api)
- [WP-CLI](#wp-cli)
- [WordPress Filters](#wordpress-filters)
- [Links](#links)
- [Documentation](#documentation)

Status
------

[](#status)

[![Build Status](https://camo.githubusercontent.com/56b007019d245575bd449a32ae3eae3815482b7b73a2df9ab5ec6c56e8ae3f77/68747470733a2f2f7472617669732d63692e6f72672f77702d7061792d67617465776179732f6d6f6c6c69652e7376673f6272616e63683d646576656c6f70)](https://travis-ci.org/wp-pay-gateways/mollie)[![Coverage Status](https://camo.githubusercontent.com/dff0b98308ae59d6f5ef095cb0eb8c15ba274a475364afb16c509e26b35c509a/68747470733a2f2f636f766572616c6c732e696f2f7265706f732f77702d7061792d67617465776179732f6d6f6c6c69652f62616467652e7376673f6272616e63683d6d617374657226736572766963653d676974687562)](https://coveralls.io/github/wp-pay-gateways/mollie?branch=master)[![Latest Stable Version](https://camo.githubusercontent.com/cac806059edf30d56e517b57da50370d0f1ccb4a45a6b0bcc11ec3a5b5c16b25/68747470733a2f2f706f7365722e707567782e6f72672f77702d7061792d67617465776179732f6d6f6c6c69652f762f737461626c652e737667)](https://packagist.org/packages/wp-pay-gateways/mollie)[![Total Downloads](https://camo.githubusercontent.com/e9294b6da6241044d918498a2eb077be4e6333d5a2bf26c66603034a7ae16fc5/68747470733a2f2f706f7365722e707567782e6f72672f77702d7061792d67617465776179732f6d6f6c6c69652f646f776e6c6f6164732e737667)](https://packagist.org/packages/wp-pay-gateways/mollie)[![Latest Unstable Version](https://camo.githubusercontent.com/9186b3f7d8a6070e08a6e3627b1a1753270a5a8bad02728be2423ada71005710/68747470733a2f2f706f7365722e707567782e6f72672f77702d7061792d67617465776179732f6d6f6c6c69652f762f756e737461626c652e737667)](https://packagist.org/packages/wp-pay-gateways/mollie)[![License](https://camo.githubusercontent.com/115e35d2271bc8827c3b9bd9206d5f6a08336197fda94444fcc864430a90f14a/68747470733a2f2f706f7365722e707567782e6f72672f77702d7061792d67617465776179732f6d6f6c6c69652f6c6963656e73652e737667)](https://packagist.org/packages/wp-pay-gateways/mollie)[![Built with Grunt](https://camo.githubusercontent.com/5a18e9e04b024242dbdc41e3c42d81a4979025240230c1801754b0eba43fb414/687474703a2f2f63646e2e6772756e746a732e636f6d2f6275696c74776974682e737667)](http://gruntjs.com/)

Webhook URL
-----------

[](#webhook-url)

Please note that an webhook URL with the host `localhost` or with the TLD `.dev` are not allowed, this library will check on WordPress URL's on `localhost` or on the `.dev` TLD and will not pass the `webhookUrl` parameter to Mollie. If you want to test the Mollie webhook URL on an local development environment you could use a service like [ngrok](https://ngrok.com/).

> Beste Remco,
>
> Ja dit is inderdaad het probleem. .dev URL's worden niet ondersteunt. Deze zal ook niet bereikbaar zijn.
>
> Als je report URL niet publiekelijk bereikbaar is zou je een service als  kunnen gebruiken. Dit is een programma die je lokaal draait en als proxy werkt. Misschien heb je er iets aan.
>
> Met vriendelijke groet,
>
> Lennard van Gunst Mollie

Simulate Requests
-----------------

[](#simulate-requests)

### Webhook

[](#webhook)

```
curl --request POST "https://www.example.com/wp-json/pronamic-pay/mollie/v1/webhook" \
        --data "id=test" \
        --user-agent "Mollie HTTP"

```

REST API
--------

[](#rest-api)

The Pronamic Pay Mollie gateway can handle Mollie webhook requests via the WordPress REST API.

**Route:** `/wp-json/pronamic-pay/mollie/v1/webhook`

The WordPress REST API Mollie webhook endpoint can be tested with for example cURL:

```
curl --request POST --data "id=tr_d0b0E3EA3v" http://pay.test/wp-json/pronamic-pay/mollie/v1/webhook

```

Legacy webhook URL:

```
curl --request POST --data "id=tr_d0b0E3EA3v" "http://pay.test/?mollie_webhook"

```

WP-CLI
------

[](#wp-cli)

### What is WP-CLI?

[](#what-is-wp-cli)

For those who have never heard before WP-CLI, here's a brief description extracted from the [official website](https://wp-cli.org/).

> **WP-CLI** is a set of command-line tools for managing WordPress installations. You can update plugins, set up multisite installs and much more, without using a web browser.

### Commands

[](#commands)

```
$ wp pronamic-pay mollie
usage: wp pronamic-pay mollie customers
   or: wp pronamic-pay mollie organizations

See 'wp help pronamic-pay mollie ' for more information on a specific command.
```

### Command `pronamic-pay mollie customers synchronize`

[](#command-pronamic-pay-mollie-customers-synchronize)

Synchronize Mollie customers to WordPress.

```
$ wp pronamic-pay mollie customers synchronize
```

### Command `pronamic-pay mollie customers connect-wp-users`

[](#command-pronamic-pay-mollie-customers-connect-wp-users)

Connect Mollie customers to WordPress users by email.

```
$ wp pronamic-pay mollie customers connect-wp-users
```

WordPress Filters
-----------------

[](#wordpress-filters)

### `pronamic_pay_mollie_payment_description`

[](#pronamic_pay_mollie_payment_description)

#### Description

[](#description)

Filters the Mollie payment description.

#### Usage

[](#usage)

```
\add_filter( 'pronamic_pay_mollie_payment_description', 'your_function_name', 10, 2 );
```

#### Parameters

[](#parameters)

**`$description`** | string

Mollie payment description.

**`$payment`** | [Payment Object](https://github.com/wp-pay/core/blob/2.3.0/src/Payments/Payment.php)

The WordPress payment object.

#### Examples

[](#examples)

```
\add_filter( 'pronamic_pay_mollie_payment_description', function( $description, $payment ) {
	$periods = $payment->get_periods();

	if ( null === $periods ) {
		return $description;
	}

	foreach ( $periods as $period ) {
		$phase = $period->get_phase();

		$subscription = $phase->get_subscription();

		$description = \sprintf(
			'%s - %s - %s',
			$subscription->get_description(),
			$period->get_start_date()->format_i18n( 'd-m-Y' ),
			$period->get_end_date()->format_i18n( 'd-m-Y' )
		);
	}

	return $description;
}, 10, 2 );
```

### `pronamic_pay_mollie_payment_metadata`

[](#pronamic_pay_mollie_payment_metadata)

#### Description

[](#description-1)

Filters the Mollie payment metadata.

#### Usage

[](#usage-1)

```
\add_filter( 'pronamic_pay_mollie_payment_metadata', 'your_function_name', 10, 2 );
```

#### Parameters

[](#parameters-1)

**`$metadata`** | mixed

Mollie payment metadata.

**`$payment`** | [Payment Object](https://github.com/wp-pay/core/blob/2.3.0/src/Payments/Payment.php)

The WordPress payment object.

#### Examples

[](#examples-1)

```
\add_filter( 'pronamic_pay_mollie_payment_metadata', function( $metadata, $payment ) {
	$data = array();

	$customer = $payment->get_customer();

	if ( null !== $customer ) {
		$vat_number = $customer->get_vat_number();

		if ( null !== $vat_number ) {
			$data['vat_number'] = $vat_number->normalized();
		}
	}

	switch ( $payment->get_source() ) {
		case 'easydigitaldownloads':
			$data['edd_order_id'] = $payment->get_source_id();

			break;
		case 'gravityformsideal':
			$data['gf_entry_id'] = $payment->get_source_id();

			break;
	}

	return (object) $data;
}, 10, 2 );
```

### `pronamic_pay_mollie_payment_billing_email`

[](#pronamic_pay_mollie_payment_billing_email)

#### Description

[](#description-2)

Filters the Mollie payment billing email used for bank transfer payment instructions.

#### Usage

[](#usage-2)

```
\add_filter( 'pronamic_pay_mollie_payment_billing_email', 'your_function_name', 10, 2 );
```

#### Parameters

[](#parameters-2)

**`$billing_email`** | string|null

The Mollie payment billing email.

**`$payment`** | [Payment Object](https://github.com/wp-pay/core/blob/2.3.0/src/Payments/Payment.php)

The WordPress payment object.

#### Examples

[](#examples-2)

```
\add_filter( 'pronamic_pay_mollie_payment_billing_email', function( $billing_email, $payment ) {
	$billing_email = 'mollie-billing-email@example.com';

	return $billing_email;
}, 10, 2 );
```

Links
-----

[](#links)

-

Errors
------

[](#errors)

### The customer id is invalid

[](#the-customer-id-is-invalid)

```
DELETE
	meta
FROM
	wp_usermeta AS meta
		INNER JOIN
	wp_users AS user
			ON user.ID = user_id
WHERE
	(
		meta_key = '_pronamic_pay_mollie_customer_id'
			OR
		meta_key = '_pronamic_pay_mollie_customer_id_test'
	)
		AND
	user.user_login = 'username'
;
```

Documentation
-------------

[](#documentation)

- [Mollie API](https://www.mollie.nl/files/documentatie/payments-api.html)
- [GitHub repository Mollie API client for PHP](https://github.com/mollie/mollie-api-php)

###  Health Score

56

—

FairBetter than 98% of packages

Maintenance63

Regular maintenance activity

Popularity32

Limited adoption so far

Community20

Small or concentrated contributor base

Maturity91

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 61.6% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~46 days

Recently: every ~32 days

Total

88

Last Release

112d ago

Major Versions

1.1.15 → 2.0.02018-05-14

2.2.4 → 3.0.02021-08-05

3.1.0 → 4.0.02022-01-11

PHP version history (7 changes)1.0.0PHP &gt;=5.2.4

1.1.13PHP ^5.3

2.0.7PHP &gt;=5.6.20

4.3.0PHP &gt;=7.4

v4.7.0PHP &gt;=8.0

v4.13.0PHP &gt;=8.1

v4.16.0PHP &gt;=8.2

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/869674?v=4)[Remco Tolsma](/maintainers/remcotolsma)[@remcotolsma](https://github.com/remcotolsma)

---

Top Contributors

[![remcotolsma](https://avatars.githubusercontent.com/u/869674?v=4)](https://github.com/remcotolsma "remcotolsma (790 commits)")[![rvdsteege](https://avatars.githubusercontent.com/u/10371164?v=4)](https://github.com/rvdsteege "rvdsteege (493 commits)")

---

Tags

idealmolliepayphpwordpresswp-pronamic-pay-gatewaywordpressgatewaymolliewppaypronamic

###  Code Quality

Static AnalysisPHPStan, Psalm, Rector

Type Coverage Yes

### Embed Badge

![Health badge](/badges/wp-pay-gateways-mollie/health.svg)

```
[![Health](https://phpackages.com/badges/wp-pay-gateways-mollie/health.svg)](https://phpackages.com/packages/wp-pay-gateways-mollie)
```

###  Alternatives

[wp-pay/core

Core components for the WordPress payment processing library.

29119.8k97](/packages/wp-pay-core)[wp-pay-extensions/gravityforms

Gravity Forms driver for the WordPress payment processing library.

1133.3k2](/packages/wp-pay-extensions-gravityforms)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
