Mollie Connect: Overview

Mollie Connect allows you to create apps for Mollie merchants via OAuth.

Why should I use OAuth?

Mollie Connect is built on the OAuth standard. The OAuth connection enables you to access other merchants’ accounts with their consent, without having to exchange API keys. Whether you are just looking to improve your customers’ experiences, to automate essential business processes, or to whitelabel our platform completely, it is all possible with OAuth.

Our OAuth platform allows you to:

  • Create payments and refunds on behalf of merchants
  • Manage merchants’ website profiles
  • View a merchants’ transaction and settlement data
  • Show the next settlement and balance at Mollie in your app
  • Integrate merchants’ invoices from Mollie in your app
  • Charge merchants for payments, orders and subscriptions initiated through your app (application fees)

What does the Mollie OAuth flow look like?

After you’ve registered your OAuth app with Mollie, other Mollie merchants are able to install your app on their Mollie account. To do so, they have to follow the well known OAuth authorization flow as visualized below.

The authorization flow is explained in further detail in OAuth: Getting started.

What are the lifetime of the tokens?

Some tokens will expire after a certain time. You should ask for a new authorization or access token if needed.

Authorization code 30 seconds
Access token 1 hour
Refresh token Does not expire automatically
Organization access token Does not expire automatically

What merchant data can I access?

As with all OAuth platforms, you tell Mollie what data you need when requesting an authorization by listing the permissions your app requires. The merchant will explicitly have to agree with any permissions you request, so be sure to only request necessary permissions.

Please refer to OAuth: Permissions for a full list of available permissions.

How do merchants install my app?

By implementing the authorization flow, other Mollie merchants are able to install your app on their Mollie account. OAuth: Getting started discusses authorizations in further detail.

Can I get referral commission via OAuth as a partner of Mollie?

Yes, you can! When you’re a Mollie Partner, all merchants that will create an account in the OAuth-flow of your app will be linked to your partner-account what makes it possible to receive referral commission (kickback). You don’t have to do anything else than just integrate OAuth. For more information about the Mollie Partnership or to enable commission, please see our Partner page.

The Connect with Mollie button

To keep the user experience consistent, we recommend using one of the buttons below in your authorization flow.

Download files

The download includes a Sketch file and retina PNGs.