Mollie Integration¶

STATUS: active OWNER: eric (primary), faye/sytske (project context) CATEGORY: integration ADDED: 2026-03-27

WHAT¶

Mollie payment platform integration via official Mollie MCP server. EU-based payment provider (Netherlands). Handles iDEAL, credit cards, Bancontact, SEPA Direct Debit, and 15+ other payment methods.

WHY MOLLIE (NOT STRIPE)¶

EU service provider policy: Mollie is Netherlands-based, GDPR-native. See: memory/eu-service-provider-policy.md

MCP SERVER¶

Package: mollie-api-typescript (npm) — MCP server is built into the SDK
Version: 1.3.1 (2026-03-23)
License: BSD-3
Official Mollie product: docs.mollie.com/docs/mollie-mcp-server

Tools Available¶

Create payment links
Check payment statuses
Create customer profiles
Set up recurring mandates
Manage subscriptions
Query settlements and invoices

Configuration¶

MCP config at: /ge-ops/master/mcp-configs/eric.json API key in Vault at: admin-ui/api-keys → mollie key

Auth¶

Mollie API key: test_xxx (test mode) or live_xxx (production). Generate at: mollie.com dashboard → Developers → API keys. Store in Vault as MOLLIE_API_KEY.

CRITICAL: Use test keys during development. Live keys process real payments.

RATE LIMITS¶

Not publicly documented. Returns Retry-After header when exceeded. Implement exponential backoff with retry.

PRICING¶

Per-transaction: - iDEAL: EUR 0.29/tx - Credit cards: 1.8% + EUR 0.25 - SEPA Direct Debit: EUR 0.25/tx - No monthly fees on standard plan

TOKEN TRACKING (INVOICING)¶

All Mollie MCP tool calls are logged to: {logs_dir}/{agent}/mcp-usage/{date}.jsonl Each call records: timestamp, tool, duration, success/error, external API calls. This data feeds into the billing pipeline for client invoicing.

CHANGELOG MONITORING¶

Joshua monitors mollie-api-typescript and @mollie/api-client for updates. See: ge_agent/execution/mcp_integration.py → MONITORED_PACKAGES

EU service policy: memory/eu-service-provider-policy.md
Billing pipeline: ge_agent/execution/billing_client.py
MCP framework: ge_agent/execution/mcp_integration.py