Mollie Recurring Payments for Odoo 18

This module enables recurring payments with Mollie iDEAL for subscription products in Odoo. It provides seamless integration between Odoo's subscription management system and Mollie's secure payment platform.

Key Features

• Automatic subscription payment processing
• Mollie iDEAL integration for first-time and recurring payments
• Mandate creation and management for recurring payments
• Customer synchronization between Odoo and Mollie
• Configurable subscription intervals (Monthly, Bi-monthly)
• Real-time webhook notifications for payment status
• Complete payment history and tracking

Dependencies

• base
• contacts
• sale_management
• website_sale
• payment_mollie
• sale_subscription
• sale

Installation

1. Install the official Mollie payment module (payment_mollie)
2. Install this module (mollie_recurring_payments)
3. Configure your Mollie API keys in Odoo
4. Set up your subscription products

Configuration

Mollie Setup

1. Go to Accounting / Invoicing → Configuration → Payment Providers
2. Select or create the Mollie payment provider
3. Enter your Mollie API keys (test and/or live)
4. Enable SEPA Direct Debit in Mollie settings

Subscription Products

1. Create or open a product
2. Enable "Recurring Invoice"
3. Assign a subscription plan (Monthly, Bi-monthly, etc.)

Cron Jobs

This module automatically installs a daily scheduled action for processing recurring payments:

• Name: Mollie: Process Subscription Charges
• Interval: Daily
• Model: mollie.subscription.cron

Features in Detail

Customer Management

• Automatic creation of Mollie customers
• Synchronization of customer data between Odoo and Mollie
• Storage of Mollie customer IDs and mandates

Mandate Handling

• Automatic mandate creation after first payment
• Mandate status tracking
• Manual mandate synchronization option

Payment Processing

• First payment handled via iDEAL
• Subsequent payments processed automatically
• Payment status tracking and error handling
• Webhook integration for real-time updates

User Interface Enhancements

• Sale order view enhanced with mandate information
• Customer form displays Mollie mandate details
• Integrated payment status tracking

Usage

Creating a Subscription

1. Create a sale order with subscription products
2. Confirm the order
3. The customer completes the first payment via iDEAL
4. A mandate is automatically created and stored
5. Future payments are processed automatically

Managing Mandates

• View mandate status in the customer form
• Use the "Sync Mandate" button to refresh mandate data
• Track mandates directly from sale orders

Monitoring Payments

• View payment history on sale orders
• Check transaction status in the Mollie dashboard
• Monitor scheduled job logs for recurring payments

Technical Details

Models

• res.partner – Mollie customer and mandate fields
• sale.order – Subscription and payment tracking
• payment.transaction – Extended to support mandate creation
• mollie.subscription.cron – Recurring payment processor

Controllers

• Mollie webhook handler
• Return URL controller for payment flow
• Mandate creation and validation endpoints

Cron Jobs

• Daily subscription payment processor
• Interval-based payment execution
• Built-in error handling and logging

Error Handling

• Payment processing failures
• API communication issues
• Mandate validation errors
• Customer creation problems

Errors are visible in system logs, sale order chatter, and customer records.

Security

• Secure API key handling
• Protected webhook endpoints
• Proper authentication for sensitive operations
• Role-based access control

License

This module is licensed under the LGPL-3.

Version History

1.5 (Current)

• Enhanced error handling
• Improved mandate synchronization
• Fixed webhook processing
• Added payment status tracking

Future Improvements

• Multi-currency support
• Advanced retry logic for failed payments
• Enhanced reporting
• Additional subscription intervals

Support

For issues and feature requests, please create an issue in the project repository.