mollie-api-python

What it is and what it does

The Mollie API client is a Python wrapper around the Mollie payment service, a European payment processor that handles transactions without fixed monthly costs or complex registration. It abstracts the HTTP details of Mollie's REST API, allowing developers to create payments, retrieve payment status, process refunds, and handle webhooks for payment status changes. The client supports a wide range of payment methods popular in Europe and beyond—iDEAL, Bancontact, SEPA transfers and direct debit, PayPal, Klarna (pay later, pay now, slice it), credit cards, and many others—all through a single unified interface.

The package is built on requests and requests_oauthlib for HTTP communication and OAuth handling. It has been in active development since 2014, with the current major version (v4) released in April 2026. The library is classified as production-stable and is maintained by the Mollie organization. Typical workflows involve creating a payment object with amount and redirect URL, storing the payment ID, sending the customer to Mollie's checkout, and then verifying payment status via webhook callbacks or direct API queries.

Use it for:

• Accept iDEAL payments on a Dutch e-commerce site without building custom payment form logic.
• Integrate SEPA bank transfers and direct debit into a SaaS billing system for recurring charges.
• Offer Klarna pay-later options to customers in Nordic and Central European markets.
• Process refunds programmatically when orders are cancelled or returned.
• Verify payment status asynchronously via webhook callbacks to trigger order fulfillment.
• Support multi-currency transactions (EUR, USD, etc.) with automatic settlement conversion.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Python client library for the Mollie payment API, enabling integration of multiple payment methods (iDEAL, PayPal, credit card, SEPA, Klarna, and others) into web applications.

Yes. The package is actively maintained, has low install friction, carries a permissive BSD license, and has no known vulnerabilities. It is the official Mollie client and is well-suited for any Python web application that needs to accept payments via Mollie's service. Install it if you are building an e-commerce or subscription platform targeting European or international customers and want to support multiple payment methods through a single API.

Install

mollie-api-python on PyPI

pip install mollie-api-python

uv add mollie-api-python

poetry add mollie-api-python

Installing mollie-api-python

Before you install

Low install friction with a pure-Python wheel distribution. The package depends on requests, urllib3, and requests_oauthlib—all stable, widely-used libraries. Maintenance is active, with the last commit on 2026-08-03 and a release on 2026-04-28, indicating ongoing support.

License in practice

BSD license (permissive) allows use in commercial and private projects with minimal restrictions—you may use, modify, and distribute the code provided you include the license notice.

Quickstart

pip install mollie-api-python

from mollie.api.client import Client

mollie_client = Client()
mollie_client.set_api_key('test_YourApiKey')
payment = mollie_client.payments.create({
    'amount': {'currency': 'EUR', 'value': '10.00'},
    'description': 'My first API payment',
    'redirectUrl': 'https://example.org/order/12345/',
    'webhookUrl': 'https://example.org/mollie-webhook/'
})

Requires Python >= 3.10 and up-to-date OpenSSL or other SSL/TLS toolkit. A Mollie account and API key are required to use the client in test or live mode.

Verify before relying

• Whether the package supports async/await patterns for payment operations.
• Rate limiting or retry behavior for API calls under high load.
• Detailed error handling and exception types for common failure scenarios.

Package facts

Evidence: mollie_api_python-4.0.0-py3-none-any.whl

Keywords: mollie, payment, service, ideal, creditcard, mistercash, bancontact, sofort, sofortbanking, sepa, paypal, paysafecard, podiumcadeaukaart, banktransfer, direct debit, belfius, belfius direct net, kbc, cbc, refunds, payments, gateway, gift cards, intersolve, fashioncheque, podium cadeaukaart, yourgift, vvv giftcard, webshop giftcard, nationale entertainment card, klarna pay later, klarna pay now, klarna slice it, przelewy24

Tags

More Financial packages