---
title: "Mollie"
description: "Connect your Mollie account to Two Minute Billing: find your API key and connect it. No webhook to set up. Cards, SEPA Direct Debit and PayPal."
canonical_url: "https://twominutebilling.com/help/guides/connect-a-payment-gateway/mollie"
---
# Mollie

> Connect your Mollie account to Two Minute Billing: find your API key and connect it. No webhook to set up. Cards, SEPA Direct Debit and PayPal.

Two Minute Billing charges cards, SEPA Direct Debit and PayPal through **your** Mollie account.
The customer pays once on Mollie's page, and that first payment creates the mandate Two Minute
Billing charges each renewal against. You keep your Mollie rates, and Mollie pays out to your
bank as usual.

## Before you start

- A Mollie account. Mollie gives you two API keys: a **test** key that starts with `test_` and a
**live** key that starts with `live_`. Connect the test key to a test business and the live
key to a live business.
- Activate in Mollie the payment methods you want to offer. **Pay now** also offers every other
method that you activate in Mollie.
- You need permission to manage payment gateways in Two Minute Billing. The owner and admin
roles have it.

## Find your API keys

In the Mollie Dashboard, open **Developers → API keys**.

<screenshot :height="320" :single="true" :width="1920" alt="The Mollie Dashboard's API keys page, showing the test API key and the live API key" caption="Mollie → Developers → API keys. Copy the key for the mode of your business." src="gateways/mollie-api-keys">



</screenshot>

You need one value:

<table>
<thead>
  <tr>
    <th>
      Field
    </th>
    
    <th>
      Where to find it
    </th>
    
    <th>
      Looks like
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <strong>
        API key
      </strong>
    </td>
    
    <td>
      Mollie Dashboard → Developers → API keys. Use the test_ key for a test business and the live_ key for a live business.
    </td>
    
    <td>
      <code>
        live_…
      </code>
    </td>
  </tr>
</tbody>
</table>

<warning>

**Keep the API key secret.** Anyone with the API key can charge and refund in your Mollie account. Paste it only into
Two Minute Billing, which stores it encrypted, and never into an email or a chat.

</warning>

## Permissions

<warning>

**Use the profile's API key, not an organization access token.** Copy the **API key** of the payment profile (`test_…` or `live_…`). It can do everything on that
profile, so there is nothing to select. An organization access token (`access_…`) does not work.

</warning>

- **Recurring payment methods.** Turn on the methods you want to charge again, for example cards
and SEPA Direct Debit, on the profile in Mollie. **Check credentials** shows how many recurring
methods are active.
- **Recurring PayPal through Mollie** needs PayPal reference transactions on your PayPal account.
- **Webhook:** no permission is necessary. Two Minute Billing sends the notification URL with each
payment.

## Connect it in Two Minute Billing

1. Open **Settings → Payment gateways** and click **Add gateway**.
2. Select **Mollie** and paste the **API key**.
3. Select the **currencies** and the **payment methods** this account handles.
4. Click **Create gateway account**.

Then open the account and click **Check credentials**. **Healthy** means Mollie accepted the key.

The payment methods you can turn on for Mollie:

- **Cards** — Also Apple Pay and Google Pay.
- **Direct Debit (SEPA)** — EUR only. The payer sets it up with iDEAL, Bancontact, Belfius, KBC, EPS or Pay by Bank and pays EUR 0.01. The debit settles asynchronously.
- **PayPal** — Automatic payments need PayPal Reference Transactions on your PayPal business account.

## Currencies

Two Minute Billing offers these 27 currencies on Mollie:

AED, AUD, BRL, CAD, CHF, CZK, DKK, EUR, GBP, HKD, ILS, ISK, JPY, MXN, MYR, NOK, NZD, PHP, PLN, RON, RUB, SEK, SGD, THB, UAH, USD, ZAR

Each payment method takes a subset of these. BRL, MXN, MYR and THB are for PayPal only.

Some payment methods take one currency only:

<table>
<thead>
  <tr>
    <th>
      Payment method
    </th>
    
    <th>
      Currency
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      Direct Debit (SEPA)
    </td>
    
    <td>
      EUR
    </td>
  </tr>
</tbody>
</table>

If you leave **Currencies** empty on the gateway account, the account takes each currency of your business that is on this list.

## Webhooks

Mollie tells Two Minute Billing when a payment changes status: a renewal that is paid or fails,
a SEPA debit that settles days later, a refund, a chargeback.

Nothing to set up. Two Minute Billing sends the notification URL to Mollie with each payment.

Two Minute Billing reads each payment back from Mollie with your API key. You do not need a webhook secret.

<note>

**Record the outcome of a chargeback yourself.** Mollie reports a chargeback but not how it ends. When a dispute is closed, open it in
**Disputes** and click **Mark as won** or **Mark as lost**.

</note>

## Test it

In your test business, create a customer and save a card for it. On Mollie's test payment page,
enter the test card `4543 4740 0224 9996` with any expiry date and any CVC, and complete the
payment. Collect an invoice: it is marked paid when Mollie reports the payment, and **Logs**
shows the call to Mollie and Mollie's answer.

## Go live

1. In Mollie, make sure the payment methods you turn on are activated for live payments.
2. Copy the **live** API key (`live_…`) from **Developers → API keys**.
3. In your **live** business, add Mollie with that key.

## Troubleshoot

- **Check credentials says "We could not check the credentials." with "This is a live business,
so the Mollie API key must start with live_."** The key belongs to the other mode. Paste the
key that matches the business: `live_…` for a live business, `test_…` for a test business.
- **A SEPA debit stays pending.** SEPA debits take days to settle. Two Minute
Billing marks the invoice paid when Mollie reports the debit paid.
- **A customer cannot set up automatic PayPal payments.** Mollie needs PayPal Reference
Transactions on your PayPal business account for that.
- **A dispute stays open after the chargeback is decided.** Mollie does not send the outcome.
Record it with **Mark as won** or **Mark as lost** in **Disputes**.

## Related

- [Payment gateways overview](https://twominutebilling.com/help/guides/connect-a-payment-gateway)
- [Recover failed payments](https://twominutebilling.com/help/guides/recover-failed-payments)
- [Handle disputes](https://twominutebilling.com/help/guides/handle-disputes)


## Sitemap

See the full [sitemap](https://twominutebilling.com/sitemap.md) for all pages.