Skip to main content

Mollie API client for Python

Project description

Mollie API client for Python

Accepting iDEAL, Bancontact/Mister Cash, SOFORT Banking, Creditcard, SEPA Bank transfer, SEPA Direct debit, Bitcoin, PayPal, Belfius Direct Net, KBC/CBC, paysafecard, ING Home'Pay, Giftcards, Giropay and EPS online payments without fixed monthly costs or any punishing registration procedures. Just use the Mollie API to receive payments directly on your website or easily refund transactions to your customers.

PyPI version Build Status


To use the Mollie API client, the following things are required:

  • Get yourself a free Mollie account. No sign up costs.
  • Create a new Website profile to generate API keys and setup your webhook.
  • Now you're ready to use the Mollie API client in test mode.
  • Follow a few steps to enable payment methods in live mode, and let us handle the rest.
  • Python >= 2.7
  • Up-to-date OpenSSL (or other SSL/TLS toolkit)
  • Mollie API client for Python has a dependency on Requests.


Please note: If you are looking to install the v1 version of the Mollie API client, please refer to the v1-develop branch for installation instructions.

By far the easiest way to install the Mollie API client is to install it with pip. The command below will install the latest released version of the client.

$ pip install mollie-api-python

You may also git checkout or download all the files, and include the Mollie API client manually.

Create and activate a Python >= 2.7 virtual environment (inside a git checkout or downloaded archive).

$ cd mollie-api-python
$ python -m virtualenv env
$ source env/bin/activate

Install the requirements, then install Mollie itself.

$ pip install flask
$ pip install -e .

Run the examples.

export MOLLIE_API_KEY=test_YourApiKey
$ python examples/

How to receive payments

To successfully receive a payment, these steps should be implemented:

  1. Use the Mollie API client to create a payment with the requested amount, currency, description and optionally, a payment method. It is important to specify a unique redirect URL where the customer is supposed to return to after the payment is completed.

  2. Immediately after the payment is completed, our platform will send an asynchronous request to the configured webhook to allow the payment details to be retrieved, so you know when exactly to start processing the customer's order.

  3. The customer returns, and should be satisfied to see that the order was paid and is now being processed.

Find our full documentation online on

Getting started

Importing the Mollie API Client

from mollie.api.client import Client

Initializing the Mollie API client, and setting your API key

mollie_client = Client()

Creating a new payment.

payment = mollie_client.payments.create({
    'amount': {
        'currency': 'EUR',
        'value': '10.00' 
    'description': 'My first API payment',
    'redirectUrl': '',
    'webhookUrl': '',

After creation, the payment id is available in the property. You should store this id with your order.

After storing the payment id you can send the customer to the checkout using the payment.checkout_url.

For a payment create example, see Example 1 - New Payment.

In general, request body parameters for an API endpoint should be added to a dictionary and provided as the first argument (or data keyword argument). Query string parameters can be provided as keyword arguments.

Retrieving payments

We can use the to retrieve a payment and check if the payment isPaid.

payment = mollie_client.payments.get(

if payment.is_paid():
    print('Payment received.')

Or retrieve a collection of payments.

payments = mollie_client.payments.list()

For an extensive example of listing payments with the details and status, see Example 5 - Payments History.

Payment webhook

When the status of a payment changes the webhookUrl we specified in the creation of the payment will be called.
There we can use the id from our POST parameters to check te status and act upon that, see Example 2 - Webhook verification.


Since the 2.0 version of the API (supported by version 2.0.0 of the client) non-EUR payments for your customers is now supported. A full list of available currencies can be found in our documentation.

payment = mollie_client.payments.create({
    'amount': {
        'currency': 'USD', 
        'value': '10.00'
    'description': 'Order #12345',
    'redirectUrl': '',
    'webhookUrl': '',

After the customer completes the payment, the payment.settlement_amount will contain the amount + currency that will be settled on your account.

Fully integrated iDEAL payments

If you want to fully integrate iDEAL payments in your web site, some additional steps are required. First, you need to retrieve the list of issuers (banks) that support iDEAL and have your customer pick the issuer he/she wants to use for the payment.

Retrieve the iDEAL method and include the issuers

method = mollie_client.methods.get(mollie.api.objects.Method.IDEAL, include='issuers')

method.issuers will be a list of Issuer objects. Use the property id of this object in the API call, and the property name for displaying the issuer to your customer. For a more in-depth example, see Example 4 - iDEAL payment.

payment = mollie_client.payments.create({
    'amount': {
        'currency': 'EUR', 
        'value': '10.00'
    'description': 'My first API payment',
    'redirectUrl': '',
    'webhookUrl': '',
    'method': mollie.api.objects.Method.IDEAL,
    'issuer': selectedIssuerId,  # e.g. "ideal_INGBNL2A"

The payment.checkout_url is a URL that points directly to the online banking environment of the selected issuer.

Refunding payments

The API also supports refunding payments. Note that there is no confirmation and that all refunds are immediate and definitive. Refunds are only supported for iDEAL, credit card, Bancontact, SOFORT Banking, PayPal, Belfius Direct Net, KBC/CBC, ING Home'Pay and bank transfer payments. Other types of payments cannot be refunded through our API at the moment.

payment = mollie_client.payments.get(

# Refund € 2 of this payment
refund = mollie_client.refunds.on(payment).create({
    'amount': {
        'currency': 'EUR',
        'value': '2.00'

For a working example, see Example 11 - Refund payment.

API documentation

If you wish to learn more about our API, please visit the Mollie Developer Portal. API Documentation is available in English.

Want to help us make our API client even better?

Want to help us make our API client even better? We take pull requests, sure. But how would you like to contribute to a technology oriented organization? Mollie is hiring developers and system engineers. Check out our vacancies or get in touch.


BSD (Berkeley Software Distribution) License. Copyright (c) 2014-2018, Mollie B.V.


Contact: — +31 20 820 20 70

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
mollie-api-python-2.0.6.tar.gz (153.6 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page