Mollie Payments API

Name: Mollie Payments API API
Brand: Mollie Payments API
Availability: InStock

★ 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.

Quickstart

Get started with Mollie Payments API in minutes using your preferred integration method.

# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
  "jentic": {
    "url": "https://api.jentic.com/mcp",
    "auth": "oauth"
  }
}

# Then ask your agent:
"create an ideal payment"

# → Jentic returns the GET /events tool with parameter schema, agent executes.

Capabilities

What an agent can do with Mollie Payments API 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

GET STARTED

Start building with Mollie Payments API API

Explore with Jentic

View OpenAPI Document

Jentic publishes the only available OpenAPI document for Mollie Payments API, keeping it validated and agent-ready.

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.

Use Cases

Patterns agents use Mollie Payments API 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

Why though 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.

Alternative

Adyen Checkout API

Enterprise European payment processor with strong local-method coverage and unified ledger

Choose Adyen for large-scale European merchants needing acquiring-bank optimisation; Mollie is simpler and developer-friendlier for SMB scale.

Alternative

Braintree API

PayPal-owned payments platform with PayPal, Venmo, and card support

Choose Braintree when PayPal and Venmo are core requirements; Mollie covers European bank-redirect methods that Braintree does not natively offer.

FAQs

Specific to using Mollie Payments API 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.