background

Mollie

Tags:pspintegrationmolliereconciliationpayment

Mollie can be used to do:

  • One-time payments (payment links, invoices)
  • Recurring payments via Direct Debit and credit cards
  • Signing agreements with a first payment

Supported and active payment methods can be viewed on the details of your payment provider gateway:

Mollie offers two types of API keys:

Live key

The live-key is sufficient for direct and recurring payments, reconciliation files can be generated:

  • the next business day after a payment for payment links
Access key

On top of the functions that a live-key offers, the Organization Access Token (access key) also allows us to read all settlements of your Mollie account:

  • Reconciliation files in Twikey are 1-on-1 with Mollie
  • Reconciliation files can be generated only once available on Mollie
  • The Generated date of reconciliation files is equal to the creation date in Mollie

Enable at least one of the following options on your access key to use it in Twikey:

customer.write: create new customer
mandate.write: edit a mandate
mandate.read: view mandate
payment.read: get payments
payment.write: create, update, cancel payment request
profiles.read: consult your profile
refunds.read: view refund
refunds.write: create refund
settlement.read: consult payoffs

Activating an Organization Access Token or 'access_' API token allows us to retrieve all settlements and invoices of your account to automate your bookkeeping and makes it possible to use routing of PSP in Twikey. The 'access_' token offers a different output file then a 'live_' token and the delay to generate the payment link files can be longer and depends on the processing of the PSP.

Configuration

To activate the integration in Twikey:

  • Go to Settings > Integrations
  • Under Payment service providers, select Mollie
  • In the Configuration tab:
    • API key: Enter your Mollie API key. You can find it here on the Mollie website.
    • Profile:
      • If you are using an Access key, enter your profile .
      • If you are using a Live Key, leave this field empty.

Direct payments

No special configuration is required for direct payments.

Payment links can directly be created once the integration is activated.

Invoices

To allow direct payments of invoices, enable the option 'Allow direct payment via link' on your profile under 'Invoices'.
Retrieve activated payment methods directly using 'Fetch supported payment methods' and disable methods you don't want to offer for invoices if needed.

Recurring payments

Direct Debits

Direct debit transactions can be sent to Mollie. This is in general faster than a traditional bank.
Verify that your Mollie-account can accept Direct Debits beforehand.

Once everything is set up on your Mollie-account, contact Twikey-support to enable Mollie as your bank.

Credit cards

For recurring credit card transaction you need a profile of this type. Contact our support to create a credit card-profile.
To send batches of credit card transaction to Mollie, no other configuration is required in Twikey.

Verify that your Mollie-account is credit card enabled.

Other actions

Next to the general use, following actions are supported in Twikey when using Mollie as payment provider:

  • Partial and full refunds of payment links via our API or using the Interface
  • Customized payment message and reference for invoices
  • Zero amount payments for credit cards
  • Partial and full refunds of recurring credit card transactions via our API and Interface
Last Update: 2024-10-16