# Mollie Module

https://docs.wisecp.com/de/mollie-module

Collect payments through Mollie, where the client picks a European payment method on Mollie's own page.

## Reaching the Screen

Go to **Settings → Financial → Payment Gateways**, open **All Modules** and click the Mollie Payments card: `{admin}/modules/payment?module=MolliePayments`

Ticking **Status** and saving lists the method on the payment step. Use [Payment Gateways](https://docs.wisecp.com/en/payment-modules) to order the methods clients see.

## What Is on the Screen

The card holds the Mollie API key, two subscription settings and the shared gateway settings.

Mollie has no page of its own inside your checkout. The client is sent to the payment page and forwarded to Mollie from there.

Subscriptions do not work in the current version. A refund sent from the panel is not accepted either; see Things to Watch and Tasks. Stored cards, automatic payments from a saved card and installments are not supported.

## Before You Configure It

- A Mollie account with a website profile, created from your organisation name in the top left corner: **Settings → Profiles → Create profile**. Each profile carries its own live key and test key, and keys are never shared between profiles.
- The payment methods you want enabled on that profile, switched on under **Organisation settings → Payment methods**. Cards and direct debit need extra checks from Mollie first.
- A currency Mollie accepts. If your install prices in another one, set **Converting Currency**.

## Fields

- **Status**: Turns the module on. While it is off the other fields stay locked and clients are never offered the method.
- **API Key**: Required. The key of your website profile. A test key starts with `test_` and a live key with `live_`.
- **Disable Subscription Feature**: Ticking it removes the subscription offer. Clients then always pay once, even when the order renews. Keep it ticked in the current version; see Things to Watch.
- **Update Subscription Fee**: Meant to keep the recurring amount at Mollie in step with the service price. Without a working subscription it has no effect.

Commission, converting currency, accepted amount range and country lists behave the same on every gateway; see [Payment Gateways](https://docs.wisecp.com/en/payment-modules). **Callback URL**, **Success URL** and **Failed URL** cannot be edited. Mollie is handed the callback address with each payment, so you register nothing in your Mollie dashboard.

## Tasks

### Connect your Mollie profile

1. In your Mollie dashboard open **Developers → API access tokens** and click **Create access token**. Choose a standard API key for your profile in test mode. The key is shown once, so copy it there and then.
2. Open the Mollie Payments card under **All Modules** and tick **Status**.
3. Paste the test key of your website profile into **API Key**.
4. Click **Save Changes**. The method now appears on the payment step.

### Run a test payment

1. Place a small order as a client and choose Mollie on the payment step.
2. Click **Pay Now**. Use an order with no renewable items, so the payment goes straight to Mollie.
3. On Mollie's test page mark the payment as paid. The client returns and the invoice is marked as paid, which activates the order.
4. Replace the key with the live one and repeat with a real low-value payment. A live key only collects once Mollie has approved that profile.

### Refund a payment

1. Open the invoice from [Invoice Detail](https://docs.wisecp.com/en/invoice-detail-overview).
2. Set its status to refunded, choose **Add as expense** or **Add as account credit** as the refund method and confirm. **Refund via payment gateway** fails in the current version and leaves the status unchanged.
3. Return the money from your Mollie dashboard.

## Things to Watch

> **A test key collects nothing**
> 
> Payments made with a profile's test key mark invoices as paid and activate orders. No money moves. Swap in the live key before you open the method to clients.

> **Subscriptions do not work in the current version**
> 
> The payment page of a renewable order cannot be completed. A payment that did go through would leave no agreement in WISECP. Mollie would then collect while the ordinary renewal invoice is issued too. Keep **Disable Subscription Feature** ticked: renewable orders are then paid once and invoiced the ordinary way.

> **A refund from the panel is not accepted**
> 
> **Refund via payment gateway** fails for a Mollie payment. The payment reference is missing, and the invoice stays as it is. Refund from your Mollie dashboard and record it with **Add as expense**.

## Required Privileges

**Payment Module Settings** (`MODULES_PAYMENT_SETTINGS`) is required.

## Related Articles

- [Payment Gateways](https://docs.wisecp.com/en/payment-modules)
- [Invoice Detail](https://docs.wisecp.com/en/invoice-detail-overview)