Skip to main content

​
Overview

Mollie is a European payment service provider supporting multiple payment methods including iDEAL, SEPA, credit cards, and digital wallets. TelemanAI integrates with Mollie for EUR transactions.

​
Prerequisites

  • Mollie business account
  • Verified European business
  • API key (Live or Test)

​
Configuration

​
Environment Variables

# Mollie Configuration
MOLLIE_KEY=test_your_api_key
MOLLIE_CURRENCY=EUR
MOLLIE=YES
​
MOLLIE_KEY
string
required
Your Mollie API key (starts with test_ or live_)
​
MOLLIE_CURRENCY
string
Currency code (EUR recommended for Europe)
​
MOLLIE
string
Set to YES to enable, NO to disable

​
Supported Payment Methods

Mollie supports all major European payment methods:

​
Bank Payments

  • iDEAL - Netherlands
  • SEPA Direct Debit - Europe-wide
  • Bancontact - Belgium
  • Giropay - Germany
  • EPS - Austria
  • Przelewy24 - Poland

​
Card Payments

  • Visa
  • Mastercard
  • American Express
  • Maestro

​
Digital Wallets

  • PayPal
  • Apple Pay
  • Google Pay

​
Other Methods

  • Klarna - Buy now, pay later
  • in3 - Pay in 3 installments
  • Vouchers - Gift cards

​
Setup Steps

1

Create Mollie Account

Register at mollie.com and complete business verification.
2

Get API Key

Navigate to Developers → API Keys in your Mollie dashboard.
Start with a test key: test_xxxxxxxxxxxxxxx
3

Configure Environment

Add your API key to .env:
MOLLIE_KEY=test_your_key
MOLLIE=YES
4

Set Up Webhooks

Add webhook URL in Mollie dashboard:
https://your-domain.com/mollie/webhook
Webhook URL must be publicly accessible and use HTTPS.
5

Enable Payment Methods

In your Mollie dashboard, activate desired payment methods under Settings → Website Profiles → Payment Methods.
6

Test Integration

Clear cache and test a payment:
php artisan config:clear
php artisan cache:clear

​
Supported Currencies

Mollie supports 40+ currencies, including:
  • EUR - Euro (recommended for Europe)
  • USD - US Dollar
  • GBP - British Pound
  • CHF - Swiss Franc
  • DKK - Danish Krone
  • SEK - Swedish Krona
  • NOK - Norwegian Krone
  • PLN - Polish Złoty

​
Testing

​
Test Mode

Use test API key during development: 
MOLLIE_KEY=test_dHar4XY7LxsDOtmnkVtjNVWXLSlXsM

​
Test Payments

In test mode, all payment methods are available without real transactions:
  • iDEAL: All banks available, payments auto-succeed
  • Credit Card: Use any valid card format
  • PayPal: Test sandbox account
Mollie provides detailed test documentation at docs.mollie.com/overview/testing

​
Payment Flow

  1. User selects subscription package
  2. Chooses Mollie as payment method
  3. Selects preferred payment method (iDEAL, card, etc.)
  4. Redirected to payment provider
  5. Completes payment
  6. Redirected back to TelemanAI
  7. Webhook confirms payment status
  8. Subscription activated

​
Webhook Configuration

Mollie sends real-time payment status updates via webhooks.

​
Webhook URL

https://your-domain.com/mollie/webhook

​
Payment Statuses

StatusDescription
openPayment created, awaiting completion
pendingPayment started, not yet confirmed
authorizedPayment authorized (cards)
paidPayment successful
failedPayment failed
canceledPayment canceled by user
expiredPayment expired

​
Troubleshooting

  • Verify API key is correct
  • Check if using test key for test mode
  • Ensure no extra spaces in .env
  • Regenerate API key if necessary
  • Enable payment method in Mollie dashboard
  • Check if method is supported in your country
  • Verify business verification status
  • Some methods require additional approval
  • Verify webhook URL is publicly accessible
  • Check webhook URL uses HTTPS
  • Test webhook using Mollie dashboard
  • Review webhook logs in Mollie
  • Check if currency is enabled in your profile
  • EUR is recommended for European customers
  • Some payment methods only support EUR

​
Security Best Practices

Protect your API keys. Never commit them to version control.
  • Store API keys in .env only
  • Use test keys for development
  • Enable HTTPS for production
  • Validate webhook signatures
  • Monitor transactions for fraud
  • Set up balance alerts

​
Transaction Fees

Mollie charges per transaction:
  • European cards: 0.29 EUR + 2.8%
  • Non-European cards: 0.29 EUR + 2.8%
  • iDEAL: 0.29 EUR
  • PayPal: 0.10 EUR + 3.4%
  • Klarna: 0.45 EUR + 3.3%
Check current pricing at mollie.com/pricing.

​
Next Steps

Stripe

Alternative European payment gateway

Payment Overview

Compare all payment gateways

Subscription Packages

Configure pricing

PayPal

Another payment option

Build docs developers (and LLMs) love

Get started for freeTalk to us