1. Introduction

This guide is to inform you about our Direct Debit payment methods, and how they need to be configured and integrated, with special attention to the SEPA (Single Euro Payments Area) rules and regulations.

Depending on the processing modes you use, you may have to check the following integration documentation for more technical info:

2. Direct Debits DE (Nexi Payengine)

2.1 Introduction

Nexi Payengine will implement the SEPA changes on the ELV integration, to align with Nexi Payengine.

Note: From now on only IBAN is accepted. You are no longer allowed to send Kontonummer with BLZ.

2.2 Configuration

You need to insert your CREDITORID in the "Direct Debits DE" configuration page.

By default the configuration is now switched to SEPA mode.

A flag will be implemented to configure whether or not to show a mandate text on the payment page (in e-commerce mode):

  • Flag switched on: Mandate text will be shown on the payment page
  • Flag switched off: Mandate text is not shown

To be able to switch on the flag; you need to enter the CREDITORID.

You must obtain the German CREDITORID from the Bundesbank.

A CREDITORID is structured in the same way all over the SEPA zone:

  • The first two characters represent the ISO country code for Germany (DE) as the country issuing the Creditor Identifier.
  • The third and fourth characters are the check digits which are calculated in compliance with the IBAN check digits (ISO 13616), without taking characters five to seven (Creditor Business Code) into account.
  • The fifth, sixth and seventh characters in the sequence signify the Creditor Business Code for which the direct debit creditor may select alphanumeric characters to denote individual business areas or branches specific to his requirements. The use of blanks, special characters and umlauts is not permitted. As a rule, the three characters entered here are the letters “ZZZ”.
  • The remaining characters 8 to 18 signify the national identifier for the direct debit creditor and are numbered in consecutive ascending order. Until further notice, the eighth character in the Creditor Identifier will always be “0”.

The format of the German CREDITORID is as follows: 18 alphanumeric characters. A German CREDITORID should be provided for the processing of ELV transactions.

2.3 Integration with e-Commerce

The following fields can be sent along for Direct Debits DE (ELV) transactions. They will be displayed to the customer, in the Mandate text on the payment page.

Field Description
CN Cardholder name
Optional for SEPA (*) transactions (not applicable for Billpay):
MANDATEID Unique Mandate Reference
Max. 35 AN characters, charset: “A-Z a-z 0-9 space /-?:().,'+”)
SIGNDATE The date the mandate is signed
MANDATEID OOFF or RCUR (OOFF is the default one if not provided)

Note: These fields can be returned in the post-payment feedback (Dynamic e-commerce parameters) and need to be included in the SHA-IN (and optionally SHA-OUT) calculation.

Notes for SEPA (Single Euro Payments Area):

  • If you don't provide the CN, this field will remain empty on the payment page.
  • If you don't provide a MANDATEID, we will use the ORDERID. However, if the ORDERID is not compliant with the specifications of the MANDATEID, the PAYID will be used instead.
  • If SIGNDATE is not provided, the transaction date will be used.

The following fields will be presented to the buyer:

  • IBAN

Veelgestelde vragen

Hoelang het duurt om een betaalmethode te activeren, is afhankelijk van de volgende factoren:

  • Gewoonlijk heeft de acquirer of de bank ongeveer een week nodig om uw aanmelding te voltooien. Als u al bent aangemeld, duurt de activering slechts een paar dagen.
  • Voor sommige betaalmethoden zijn extra controles vereist voordat ze kunnen worden geactiveerd, bijv. in geval van 3-D Secure, dat rechtstreeks wordt aangevraagd bij VISA of MasterCard (en niet bij de acquirer).


Het komt soms voor dat een aansluitnummer door de acquirer is gedeactiveerd. We raden u aan hierover contact op te nemen met uw acquirer.