SEPA debit orders

SEPA is a European standard for bank payments. You can install the SEPA add-on and charge your customer via Direct debit orders.

The add-on can be installed in two methods, via the CLI or the Web UI of your Splynx server.

1. SEPA Installation

To install the SEPA add-on via CLI, the following commands can be used:

apt-get update
apt-get install splynx-sepa

To install it via the Web UI:

Navigate to Config → Integrations → Addons:


Locate or search for the "splynx-sepa" add-on and click on the install icon in the Actions column, you will be presented with a window to confirm or cancel the installation, click on confirm to begin the installation process:


After the installation process has completed, you have to configure the add-on.

2. Configuration

Navigate to Config → Integrations → Modules list

Module list

Locate or search for the "splynx-sepa" add-on and click on the edit icon in the Actions column and fill in provided fields



Customer’s IBAN and Mandate ID can be set in the customer profile (see below)

add_iban.png add_iban1.png

3. Generate the XML file for the bank.

Navigate to Finance/Invoces/ and click on the Charge button charge.png


After clicking "Charge" you will see a download xml document link.

4. Mark invoices as paid


Check invoices


5. SEPA - process the return file from the bank with non-payers

Sometimes customers does not have funds on their bank accounts. In that case, the Bank sends you an XML file back with returns. It will contain data about customers which the Bank was not able to charge. You can import this file to Splynx as well, and then paid invoices of non-payers will become unpaid again, so you can charge them next month and include the fee for a failed charge.

The handler to choose is SEPA XML returns:


6. SEPA - process of the refund from the bank in case of overpaid

If customers have the overpayments, we can provide the money-back. In order to do this, create for particular customers the invoices with negative price value. The status for such invoices will be set to Paid (from account balance) automatically. After that in Finance → Invoices apply the charge with the following options:


and download the archive with generated XML file: charge4.png