Mollie Payments API
★ Only Publicly Available OpenAPI DocumentPaymentsPayment Processingbearer10 EndpointsREST
For Agents
Process European payments including iDEAL, Bancontact, SOFORT, and credit cards, manage customers, and issue refunds through Mollie's payment platform.
Use for: Create an iDEAL payment for a Dutch customer, Issue a refund on a completed Mollie payment, List all payments from the last 30 days, Get the available payment methods for a checkout
Not supported: Does not handle accounting, tax filing, or payroll — use for European payment processing, refunds, and customer payment record management only.
Jentic publishes the only available OpenAPI specification for Mollie Payments API, keeping it validated and agent-ready. Mollie is a European payment service provider that supports iDEAL, credit cards, SOFORT, Bancontact, gift cards, SEPA Direct Debit, and many other regional methods popular across the Netherlands, Belgium, Germany, and France. The API exposes payment creation, listing, retrieval, cancellation, refunds, and customer management plus a methods endpoint for surfacing locally relevant payment options at checkout. It targets European e-commerce merchants who need iDEAL and Bancontact alongside cards in a single integration.
Install Jentic One Beta
Connect the Mollie Payments API to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Mollie Payments API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
Capabilities
What an agent can do with Mollie Payments API.
Create iDEAL, Bancontact, SOFORT, and credit card payments through a single endpoint
List or retrieve historical payments by ID for reconciliation
Cancel pending payments before the customer completes them
Issue full or partial refunds against completed payments
Manage customer records and list available payment methods for a checkout
Use Cases
Patterns agents use Mollie Payments API for, with concrete tasks.
★ European E-Commerce Checkout with iDEAL and Bancontact
Accept payments from Dutch and Belgian customers using their preferred local methods through a single Mollie integration. Calling POST /payments with method='ideal' or 'bancontact' returns a hosted checkout URL that handles the bank redirect flow, removing the need to integrate iDEAL or Bancontact directly. Suitable for European merchants where local methods convert significantly better than card-only checkouts.
Call POST /payments with amount, currency=EUR, method=ideal, and a redirectUrl, then poll GET /payments/{id} until status becomes paid.
Refund Processing for Customer Service
Issue full or partial refunds against completed Mollie payments using the refunds endpoint, then list refunds for audit and reconciliation. The refund flow handles bank-side return for iDEAL and Bancontact transactions automatically, which manual bank-transfer refunds do not. Useful for customer service teams operating at scale where refund speed directly affects support metrics.
Call POST /payments/{paymentId}/refunds with the refund amount to issue a partial refund, then GET /payments/{paymentId}/refunds to confirm it was recorded.
Dynamic Payment Method Selection at Checkout
Call GET /methods to retrieve the payment methods that are active and locally relevant for the customer, so the checkout shows iDEAL to Dutch shoppers and Bancontact to Belgian shoppers without hardcoding logic. The methods endpoint accepts amount and locale filters, so pricing-sensitive methods like SEPA Direct Debit only appear when eligible. Practical for international merchants serving multiple European markets.
Call GET /methods with the cart amount and customer locale to return the methods to render in the checkout UI.
Agent-Driven Payment Reconciliation
AI agents handling finance-ops queries call Mollie through Jentic to list payments, retrieve specific transaction details, and issue refunds without holding the bearer token in their context. Jentic's spec is the only structured definition for Mollie that the agent can use for schema-driven tool selection.
Search Jentic for 'list recent mollie payments', load GET /payments, and execute with a date filter to feed the reconciliation worksheet.
Key Endpoints
10 endpoints — jentic publishes the only available openapi specification for mollie payments api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
POST
/payments
Create a payment using iDEAL, Bancontact, card, or other methods
GET
/payments
List historical payments
GET
/payments/{id}
Retrieve a specific payment
DELETE
/payments/{id}
Cancel a pending payment
POST
/payments/{paymentId}/refunds
Issue a refund against a payment
GET
/payments/{paymentId}/refunds
List refunds on a payment
POST
/customers
Create a customer record
GET
/methods
List payment methods available for a checkout
POST
/payments
Create a payment using iDEAL, Bancontact, card, or other methods
GET
/payments
List historical payments
GET
/payments/{id}
Retrieve a specific payment
DELETE
/payments/{id}
Cancel a pending payment
POST
/payments/{paymentId}/refunds
Issue a refund against a payment
GET
/payments/{paymentId}/refunds
List refunds on a payment
POST
/customers
Create a customer record
GET
/methods
List payment methods available for a checkout
Why Jentic?
Three things that make agents converge on Jentic-routed access.
Credential isolation
Mollie API keys are stored encrypted in the Jentic vault. Agents receive scoped execution access — the bearer token is injected at request time and never exposed in agent context.
Intent-based discovery
Agents search by intent (e.g., 'create an ideal payment') and Jentic returns POST /payments with the schema for amount, method, and redirectUrl already mapped.
Time to first call
Direct integration: 2-4 days to wire up payment creation, webhook handling, and refunds. Through Jentic: under 1 hour — search, load, execute.
Related APIs
Alternatives and complements available in the Jentic catalogue.
Alternative
Stripe API
Global payment processing platform with broad card and wallet coverage
Choose Stripe for global card-first markets and richer subscription tooling; use Mollie when European local methods like iDEAL and Bancontact are critical.
FAQs
Specific to using Mollie Payments API through Jentic.
Why is there no official OpenAPI spec for Mollie Payments API?
Mollie does not publish an OpenAPI specification in a structured format suitable for agent tool calling. Jentic generates and maintains this spec so that AI agents and developers can call Mollie Payments API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.
What authentication does the Mollie Payments API use?
Mollie uses HTTP Bearer authentication with API keys prefixed test_ or live_ depending on the environment. Send the key as Authorization: Bearer <key>. Through Jentic, the API key is held encrypted in the credential vault and injected at request time so the secret never appears in agent context.
Can I accept iDEAL payments with the Mollie Payments API?
Yes. Call POST /payments with method='ideal', the amount in EUR, and a redirectUrl, and Mollie returns a checkout URL that handles the bank-selection and redirect flow. After the customer completes payment, GET /payments/{id} confirms the final status.
What are the rate limits for the Mollie Payments API?
Mollie applies per-account rate limits documented in their developer portal (https://docs.mollie.com). Practical throughput is sufficient for normal e-commerce traffic; bulk operations such as historical payment imports should use pagination on GET /payments rather than parallel requests.
How do I issue a refund through Jentic?
Run pip install jentic, search for 'issue a mollie refund', load POST /payments/{paymentId}/refunds, and execute with the original payment ID and the refund amount. Jentic returns the refund object so the agent can confirm the refund was created.
Does Mollie support recurring payments?
Mollie supports recurring payments via the customers and SEPA Direct Debit flow. Create a customer record, then create payments tied to that customer with the recurring sequenceType. The customer endpoint in this spec lets you manage the customer-side records that recurring payments depend on.
GET STARTED