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.

Type

Payments by Direct Debit

interface: via form

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

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..64

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.

Key	Format	CND	Description	Beschreibung
RefNr

Key

Format

CND

Description

Beschreibung

Consumer Data

Kundendaten

EMail

ans..254

M

Email address of the customer

E-Mail-Adresse des Kunden

FirstName

ans..50

M

First name

Vorname

LastName

ans..50

M

Last name

Nachname

bdStreet

ans..50

M

Street

Straße

bdStreetNr

ans..50

M

Street number

Hausnummer

bdZip

ans..50

M

Postcode

Postleitzahl

bdCity

ans..50

M

Town

Ort

bdCountryCode

an2

M

Country-Code, ISO-3166

Ländercode gemäß ISO-3166

phone

ans..50

M

Mobile phone of the customer; an OTP value is sent to this mobile number in case agreementScheme=SMS is used

Mobiltelefon des Kunden; an diese Mobiltelefonnummer wird ein OTP-Wert gesendet, falls agreementScheme=SMS verwendet wird

bdGender

a1

M

M=Male
F=Female

M=männlich
F=weiblich

Mandate Data

Mandatsdaten

creditorid

ans..50

M

SEPA Creditor Identifier (SCI)

contractId

ans..50

O

Underlying contract identifier

Kennung des zugrundeliegenden Vertrags

contractDescription

ans..50

O

Underlying contract description

Beschreibung des zugrundeliegenden Vertrags

agreementScheme

enum

O

Value
SMS (default)
EMAIL

Wert
SMS (Standardwert)
EMAIL

DocumentSignature

enum

O

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.
false	No 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.
false	Es wird kein Stempel hinzugefügt

GoogleAnalyticsConsent

enum

O

Debtor consent to use google analytics

Value
true (default)
false

Zustimmung des Schuldners zur Nutzung von Google Analytics

Wert
true (Standardwert)
false

SignatureBySca

enum

O

Value
true (default)
false

Wert
true (Standardwert)
false

Sps

enum

O

Allows to identify that WS call comes from SPS

Value
true (default)	WS call comes from SPS
false	WS 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
false	WS-Aufruf kommt nicht von SPS

Validation

enum

O

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

Value
true (default)
false

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

Wert
true (Standardwert)
false

customerType

enum

O

Type of customer

Value
KNOWN	Known customer
PROSPECT	Unknown customer

Art des Kunden

Wert
KNOWN	Bekannter Kunde
PROSPECT	Unbekannter Kunde

General parameters to create new SEPA Mandates approved with OTP

MerchantID=MerchantID
TransID=TID-1679346326918-086560626017
RefNr=iwxfd0gotxf0
CustomerId=customerId123126
EMail=email@email.com
bdeMail=email@email.com
Amount=123
Currency=EUR
URLSuccess=https://www.domain.com/ct-test-1/success.php
URLFailure=https://www.domain.com/ct-test-1/failure.php
URLNotify=https://www.domain.com/ct-test-1/notify.php
OrderDesc=OrderDesc OrderDesc
FirstName=Max
bdFirstName=Mustermann
LastName=Mustermann
bdLastName=Mustermann
creditorId=AXEPTA Merchant1
contractDescription=ContractDescription
contractId=ContractId123123
bdStreet=Streetname
bdStreetNr=1a
bdZip=10010
bdCity=Berlin
bdCountryCode=DE
phone=+491231234567
bdPhone=+491231234567
bdGender=M
agreementScheme=SMS
DocumentSignature=false
GoogleAnalyticsConsent=false
SignatureBySca=true
Sps=false
Validation=true
customerType=KNOWN
Language=en
MAC=<MAC>

Key	Format		CND	Description	Beschreibung
refnr
MandateId				Currently missing	Fehlt derzeit

General results parameters for URLNotify, URLSuccess and URLFailure

mid=MerchantId
PayID=06510075c0d644c98109db1ae4c55b38
TransID=TID-1679333858022-054078670102
Status=OK
XID=2c6e5f87191148318e694e04cf92a6ba
Code=00000000
Description=success
refnr=iwxfd0gotxf0
MAC=17411E518F197AF15157B31C1CF097C033D94DD762845C56930380ADE8ECA449