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.

Page properties

Logo

Info

Excerpt

The

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Platform-Kurz
PageWithExcerpt	Wording

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

Type

Payments by Direct Debit

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Link_CookieSessionHandling
DisableCaching	true
PageWithExcerpt	Reuse API

Table of Contents

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

Multiexcerpt

MultiExcerptName	ProcessFlow_Form

draw.io Diagram

border	true
diagramName	EasyCollect-CT
simpleViewer	false
links	auto
tbstyle	top
lbox	true
diagramWidth	1203

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

Multiexcerpt include
SpaceWithExcerpt EN
MultiExcerptName Platform-Kurz
PageWithExcerpt Wording
interface

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Definition
PageWithExcerpt	Definition EN

Mandate creation with customer approval via OTP

The interface of the

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Platform-Kurz
PageWithExcerpt	Wording

form to approve a SEPA mandate is MandateForm.aspx.

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	BaseURL
PageWithExcerpt	Wording

MandateForm.aspx

This section explains the parameters for Mandate Approval.

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Request_Intro
PageWithExcerpt	Reuse API

Table Filter

default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
sparkName	Sparkline
hidePane	true
datepattern	dd M yy
id	1618512856592_1542840231
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt

MultiExcerptName	mandate_request

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

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1618587502543_-1280868138
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
separator	.
export-pdf	false
sql	SELECT * FROM T*

Table Excerpt Include

static	true
name	MerchantID
page	MerchantID
type	page

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

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Platform-Kurz
PageWithExcerpt	Wording

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

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	Wording

.

Im

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Platform-Kurz
PageWithExcerpt	DE:Wording

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	DE:Wording

abgestimmt werden.

Table Excerpt Include

static	true
name	Amount
page	Amount
type	page

Table Excerpt Include

static	true
name	Currency
page	Currency
type	page

Table Excerpt Include

static	true
name	MAC
page	MAC
type	page

Table Excerpt Include

static	true
name	ReqId-ans..32
page	ReqId
type	page

Table Excerpt Include

static	true
name	URLSuccess
page	URLSuccess
type	page

Table Excerpt Include

static	true
name	URLFailure
page	URLFailure
type	page

Table Excerpt Include

static	true
name	Response
page	Response
type	page

Table Excerpt Include

static	true
name	URLNotify
page	URLNotify
type	page-descendants

Key	Format	CND	Description

Beschreibung


			Consumer Data

Kundendaten


EMail	ans..254

M

O	Email address of the customer

E-Mail-Adresse des Kunden

FirstName

ans..50

M

O	First name

Vorname


LastName	ans..50

M

O

Last name

Nachname


companyName	ans..50	O	Name of the company
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

a..3

M

Country code 2 or 3 characters according to

ISO 3166Ländercode zwei- oder dreistellig gemäß

ISO 3166
phone	ans..50

M

O	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

O	M=Male F=Female

M=männlich
F=weiblich

			Mandate Data

Mandatsdaten


contractId	ans..50	O	Underlying contract identifier

Kennung des zugrundeliegenden Vertrags

contractDescription

ans..50

O

Underlying contract description

Beschreibung des zugrundeliegenden Vertrags


businessIdentifier	ans..50	O	Unique SIREN Id of the merchant

Eindeutige SIREN-ID des HändlersWertSMS (Standardwert)Angegebene Telefonnummer (phone)EMAILAngegebene E-Mail-Adresse (EMail)

agreementScheme

enum

O

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

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

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

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

Werttrue (Standardwert

)
false

SignatureBySca

enum

O

If "true" customer will be authenticated by AccountIdentificationService.

Value
true
false (default

)

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

Werttruefalse (Standardwert

)

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

Werttrue (Standardwert)WS-Aufruf kommt von SPSfalseWS-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

Werttrue (Standardwert

)
false

customerType

enum

O

Type of customer

Value
KNOWN	Known customer
PROSPECT	Unknown customer

Art des Kunden

WertKNOWNBekannter KundePROSPECT

Unbekannter Kunde

MandateID

ans..35

O

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}$

MdtSeqType

enum

O

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
OOFF	one-off mandate
RCUR	recurring 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.

WertOOFFeinmaliges MandatRCUR

wiederkehrendes MandatWertB2BBusiness-to-Business-MandatCOREBasismandat (Customer-to-Business)

MdtType

enum

O

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
B2B	Business-to-business mandate
CORE	Base 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.

EventToken

enum

O

Creates a new mandate and first direct debit transaction simultaneously.

Value
Mandate	Creates only a mandate, no payment
Payment	Creates mandate and payment simultaneously

Erzeugt gleichzeitig ein neues Mandat und die erste Lastschrifttransaktion.

WertMandate

Erzeugt nur ein Mandat, keine Zahlung

Payment

Erzeugt Mandat und Zahlung gleichzeitig

DueDate

ans10

O

DueDate of this transaction. If missing the current day will be used.

Pattern: YYYY-MM-DD

Fälligkeitsdatum dieser Transaktion. Fehlt diese Angabe, wird der aktuelle Tag verwendet..

Muster: JJJJ-MM-TT

CustomerId

an1..64

O

Customer identifier submitted by the merchant during a payment

Vom Händler bei einer Zahlung übermittelte Kundenkennung

RemittanceInfo

ans..50

O

The RemittanceInfo parameter is required for reconciliation purposes, providing essential customer-visible information on customer bank statements for better tracking and reporting.

Allowed characters: A..Za..z0..9 / - ? : ( ) . , +
Diactrics like äöüÄÖÜ, áéíóú, àèìòù, âêîôû, ... are not allowed

Der Parameter „RemittanceInfo“ wird für Abstimmungszwecke benötigt und stellt wichtige, für den Kunden sichtbare Informationen auf Kundenkontoauszügen bereit, um eine bessere Nachverfolgung und Berichterstattung zu ermöglichen.

Erlaubte Zeichen: A..Za..z0..9 / - ? : ( ) . , +
Umlaute wie äöüÄÖÜ, áéíóú, àèìòù, âêîôû, ... sind nicht zulässig

signerPositionOccupied

ans..70

O

Title of the signatory's position in the company

Titel der Position des Unterzeichners im Unternehmen


template	ans..20	O	Name of a XSLT template to get an individual layout for your EasyCollect form which matches with your shop layout. Details are available here: Corporate PayPage and templates

.Name einer XSLT-Vorlage für ein individuelles Layout Ihres EasyCollect-Formulars, das zu Ihrem Shop-Layout passt. Details finden Sie hier: Corporate Paypage und Templates

.

Table Excerpt Include

static	true
name	UserData
page	UserData
type	page

Table Excerpt Include

static	true
name	Plain
page	Plain
type	page

Table Excerpt Include

static	true
name	Custom
page	Custom
type	page

General parameters to create new SEPA Mandates approved with OTP

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Response_IntroURL
PageWithExcerpt	Reuse API

Table Filter

default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
sparkName	Sparkline
hidePane	true
datepattern	dd M yy
id	1618519475469_-143512491
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt

MultiExcerptName	MandateForm_response

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1618587590573_1458199043
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
separator	.
export-pdf	false
sql	SELECT * FROM T*

Table Excerpt Include

static	true
name	MID
page	mid
type	page

Table Excerpt Include

static	true
name	PayID
page	PayID
type	page

Table Excerpt Include

static	true
name	XID
page	XID
type	page

Table Excerpt Include

static	true
name	TransID
page	TransID
type	page

Table Excerpt Include

static	true
name	Status_OK_FAILED
page	Status
type	page

Table Excerpt Include

static	true
name	Description
page	Description
type	page-children

Table Excerpt Include

static	true
name	Code
page	Code
type	page

Key	Format		CND	Description

Beschreibung

MandateID

ans..35

O

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}$

Table Excerpt Include

static	true
name	MAC
page	MAC
type	page

Table Excerpt Include

static	true
name	UserData
page	UserData
type	page

Table Excerpt Include

static	true
name	Plain
page	Plain
type	page

Table Excerpt Include

static	true
name	Custom
page	Custom
type	page

General result parameters for URLNotify, URLSuccess and URLFailure

Space shortcuts

Page tree

Versions Compared

Old Version 366

New Version Current

Key

About EasyCollect

General information about EasyCollect

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

Multiexcerpt include
SpaceWithExcerpt EN
MultiExcerptName Platform-Kurz
PageWithExcerpt Wording
interface

Mandate creation with customer approval via OTP

Paygate

Computop

Help

Intranet Tools

Space shortcuts

Page tree

Page History

Versions Compared

Old Version 366

New Version Current

Key

About EasyCollect

General information about EasyCollect

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

Multiexcerpt includeSpaceWithExcerptENMultiExcerptNamePlatform-KurzPageWithExcerptWording interface

Mandate creation with customer approval via OTP

Multiexcerpt include
SpaceWithExcerpt EN
MultiExcerptName Platform-Kurz
PageWithExcerpt Wording
interface