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

Multiexcerpt include
SpaceWithExcerpt EN
MultiExcerptName Platform-Kurz
PageWithExcerpt Wording
interface: via form

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

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.

This section explains the parametersfor 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

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*

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Request_AmountMac
DisableCaching	true
PageWithExcerpt	Reuse API

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.

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
RefNr

Key

Format

CND

Description

Beschreibung

Consumer Data

EMail

ans..254

M

Email address of the customer

FirstName

ans..50

M

First name

LastName

ans..50

M

Last name

bdStreet

ans..50

M

Street

bdStreetNr

ans..50

M

Street number

bdZip

ans..50

M

Postcode

bdCity

ans..50

M

Town

bdCountryCode

an..2

M

Country-Code, 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

bdGender

a1

M

M=Male
F=Female

Mandate Data

creditorid

ans..50

M

SEPA Creditor Identifier (SCI).

contractId

ans..50

O

Underlying contract identifier

contractDescription

ans..50

O

Underlying contract description

agreementScheme

enum

O

Value
SMS (default)
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

GoogleAnalyticsConsent

enum

O

Debtor consent to use google analytics

Value
true (default)
false

SignatureBySca

enum

O

Value
true (default)
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

Validation

enum

O

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

Value
true (default)
false

customerType

enum

O

Type of customer

Value
KNOWN	Known customer
PROSPECT	Unknown customer

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

Code Block

title	Sample (Request)
collapse	true

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>

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
refnr
MandateId				Currently missing

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 results parameters for URLNotify, URLSuccess and URLFailure

Code Block

title	Sample (Response Success)
collapse	true

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

Space shortcuts

Page tree

Versions Compared

Old Version 2

New Version 3

Key

About EasyCollect

General information about EasyCollect

Multiexcerpt include
SpaceWithExcerpt EN
MultiExcerptName Platform-Kurz
PageWithExcerpt Wording
interface: via form

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

Mandate creation with customer approval via OTP

Paygate

Computop

Help

Intranet Tools

Space shortcuts

Page tree

Page History

Versions Compared

Old Version 2

New Version 3

Key

About EasyCollect

General information about EasyCollect

Multiexcerpt includeSpaceWithExcerptENMultiExcerptNamePlatform-KurzPageWithExcerptWording interface: via form

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

Mandate creation with customer approval via OTP

Multiexcerpt include
SpaceWithExcerpt EN
MultiExcerptName Platform-Kurz
PageWithExcerpt Wording
interface: via form