About EasyCollect

General information about EasyCollect

EasyCollect is a system provided by Worldline to manage SEPA mandates for direct debits and also to handle direct debit payments themself.

SEPA Mandates can be approved with an One-Time-password (OTP) which can be provideed to the consumer either via SMS/text message or via email.

Transaction procedure of a direct debit payment on the Internet

In order to pay with a direct debit, the customer first needs to approve a SEPA mandate. Therefore the customer needs to be in session and approve the mandate creation via OTP.

Using this SEPA mandate the merchant can create later SEPA direct debit payments.


Logo

Info

The enables you to handle the direct debit mandates and payments popular with customers – and is fully compatible with SEPA.

TypePayments by Direct Debit




Chart of process flow: Mandate approval via form interface / Direct Debit via Server-2-Server connection

Process flow of Mandate approval via form interface / Direct Debit via Server-2-Server connection


interface


Mandate creation with customer approval via OTP

The interface of the form to approve a SEPA mandate is MandateForm.aspx.

MandateForm.aspx

This section explains the parameters for Mandate Approval.


Key

Format

CND

Description

Beschreibung

TransID

ans..35

M

TransactionID which should be unique for each payment.

When using auto-mandate (filling-in of MandateID with TransID or RefNr) the permitted character set is that of the MandateID parameter.

Transaktions-ID, die für jede Zahlung eindeutig sein sollte.

Bei Verwendung des Automandats (Befüllung der MandateID mit TransID oder RefNr) ist der zulässige Zeichensatz der des Parameters MandateID.

Account

ans..12

O

Within several EasyCollect accounts can be stored on one MerchantID and controlled by the parameter Account. Each account relates to a specific creditor configuration. By default, first entry will be used. The setup must be agreed with .

Im können mehrere EasyCollect-Konten unter einer MerchantID gespeichert und über den Parameter „Account“ gesteuert werden. Jedes Konto bezieht sich auf eine bestimmte Gläubigerkonfiguration. Standardmäßig wird der erste Eintrag verwendet. Die Einrichtung muss mit dem abgestimmt werden.

Key

Format

CND

Description

Beschreibung




Consumer DataKundendaten
EMailans..254MEmail address of the customerE-Mail-Adresse des Kunden
FirstNameans..50MFirst nameVorname
LastNameans..50MLast nameNachname
bdStreetans..50MStreetStraße
bdStreetNrans..50MStreet numberHausnummer
bdZipans..50MPostcodePostleitzahl
bdCityans..50MTownOrt
bdCountryCodean2MCountry-Code, ISO-3166Ländercode gemäß ISO-3166
phoneans..50MMobile phone of the customer; an OTP value is sent to this mobile number in case agreementScheme=SMS is usedMobiltelefon des Kunden; an diese Mobiltelefonnummer wird ein OTP-Wert gesendet, falls agreementScheme=SMS verwendet wird
bdGendera1M
  • M=Male
  • F=Female
  • M=männlich
  • F=weiblich



Mandate DataMandatsdaten
creditoridans..50M

SEPA Creditor Identifier (SCI)

SEPA Creditor Identifier (SCI)
contractIdans..50O

Underlying contract identifier

Kennung des zugrundeliegenden Vertrags
contractDescriptionans..50OUnderlying contract descriptionBeschreibung des zugrundeliegenden Vertrags
agreementSchemeenumO

The way how the OneTimePassword (OTP) will be forwarded to the customer.

Value
SMS (default)Given phone number (phone)
EMAILGiven email address (EMail)

Der Weg, wie das Einmal-Passwort (OTP) zum Kunden weitergeleitet wird.

Wert
SMS (Standardwert)Angegebene Telefonnummer (phone)
EMAILAngegebene E-Mail-Adresse (EMail)
DocumentSignatureenumO

The stamp is added on the last page of the mandate document.

Value
true (default)The last page of the document will contain the stamp in the middle of the last page.
falseNo stamp is added

Der Stempel wird auf der letzten Seite des Mandatsdokuments angebracht.

Wert
true (Standardwert)Auf der letzten Seite des Dokuments befindet sich in der Mitte der Stempel.
falseEs wird kein Stempel hinzugefügt
GoogleAnalyticsConsentenumO

Debtor consent to use google analytics

Value
true (default)
false

Zustimmung des Schuldners zur Nutzung von Google Analytics

Wert
true (Standardwert)
false
SignatureByScaenumO

If "true" customer will be authenticated by AccountIdentificationService.

Value
true (default)
false

Wenn „true“, wird der Kunde durch AccountIdentificationService authentifiziert.

Wert
true (Standardwert)
false
SpsenumO

Allows to identify that WS call comes from SPS

Value
true (default)WS call comes from SPS
falseWS call does not come from SPS

Ermöglicht die Identifizierung, dass der WS-Aufruf von SPS kommt

Wert
true (Standardwert)WS-Aufruf kommt von SPS
falseWS-Aufruf kommt nicht von SPS
ValidationenumO

If Validation = TRUE --> ORG / If Validation = FALSE --> OTU

Value
true (default)
false

If Validation = TRUE --> ORG / If Validation = FALSE --> OTU

Wert
true (Standardwert)
false
customerTypeenumO

Type of customer

Value
KNOWNKnown customer
PROSPECTUnknown customer

Art des Kunden

Wert
KNOWNBekannter Kunde
PROSPECTUnbekannter Kunde
MandateIDans..35O

Predefined mandate id. The mandate itself will use this mandate id.

Pattern: ^[a-zA-Z\+\?\(\)\-\s:/.,_'0-9] {1,35}$

Vordefinierte Mandats-ID. Das Mandat selbst verwendet diese Mandats-ID.

Muster: ^[a-zA-Z\+\?\(\)\-\s:/.,_'0-9] {1,35}$

MdtSeqTypeenumO

Indicates whether the mandate is a one-off mandate or a mandate for recurring direct debits.

There is no default. The default value depends on merchant configuration.

Value
OOFFone-off mandate
RCURrecurring mandate

Gibt an, ob es sich um ein einmaliges Mandat oder ein Mandat für wiederkehrende Lastschriften handelt.

Es gibt keinen Standardwert. Der Standardwert hängt von der Händlerkonfiguration ab.

Wert
OOFFeinmaliges Mandat
RCURwiederkehrendes Mandat
MdtTypeenumO

Indicates whether the mandate is a business-to-business mandate or a customer-to-business mandate.

There is no default. The default value depends on merchant configuration.

Value
B2BBusiness-to-business mandate
COREBase mandate (customer-to-business)

Gibt an, ob es sich um ein Business-to-Business-Mandat oder ein Customer-to-Business-Mandat handelt.

Es gibt keinen Standardwert. Der Standardwert hängt von der Händlerkonfiguration ab.

Wert
B2BBusiness-to-Business-Mandat
COREBasismandat (Customer-to-Business)
EventTokenenumO

Creates a new mandate and first direct debit transaction simultaneously.

Value
PaymentCreates mandate and payment simultaneously.

Erzeugt gleichzeitig ein neues Mandat und die erste Lastschrifttransaktion.

Wert
PaymentErzeugt Mandat und Zahlung gleichzeitig.
DueDateans10C

DueDate of this transaction. Mandatory if EventToken=Payment.

Pattern: YYYY-MM-DD

Fälligkeitsdatum dieser Transaktion. Pflicht, wenn EventToken=Payment.

Muster: JJJJ-MM-TT

General parameters to create new SEPA Mandates approved with OTP


Key

Format

CND

Description

Beschreibung

MandateIdans..35O

Predefined mandate id. The mandate itself will use this mandate id.

Pattern: ^[a-zA-Z\+\?\(\)\-\s:/.,_'0-9] {1,35}$

Vordefinierte Mandats-ID. Das Mandat selbst verwendet diese Mandats-ID.

Muster: ^[a-zA-Z\+\?\(\)\-\s:/.,_'0-9] {1,35}$

General results parameters for URLNotify, URLSuccess and URLFailure