GoCardless SEPA Direct Debit for Dolibarr: mandates, recurring payments and subs

Your GoCardless Direct Debits, right inside Dolibarr

You invoice in Dolibarr and collect with GoCardless? This module connects the two. The SEPA mandate, the payment, the invoice settlement, any failed payment, the refund and the payout to your bank account are all tracked in one place, with no double entry and no manual exports.

What you get

• Less manual entry: payments confirmed by GoCardless are recorded as payments on your Dolibarr invoices, with the bank entry when the Bank module is enabled.
• Failed payments handled cleanly: a failed or late-failed payment is automatically reversed in Dolibarr, and its history is kept.
• Customers recognise the debit: you choose the description sent to GoCardless, for example "Your Company - Invoice INV2611-0042".
• No duplicate debits: every payment creation is sent with an idempotency key (Idempotency-Key header).
• Clear cash visibility: collections dashboard, month-on-month comparison, six-month chart, customers to watch and CSV export of statistics.

Two ways to work

• Classic mode (direct API): create customers, bank accounts, mandates and payments from Dolibarr. Works with every GoCardless plan.
• Billing Request mode (payment link): email your customer a link, with a custom subject and message. They set up their mandate on the GoCardless hosted page or on your own branded page. Requires a GoCardless plan that includes Billing Requests (Advanced or Pro).

Features

Customers and mandates

• Customers and their bank accounts synchronised between Dolibarr and GoCardless, with per-customer exclusions and an option to leave email addresses out of the sync
• Create, activate and cancel SEPA mandates, with statuses updated in real time
• Public mandate signing page with IBAN validation (ISO 13616)
• Protect+: payer verification on Billing Requests, with a choice of level (GoCardless add-on)

Payments, instalments and subscriptions

• One-off collection of an invoice
• Instalment schedules (pay in several instalments) with a customisable PDF schedule
• GoCardless subscriptions: import, activate, deactivate, cancel, link to orders, proposals and template invoices, with payments recorded automatically
• Success+: intelligent retries of failed payments (GoCardless add-on)
• Configurable payment description with the variables {COMPANY}, {INVOICE_REF}, {INVOICE_REF_CLIENT}, {CUSTOMER}, {AMOUNT}, {DATE} and {SUBSCRIPTION}, with preview

Financial tracking

• Webhooks with signature verification, each event processed in a transaction and retried on error
• Refunds linked to credit notes
• Payouts synchronised and GoCardless fees recorded
• Tax rates, scheme identifiers and payment account transactions
• Dashboard and statistics per entity and per currency

Administration and security

• Connect with an API key or OAuth, with separate Sandbox and Live environments
• Secrets encrypted with Dolibarr's native functions
• Built-in connection diagnostics
• Imports and synchronisation run by Dolibarr's native scheduled jobs
• Multi-company (MultiCompany): credentials and data isolated per entity
• Automatic database structure check and repair after an update
• Full interface in English, French, German, Spanish, Italian and Portuguese; payer-facing texts in the payer's language

Who is it for?

• Businesses and service providers that bill the same customers regularly: maintenance, hosting, contracts, subscriptions
• Associations, clubs and training providers collecting membership fees or instalments
• Dolibarr integrators rolling out GoCardless for their clients

It is less useful if you only collect a handful of one-off payments a year.

Compatibility and requirements

• Dolibarr 20.0 to 22.0.4 (tested versions)
• PHP 7.4 or later, with the cURL extension
• MySQL or MariaDB (tested on MySQL 8.4 and MariaDB 10.3)
• A GoCardless account. GoCardless fees depend on your plan and are not included.
• A public HTTPS URL to receive webhooks
• GoCardless PHP SDK bundled, no Composer needed on the server

Installation in 5 steps

1. Home > Setup > Modules > Deploy/install external module, then upload the ZIP file.
2. Enable the GoCardless SEPA module.
3. In the module settings, connect your GoCardless account (API key or OAuth), starting in Sandbox.
4. Choose Classic or Billing Request mode.
5. Add the webhook URL shown by the module to your GoCardless dashboard, test, then switch to Live.

An installation guide and a Sandbox test procedure are included in the module (docs folder).

Support and updates

• Email support: dev@bcsirt.fr
• Documentation: docs.bcsirt.fr
• 2 years of access to updates and downloads
• Actively maintained: version 2.9.5 (November 2026), full history in ChangeLog.md
• Publisher: BCSIRT. Licence GPL v3 or later.

GoCardless is a trademark of GoCardless Ltd. This module is developed and supported by BCSIRT and is not published by GoCardless.