Capture / Credit / Reversal

Capture

Captures are possible via a Server-to-Server connection. To perform a capture via a Server-to-Server connection please use the following URL:

Multiexcerpt include

SpaceWithExcerpt	ENWORK
MultiExcerptName	BaseURL
PageWithExcerpt	Wording

capture.aspx

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	1622666866820_1158287800
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt

MultiExcerptName	capture_request

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1622666866824_-276815880
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

Table Excerpt Include

static	true
name	PayID
page	PayID
type	page

Key

Format

CND

Description

Beschreibung

TransID

ans..64

M

TransactionID which should be unique for each payment

Please note for some connections the different formats that are given within the specific parameters.

TransaktionsID, die für jede Zahlung eindeutig sein muss

Bitte beachten Sie bei einigen Anbindungen die abweichenden Formate, die bei den spezifischen Parametern angegeben sind.

RefNr

ns..30

C

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	RefNr_Ctsf_Text
PageWithExcerpt	Reuse API

(not with EVO Payments, for CardComplete in the format an..25, for Cofidis in the format n..15, for Omnipay in the format ns..15, for RBI in the format ns..20)

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	RefNr_Ctsf_Text
PageWithExcerpt	DE:Reuse API

(nicht bei EVO Payments, bei CardComplete im Format an..25, bei Cofidis im Format n..15, bei Omnipay im Format ns..15, bei RBI im Format ns..20)

Table Excerpt Include

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

Key	Format	CND	Description	Beschreibung
FinishAuth	a1	C	Only with ETM: Transmit value <Y> in order to stop the renewal of guaranteed authorisations and rest amounts after partial captures. Please use this parameter only if you are using the additional function ETM (Extended Transactions Managament). (not with Clearhaus)	Nur bei ETM: Übergeben Sie den Wert <Y>, um bei Teilbuchungen die Autorisierungserneuerung oder die Reservierung des Restbetrages zu stoppen. Bitte nutzen Sie den Parameter nur, wenn Sie die Zusatzfunktion ETM (Erweitertes Transaktions-Managament) nutzen. (Nicht bei Clearhaus)
Textfeld1	ans..30	O	Card holder information: Name (not with Clearhaus)	Karteninhaber-Information: Name (Nicht bei Clearhaus)
Textfeld2	ans..30	O	Card holder information: City (not with Clearhaus)	Karteninhaber-Information: Ort (Nicht bei Clearhaus)
CHDesc	ans..22	OC	Only with Clearhaus: Text printed on the customer’s credit card bill. Only printable ASCII characters from 0x20 to 0x7E	Nur bei Clearhaus: Text, der auf der Kreditkartenabrechnung angezeigt wird. Nur ASCII druckbare Zeichen von 0x20 bis 0x7E

Parameters for captures of credit card payments

Multiexcerpt include

SpaceWithExcerpt	ENWORK
MultiExcerptName	Response_Intro
PageWithExcerpt	Reuse API

Table Filter

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

Multiexcerpt

MultiExcerptName	capture_response

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1622667720233_-1523965424
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	Response_MidPayIdXidCode
DisableCaching	true
PageWithExcerpt	Reuse API

Key

Format

CND

Description

Beschreibung

TransID

ans..64

M

Merchant’s transaction number.

Please note for some connections the different formats that are given within the specific parameters.

Transaktionsnummer des Händlers.

Bitte beachten Sie bei einigen Anbindungen die abweichenden Formate, die bei den spezifischen Parametern angegeben sind.

Status

a..50

M

OK or FAILED

OK oder FAILED

RefNr

ns..30

C

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	RefNr_Ctsf_Text
PageWithExcerpt	Reuse API

(not with EVO Payments, for Card Complete in the format an..25, for Omnipay in the format ns..15, for RBI in the format ns..20)

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	RefNr_Ctsf_Text
PageWithExcerpt	DE:Reuse API

(nicht bei EVO Payments, bei Card Complete im Format an..25, bei Omnipay im Format ns..15, bei RBI im Format ns..20)

AID

n6

OC

Only in the case of Card Complete: Authorisation ID returned by Card Complete

Nur bei Card Complete: von Card Complete zurückgegebene Autorisierungs-ID

Amount

n..10

OC

Only with Clearhaus: Amount in the smallest currency unit (e.g. EUR Cent)

If the actual amount differs from the requested amount this will be returned.

Only with MasaPay: The amount has to be equal to the originally authorised amount.

Nur bei Clearhaus: Betrag in der kleinsten Währungseinheit (z.B. EUR Cent)

Sollte der tatsächliche Betrag vom angefragten Betrag abweichen, wird dieser zurückgegeben.

Nur bei MasaPay: Betrag muss gleich dem ursprünglich autorisierten Betrag sein.

CodeExt

n5

OC

Only with Clearhaus: Only if configured: External error code (downstream system).

Only with MasaPay: Format ans..10, error code from MasaPay.

Nur bei Clearhaus: Nur wenn konfiguriert: externer Fehlercode (nachgelagertes System).

Nur bei MasaPay: Format ans..10, Fehlercode von MasaPay.

ErrorText

ans.128

OC

Only with Clearhaus: Detailed Clearhaus error message.

Only with MasaPay: Format ans..128, detailed MasaPay error message.

Is returned only if Status=FAILED. Use is possible only in agreement with

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	Wording

Nur bei Clearhaus: Detaillierte Clearhaus Fehlermeldung.

Nur bei MasaPay: Format ans..128, Detaillierte MasaPay Fehlermeldung.

Wird nur bei Status=FAILED zurückgegeben. Nutzung nur in Abstimmung mit

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	DE:Wording

möglich.

TransactionID

ans36

OC

Only with Clearhaus: Transaction number from Clearhaus

Nur bei Clearhaus: Transaktionsnummer von Clearhaus

GuWID

ans..22

O

Only with Wirecard: TransactionID of the Acquiring Bank

Nur bei Wirecard: TransaktionsID des Acquirers

TID

n..15

M

Only with Cofidis: If RefNr was submitted, it's value will be returned. Otherwise the first 15 digits of TransactionID will be returned.

Nur bei Cofidis: Wenn RefNr übergeben wurde, wird dieser Wert zurückgegeben. Anderenfalls werden die ersten 15 Stellen der TransactionID zurückgegeben.

Response parameters for captures of credit card payments

Credit with reference

Credits (refunds) are possible via a Server-to-Server connection.

Multiexcerpt include

SpaceWithExcerpt	ENWORK
MultiExcerptName	Platform-Kurz
PageWithExcerpt	Wording

permits credits which relate to a capture previously activated by

Multiexcerpt include

SpaceWithExcerpt	ENWORK
MultiExcerptName	Platform-Kurz
PageWithExcerpt	Wording

and allows merchants to carry out credits without a reference transaction. This section describes the processing of credits with reference transactions. If you refer to a capture for a Credit, the amount of the Credit is limited to the amount of the previous capture.

To carry out a credit with a reference transaction, please use the following URL:

Multiexcerpt include

SpaceWithExcerpt	ENWORK
MultiExcerptName	BaseURL
PageWithExcerpt	Wording

credit.aspx

Multiexcerpt include

SpaceWithExcerpt	ENWORK
MultiExcerptName	Request_Intro
PageWithExcerpt	Reuse API

Table Filter

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

Multiexcerpt

MultiExcerptName	credit_request

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1622748644143_248607272
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

Table Excerpt Include

static	true
name	PayID
page	PayID
type	page

Key

Format

CND

Description

Beschreibung

TransID

ans..64

M

TransactionID which should be unique for each payment

Please note for some connections the different formats that are given within the specific parameters.

TransaktionsID, die für jede Zahlung eindeutig sein muss

Bitte beachten Sie bei einigen Anbindungen die abweichenden Formate, die bei den spezifischen Parametern angegeben sind.

RefNr

ns..30

C

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	RefNr_Ctsf_Text
PageWithExcerpt	Reuse API

(not with EVO Payments, Only for CardComplete, for Clearhaus (ns..30, optional, only printable ASCII characters from 0x20 to 0x7E), for RBI (ns..20, optional), for MasaPay (ns..30, optional), for Cofidis (n..15, optional).)

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	RefNr_Ctsf_Text
PageWithExcerpt	DE:Reuse API

(nicht bei EVO Payments, Nur bei CardComplete, bei Clearhaus (ns..30, optional, nur ASCII druckbare Zeichen von 0x20 bis 0x7E), bei RBI (ns..20, optional), bei MasaPay (ns..30, optional), bei Cofidis (n..15, optional))

OrderDesc

ans..768

O

Description of refunded goods, unit prices, merchant’s comment etc. (not with Clearhaus)

Beschreibung der gutgeschriebenen Artikel, Einzelpreise, Händlerkommentar etc. (Nicht bei Clearhaus)

Table Excerpt Include

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

Key	Format	CND	Description	Beschreibung
Textfeld1	ans..30	O	Card holder information: Name (not with Clearhaus)	Karteninhaber-Information: Name (Nicht bei Clearhaus)
Textfeld2	ans..30	O	Card holder information: City (not with Clearhaus)	Karteninhaber-Information: Ort (Nicht bei Clearhaus)
CHDesc	ans..22	OC	Only with Clearhaus: Text printed on the customer’s credit card bill. Only printable ASCII characters from 0x20 to 0x7E	Nur bei Clearhaus: Text, der auf der Kreditkartenabrechnung angezeigt wird. Nur ASCII druckbare Zeichen von 0x20 bis 0x7E
TID	ans..30	OC	Only with SafeCharge: TransaktioncID of the capture to be credited, if the merchants wants to credit a specifc capture. If the parameter is nut submitted the last capture will be credited.	Nur bei SafeCharge: TransaktionsID der gutzuschreibenden Buchung, falls der Händler eine bestimmte Buchung gutschreiben möchte. Wenn der Parameter nicht angegeben ist, wird die letzte Buchung gutgeschrieben.
			Additional parameters for Wirecard connection (for Visa Direct)	Zusätzliche Parameter bei Anbindung Wirecard (für Visa Direct)
refundType	enum	C	Type of refund. Possible values: “p2p”, “md”, “acc2acc”. “ccBill”, “fd”	Art der Gutschrift. Mögliche Werte: “p2p”, “md”, “acc2acc”. “ccBill”, “fd”
receiverFirstName	an..12	C	First name of the receiver. Mandatory for cross-border transactions.	Vorname des Empfängers. Pflicht bei grenzüberschreitenden Transaktionen.
receiverLastName	an..12	C	Last name of the receiver. Mandatory for cross-border transactions.	Nachname des Empfängers. Pflicht bei grenzüberschreitenden Transaktionen.
senderAccountNumber	n..12	C	Account number of the sender. Mastercard: Mandatory. Visa: Mandatory, if RefNr is empty.	Kontonnummer des Senders. Mastercard: Pflicht. Visa: Pflicht, wenn die RefNr leer ist.
senderFirstName	an..12	C	First name of the sender. Mastercard: Mandatory. Visa: Mandatory for US domestic transactions and cross-border money transfers.	Vorname des Senders. Mastercard: Pflicht. Visa: Pflicht für US-Inlandstransaktionen und grenzüberschreitende Zahlungen.
senderLastName	an..12	C	Last name of the sender. Mastercard: Mandatory. Visa: Optional.	Nachname des Senders. Mastercard: Pflicht. Visa: Optional.
senderAddrStreet	an..25	C	Street name of the sender. Mastercard: Optional. Visa: Mandatory for US domestic transactions and cross-border money transfers.	Straßenname des Senders. Mastercard: Optional. Visa: Pflicht für US-Inlandstransaktionen und grenzüberschreitende Zahlungen.
senderAddrStreetNr	an..25	C	Street number of the sender. Mastercard: Optional. Visa: Mandatory for US domestic transactions and cross-border money transfers.	Haunsummer des Senders. Mastercard: Optional. Visa: Pflicht für US-Inlandstransaktionen und grenzüberschreitende Zahlungen.
senderAddrCity	an..32	C	Town/city of the sender. Mastercard: Optional. Visa: Mandatory for US domestic transactions and cross-border money transfers.	Ort des Senders. Mastercard: Optional. Visa: Pflicht für US-Inlandstransaktionen und grenzüberschreitende Zahlungen.
senderAddrState	a2	C	State of the sender. Mastercard: Mandatory, if senderAddrCountry=US or Canada. Visa: Mandatory for US domestic transactions and cross-border money transfers.	Bundesland des Senders. Mastercard: Pflicht, wenn senderAddrCountry=US oder Canada. Visa: Pflicht für US-Inlandstransaktionen und grenzüberschreitende Zahlungen.
senderAddrCountry	a2	C	Country of the sender. Mastercard: Optional. Visa: Mandatory if country is US and for cross-border money transfers.	Land des Senders. Mastercard: Optional. Visa: Pflicht, wenn das Land US ist, und bei grenzüberschreitende Zahlungen.

Parameters for credits of credit card payments

Multiexcerpt include

SpaceWithExcerpt	ENWORK
MultiExcerptName	Response_Intro
PageWithExcerpt	Reuse API

Table Filter

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

Multiexcerpt

MultiExcerptName	credit_response

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1622750947720_704088246
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	Response_MidPayIdXidCode
DisableCaching	true
PageWithExcerpt	Reuse API

Key

Format

CND

Description

Beschreibung

TransID

ans..64

M

Merchant’s transaction number.

Please note for some connections the different formats that are given within the specific parameters.

Transaktionsnummer des Händlers.

Bitte beachten Sie bei einigen Anbindungen die abweichenden Formate, die bei den spezifischen Parametern angegeben sind.

Status

a..50

M

OK or FAILED

OK oder FAILED

AID

n6

OC

Only in the case of Card Complete: Authorisation ID returned by Card Complete

Nur bei Card Complete: von Card Complete zurückgegebene Autorisierungs-ID

RefNr

an..25

OC

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	RefNr_Ctsf_Text
PageWithExcerpt	Reuse API

Only for Card Complete, for Clearhaus (ans..30, optional, only printable ASCII characters from 0x20 to 0x7E), for RBI (ns..20, optional), for MasaPay (ns..30, optional), for Cofidis (n..15, optional).

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	RefNr_Ctsf_Text
PageWithExcerpt	DE:Reuse API

Nur bei Card Complete, bei Clearhaus (ans..30, nur ASCII druckbare Zeichen von 0x20 bis 0x7E), bei RBI (ns..20, optional), bei MasaPay (ns..30, optional), bei Cofidis (n..15, optional).

Amount

n..10

OC

Only with Clearhaus: Amount in the smallest currency unit (e.g. EUR Cent)

If the actual amount differs from the requested amount this will be returned.

Only with MasaPay: The amount has to be equal to the originally authorised amount.

Nur bei Clearhaus: Betrag in der kleinsten Währungseinheit (z.B. EUR Cent)

Sollte der tatsächliche Betrag vom angefragten Betrag abweichen, wird dieser zurückgegeben.

Nur bei MasaPay: Betrag muss gleich dem ursprünglich autorisierten Betrag sein.

CodeExt

n5

OC

Only with Clearhaus: Only if configured: External error code (downstream system).

Only with MasaPay: Format ans..10, error code from MasaPay.

Nur bei Clearhaus: Nur wenn konfiguriert: externer Fehlercode (nachgelagertes System).

Nur bei MasaPay: Format ans..10, Fehlercode von MasaPay.

ErrorText

ans.128

OC

Only with Clearhaus: Detailed Clearhaus error message.

Only with MasaPay: Format ans..128, detailed MasaPay error message.

Is returned only if Status=FAILED. Use is possible only in agreement with

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	Wording

Nur bei Clearhaus: Detaillierte Clearhaus Fehlermeldung.

Nur bei MasaPay: Format ans..128, Detaillierte MasaPay Fehlermeldung.

Wird nur bei Status=FAILED zurückgegeben. Nutzung nur in Abstimmung mit

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	DE:Wording

möglich.

TransactionID

ans36

OC

Only with Clearhaus: Transaction number from Clearhaus

Nur bei Clearhaus: Transaktionsnummer von Clearhaus

Response parameters for credits of credit card payments

Credit without reference

Multiexcerpt include

SpaceWithExcerpt	ENWORK
MultiExcerptName	Platform-Kurz
PageWithExcerpt	Wording

can carry out Credits which do not relate to a previous capture. In this case the credit must be transferred to

Multiexcerpt include

SpaceWithExcerpt	ENWORK
MultiExcerptName	Platform-Kurz
PageWithExcerpt	Wording

as a completely new payment transaction. Please contact the

Multiexcerpt include

SpaceWithExcerpt	ENWORK
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	Wording

for help in using the described additional functions.

Notice: Please note that credits without reference to a previous capture generate higher costs with your Acquiring Bank. If you are frequently unable to make reference to the capture you should agree this with your Acquiring Bank.

To carry out a Credit without a reference transaction via a Server-to-Server connection, please use the following URL:

Multiexcerpt include

SpaceWithExcerpt	ENWORK
MultiExcerptName	BaseURL
PageWithExcerpt	Wording

creditex.aspx

Multiexcerpt include

SpaceWithExcerpt	ENWORK
MultiExcerptName	Request_Intro
PageWithExcerpt	Reuse API

Table Filter

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

Multiexcerpt

MultiExcerptName	creditex_request

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1622750180406_660866504
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

Please note for some connections the different formats that are given within the specific parameters.

TransaktionsID, die für jede Zahlung eindeutig sein muss

Bitte beachten Sie bei einigen Anbindungen die abweichenden Formate, die bei den spezifischen Parametern angegeben sind.

RefNr

ns..30

C

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	RefNr_Ctsf_Text
PageWithExcerpt	Reuse API

(not with EVO Payments, Only for CardComplete, for Clearhaus (ns..30, optional, only printable ASCII characters from 0x20 to 0x7E), for RBI (ns..20, optional), for MasaPay (ns..30, optional), for Cofidis (n..15, optional).)

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	RefNr_Ctsf_Text
PageWithExcerpt	DE:Reuse API

(nicht bei EVO Payments, Nur bei CardComplete, bei Clearhaus (ns..30, optional, nur ASCII druckbare Zeichen von 0x20 bis 0x7E), bei RBI (ns..20, optional), bei MasaPay (ns..30, optional), bei Cofidis (n..15, optional))

OrderDesc

ans..768

O

Description of refunded goods, unit prices, merchant’s comment etc. (not with Clearhaus)

Beschreibung der gutgeschriebenen Artikel, Einzelpreise, Händlerkommentar etc. (Nicht bei Clearhaus)

Table Excerpt Include

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

Key

Format

CND

Description

Beschreibung

CCNr

n..16

M

Credit card number at least 12-digit, numerical without spaces

Kreditkartennummer mind. 12stellig numerisch ohne Leerzeichen

CCCVC

n..4

O

Card verification number: The last 3 digits on the signature strip of the credit card. 4 numbers in the case of American Express.

Kartenprüfnummer: Die letzten 3 Ziffern auf dem Unterschriftsfeld der Kreditkarte. Bei American Express 4 Ziffern.

CCExpiry

n6

M

Expiry date of the credit card in the format YYYYMM, e.g. 201707.

Ablaufdatum der Kreditkarte im Format YYYYMM, z.B. 201707

CCBrand

a..22

M

Credit card brand.

Please note the spelling! According to table of credit card brands!

Kreditkartenmarke.

Bitte beachten Sie die Schreibweise gemäß Tabelle der Kreditkartenmarken!

OrderDesc

ans..768

MC

Not with Clearhaus: Description of refunded goods, unit prices, merchant’s comment etc.

Nicht bei Clearhaus: Beschreibung der gutgeschriebenen Artikel, Einzelpreise, Händlerkommentar etc.

UserData

ans..1024

OC

Only with Clearhaus: If specified at request,

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Platform-Kurz
PageWithExcerpt	Wording

forwards the parameter with the payment result to the shop.

Nur bei Clearhaus: Wenn beim Aufruf angegeben, übergibt das

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Platform-Kurz
PageWithExcerpt	DE:Wording

die Parameter mit dem Zahlungsergebnis an den Shop

Textfeld1

ans..30

O

Not with Clearhaus: Card holder information: Name

Nicht bei Clearhaus: Karteninhaber-Information: Name

Textfeld2

ans..30

O

Not with Clearhaus: Card holder information: City

Nicht bei Clearhaus: Karteninhaber-Information: Ort

CHDesc

ans..34

OC

Only with Clearhaus, format ans..22: Text printed on the customer’s credit card bill. Only printable ASCII characters from 0x20 to 0x7E

Only for Credorax: Text printed on the customer’s credit card bill.

This function must be enabled by Credorax and have the following structure.

1) merchant DBA name (up to 20 characters)

2) asterisk

3) additional text (up to 13 characters).

e.g.

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Partner-Name
PageWithExcerpt	Wording

*Test

This value can be alternatively permanently defined by

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	Wording

Nur bei Clearhaus, Format ans..22: Text, der auf der Kreditkartenabrechnung angezeigt wird. Nur ASCII druckbare Zeichen von 0x20 bis 0x7E

Nur bei Credorax: Text, der auf der Kreditkartenabrechnung angezeigt wird.

Diese Funktion muss von Credorax freigeschalten werden und folgenden Aufbau haben.

1) merchant DBA Name (bis zu 20 Zeichen)

2) Stern

3) zusätzlicher Text (bis zu 13 Zeichen).

z.B.

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Partner-Name
PageWithExcerpt	DE:Wording

*Test

Dieser Wert kann alternativ vom

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	DE:Wording

fest hinterlegt werden.

CreditCardHolder

an..255

MC

Only with Credorax, ECPCC: Name of the card holder

Nur bei Credorax, ECPCC: Name des Karteninhabers

Email

ans..64

MC

Only with Credorax, ECPCC: Email address of the customer

Nur bei Credorax, ECPCC: E-Mail-Adresse des Kunden

IPAddr

ans..15

OC

Only with Credorax, ECPCC: Customer´s IP address

Nur bei Credorax, ECPCC: IP-Adresse des Kunden

PaymentOfWinnings

ans..4

OC

In the case of the acquirer EMS (Omnipay) the merchant can control CFT credit notes in this way.
Transfer PaymentOfWinnings=True to credit a win rather than simply repaying a paid amount.

Beim Acquirer EMS (Omnipay) kann der Händler hiermit CFT-Gutschriften steuern.
Übergeben Sie PaymentOfWinnings=True, um einen Gewinn gutzuschreiben, anstatt nur einen eingezahlten Betrag zurückzuerstatten.

TransactionID

an..150

M

Additional reference number

Zusätzliche Referenznummer

Further address parameters in case of ECPCC connection

Weitere Adressparameter bei der Anbindung ECPCC

DateOfBirth

n8

O

Date of birth of the customer in format YYYYMMDD

Geburtsdatum des Kunden im Format YYYYYMMDD

Phone

n..32

O

Customer’s phone number

Telefonnummer des Kunden

FirstName

ans..255

M

First name of the customer

Vorname des Kunden

LastName

ans..255

M

Last name of the customer

Nachname des Kunden

AddrStreet

ans..255

O

Street name

Straßenname

AddressAddition

ans..255

O

Address c/o

Adresszusatz

AddrZip

an..9

O

Postcode

Postleitzahl

AddrCity

ans..255

O

City

Ort

AddrState

a2

O

Code of the customer’s Federal State

Code des Bundeslandes des Kunden

AddrCountryCode

a2

M

Country code according to ISO-3166-1, alphanumeric 2 chars

Ländercode im Format ISO-3166-1, alphanumerisch 2-stellig

sdFirstName

ans..255

O

First name in the delivery address

Vorname in der Lieferanschrift

sdLastName

ans..255

O

Surname in the delivery address

Nachname in der Lieferanschrift

sdStreet

ans..255

O

Street name in the delivery address

Straßenname der Lieferanschrift

sdAddressAddition

ans..255

O

Address addition in the delivery address

Adresszusatz der Lieferanschrift

sdZIPCode

an..9

O

Postcode in the delivery address

Postleitzahl der Lieferanschrift

sdCity

ans..255

O

Town/city in the delivery address

Ort der Lieferanschrift

sdState

a2

O

Code of Federal State in the delivery address

Code des Bundeslandes der Lieferanschrift

sdCountryCode

a2

O

Country code of delivery address according to ISO-3166-1, alphanumeric 2 chars

Ländercode der Lieferanschrift im Format ISO-3166-1, alphanumerisch 2-stellig

Further address parameters in case of Kalixa connection

Weitere Adressparameter bei der Anbindung Kalixa

IPAddr

ans..15

M

Customer´s IP address

IP-Adresse des Kunden

BrowserSessionID

ans..64

M

Customer´s Session ID

SessionID des Kunden

CreditCardHolder

ans..100

M

Name of the card holder

Name des Karteninhabers

CustomerID

an..20

M

Customer number: Number to identify the customer

Kundennummer: Nummer zur Identifizierung des Kunden

Name

ans..100

C

User name of the customer

Benutzername des Kunden

FirstName

ans..100

C

First name of the customer

Vorname des Kunden

LastName

ans..100

C

Last name of the customer

Nachname des Kunden

Email

ans..64

C

Email address of the customer

E-Mail-Adresse des Kunden

Language

a2

C

Language of the customer according to ISO, alphanumeric 2-digits

Sprache des Kunden gemäß ISO, alphanumerisch 2-stellig

sdFirstName

ans..100

C

First name in the delivery address

Vorname in der Lieferanschrift

sdLastName

ans..100

C

Surname in the delivery address

Nachname in der Lieferanschrift

sdStreet

ans..200

C

Street name in the delivery address

Straßenname der Lieferanschrift

sdStreetNr

ans..5

C

Street number in the delivery address

Hausnummer der Lieferanschrift

sdZIPCode

an..20

C

Postcode in the delivery address

Postleitzahl der Lieferanschrift

sdCity

ans..40

C

Town/city in the delivery address

Ort der Lieferanschrift

sdState

a2

C

Code of Federal State in the delivery address

Code des Bundeslandes der Lieferanschrift

sdCountryCode

a2

C

Country code of delivery address according to ISO-3166-1, alphanumeric 2 chars

Ländercode der Lieferanschrift im Format ISO-3166-1, alphanumerisch 2-stellig

Further address parameters in case of Vantiv connection

Weitere Adressparameter bei der Anbindung Vantiv

bdFirstName

ans..25

O

First name in the invoicing address

Vorname in der Rechnungsadresse

bdLastName

ans..25

O

Last name in the invoicing address

Nachname in der Rechnungsadresse

bdStreet

ans..35

O

Street name in the invoicing address

Please note that bdStreet and bdStreetNr together may have 34 characters maximum.

bdStreet and bdStreetNr are combined with a space character between and forwarded together. The total content is truncated after 35 characters.

Straßenname in der Rechnungsadresse

Bitte beachten Sie, dass bdStreet und bdStreetNr zusammen maximal 34 Zeichen haben dürfen.

bdStreet und bdStreetNr werden mit einem Leerzeichen getrennt zusammengefügt und gemeinsam weitergeleitet. Der Gesamtinhalt wird nach 35 Zeichen abgeschnitten.

bdStreetNr

ans..35

O

Street number in the invoicing address

Please note that bdStreet and bdStreetNr together may have 34 characters maximum.

bdStreet and bdStreetNr are combined with a space character between and forwarded together. The total content is truncated after 35 characters.

Hausnummer in der Rechnungsadresse

Bitte beachten Sie, dass bdStreet und bdStreetNr zusammen maximal 34 Zeichen haben dürfen.

bdStreet und bdStreetNr werden mit einem Leerzeichen getrennt zusammengefügt und gemeinsam weitergeleitet. Der Gesamtinhalt wird nach 35 Zeichen abgeschnitten.

bdStreet2

ans..35

O

Address addition in the billing address

Adresszusatz in der Rechnungsadresse

bdZIPCode

ans..20

O

Postcode in the invoicing address

Postleitzahl in der Rechnungsadresse

bdCity

ans..35

O

Town/city in the invoicing address

Ort in der Rechnungsadresse

bdState

ans..30

O

State/country in the invoicing address

Staat/Land in der Rechnungsadresse

bdCountryCode

a2

O

Country code of invoicing address according to ISO-3166-1, alphanumeric 2 chars

Ländercode der Rechnungsadresse im Format ISO-3166-1, alphanumerisch 2-stellig

bdMail

ans..100

O

Email address in the invoicing address

E-Mail in der Rechnungsadresse

bdPhone

ans..20

O

Phone number in the invoicing address

Telefonnummer in der Rechnungsanschrift

Parameters for credits of credit card payments without reference

Multiexcerpt include

SpaceWithExcerpt	ENWORK
MultiExcerptName	Response_Intro
PageWithExcerpt	Reuse API

Table Filter

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

Multiexcerpt

MultiExcerptName	creditex_response

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1622751517629_1034149677
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	Response_MidPayIdXidCode
DisableCaching	true
PageWithExcerpt	Reuse API

Key

Format

CND

Description

Beschreibung

TransID

ans..64

M

Merchant’s transaction number.

Please note for some connections the different formats that are given within the specific parameters.

Transaktionsnummer des Händlers.

Bitte beachten Sie bei einigen Anbindungen die abweichenden Formate, die bei den spezifischen Parametern angegeben sind.

Status

a..50

M

OK or FAILED

OK oder FAILED

AID

n6

OC

Only in the case of Card Complete: Authorisation ID returned by Card Complete

Nur bei Card Complete: von Card Complete zurückgegebene Autorisierungs-ID

RefNr

an..25

OC

Only for Card Complete: If a RefNr has been transmitted, it is returned.

Nur bei Card Complete: Falls eine RefNr übermittelt wurde, wird sie wieder zurückgegeben.

Amount

n..10

OC

Only with Clearhaus: Amount in the smallest currency unit (e.g. EUR Cent)

If the actual amount differs from the requested amount this will be returned.

Nur bei Clearhaus: Betrag in der kleinsten Währungseinheit (z.B. EUR Cent)

Sollte der tatsächliche Betrag vom angefragten Betrag abweichen, wird dieser zurückgegeben.

CodeExt

n5

OC

Only with Clearhaus: Only if configured: External error code (downstream system)

Nur bei Clearhaus: Nur wenn konfiguriert: externer Fehlercode (nachgelagertes System)

ErrorText

ans.128

OC

Only with Clearhaus: Detailed Clearhaus error message.

Is returned only if Status=FAILED. Use is possible only in agreement with

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	Wording

Nur bei Clearhaus: Detaillierte Clearhaus Fehlermeldung.

Wird nur bei Status=FAILED zurückgegeben. Nutzung nur in Abstimmung mit dem

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	DE:Wording

möglich.

UserData

ans..1024

OC

Only with Clearhaus: If specified at request,

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Platform-Kurz
PageWithExcerpt	Wording

forwards the parameter with the payment result to the shop.

Nur bei Clearhaus: Wenn beim Aufruf angegeben, übergibt das

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Platform-Kurz
PageWithExcerpt	Wording

die Parameter mit dem Zahlungsergebnis an den Shop

TransactionID

ans36

OC

Only with Clearhaus: Transaction number from Clearhaus

Nur bei Clearhaus: Transaktionsnummer von Clearhaus

Response parameters for credits of credit card payments without reference

Reversal

A credit card authorisation lowers the customer's credit line.

Multiexcerpt include

SpaceWithExcerpt	ENWORK
MultiExcerptName	Platform-Kurz
PageWithExcerpt	Wording

can reverse an authorisation so that it no longer block the limit any more. Use the following URL:

Multiexcerpt include

SpaceWithExcerpt	ENWORK
MultiExcerptName	BaseURL
PageWithExcerpt	Wording

reverse.aspx

Notice: Reverse.aspx does not only reverse authorisations, but any LAST TRANSACTION STAGE!! If the last transaction was a capture, Reverse.aspx initiates the reverse, e.g. a credit. Therefore, the utmost caution is urged. Use is at your own risk. We recommend checking the transaction status with Inquire.aspx before using Reverse.aspx.

Multiexcerpt include

SpaceWithExcerpt	ENWORK
MultiExcerptName	Request_Intro
PageWithExcerpt	Reuse API

Table Filter

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

Multiexcerpt

MultiExcerptName	Reverse_request

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1622751796071_248607272
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

Table Excerpt Include

static	true
name	PayID
page	PayID
type	page

Key

Format

CND

Description

Beschreibung

TransID

ans..64

M

Merchant ID for the identification of the payment process to be reversed.

Please note for some connections the different formats that are given within the specific parameters.

ID des Händlers zur Identifizierung des zu stornierenden Zahlungsvorgangs.

Bitte beachten Sie bei einigen Anbindungen die abweichenden Formate, die bei den spezifischen Parametern angegeben sind.

RefNr

ans..30

OC

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	RefNr_Ctsf_Text
PageWithExcerpt	Reuse API

Only for Clearhaus (only printable ASCII characters from 0x20 to 0x7E), for MasaPay.

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	RefNr_Ctsf_Text
PageWithExcerpt	DE:Reuse API

Nur bei Clearhaus (nur ASCII druckbare Zeichen von 0x20 bis 0x7E), bei MasaPay.

Table Excerpt Include

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

Parameters for reversals of credit card payments

Multiexcerpt include

SpaceWithExcerpt	ENWORK
MultiExcerptName	Response_Intro
PageWithExcerpt	Reuse API

Table Filter

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

Multiexcerpt

MultiExcerptName	Reverse_response

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1622754133575_1918736424
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	Response_MidPayIdXidCode
DisableCaching	true
PageWithExcerpt	Reuse API

Key

Format

CND

Description

Beschreibung

TransID

ans..64

M

Merchant’s transaction number.

Please note for some connections the different formats that are given within the specific parameters.

Transaktionsnummer des Händlers.

Bitte beachten Sie bei einigen Anbindungen die abweichenden Formate, die bei den spezifischen Parametern angegeben sind.

Status

a..50

M

OK or FAILED

OK oder FAILED

RefNr

an..25

OC

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	RefNr_Ctsf_Text
PageWithExcerpt	Reuse API

Only for Card Complete, for Clearhaus (ans..30, only printable ASCII characters from 0x20 to 0x7E), for MasaPay (ns..30).

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	RefNr_Ctsf_Text
PageWithExcerpt	DE:Reuse API

Nur bei Card Complete, bei Clearhaus (ans..30, nur ASCII druckbare Zeichen von 0x20 bis 0x7E), bei MasaPay (ns..30)

AID

n6

OC

Only in the case of Card Complete: Authorisation ID returned by Card Complete

Nur bei Card Complete: von Card Complete zurückgegebene Autorisierungs-ID

CodeExt

n5

OC

Only with Clearhaus: Only if configured: External error code (downstream system)

Only with MasaPay: Format ans..10, error code from MasaPay

Nur bei Clearhaus: Nur wenn konfiguriert: externer Fehlercode (nachgelagertes System)

Nur bei MasaPay: Format ans..10, Fehlercode von MasaPay

ErrorText

ans.128

OC

Only with Clearhaus: Detailed Clearhaus error message.

Only with MasaPay: Format ans..128, detailed MasaPay error message.

Is returned only if Status=FAILED. Use is possible only in agreement with

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	Wording

Nur bei Clearhaus: Detaillierte Clearhaus Fehlermeldung.

Nur bei MasaPay: Format ans..128, Detaillierte MasaPay Fehlermeldung.

Wird nur bei Status=FAILED zurückgegeben. Nutzung nur in Abstimmung mit dem

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	DE:Wording

möglich.

TransactionID

ans36

OC

Only with Clearhaus: Transaction number from Clearhaus

Nur bei Clearhaus: Transaktionsnummer von Clearhaus

Response parameters for reversals of credit card payments

Reversal of an authorisation extension

A credit card authorisation is valid for only 7 to 30 days. In order to maintain your payment claim in the case of longer delivery times,

Multiexcerpt include

SpaceWithExcerpt	ENWORK
MultiExcerptName	Platform-Kurz
PageWithExcerpt	Wording

enables the automatic renewal of the authorisation. Renewal of the authorisation is also important for instalments or partial deliveries because the outstanding amount is invalid in the case of partial captures.

If you use authorisation renewal,

Multiexcerpt include

SpaceWithExcerpt	ENWORK
MultiExcerptName	Platform-Kurz
PageWithExcerpt	Wording

renews your authorisations until the payment has been captured fully. Amongst other things the customer's card limit is reduced by the authorised amount. In order to restore the card limit again, for example because the order cannot be fully delivered, you need to specifically cancel the authorisation renewal with the following URL:

Multiexcerpt include

SpaceWithExcerpt	ENWORK
MultiExcerptName	BaseURL
PageWithExcerpt	Wording

cancelAuth.aspx

Notice: CancelAuth cancels only the recurrence of the authorisation. If you wish to unblock the customer's card limit, please reverse the authorisation in accordance with the section above.

Multiexcerpt include

SpaceWithExcerpt	ENWORK
MultiExcerptName	Request_Intro
PageWithExcerpt	Reuse API

Table Filter

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

Multiexcerpt

MultiExcerptName	cancelAuth_request

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1622751816299_248607272
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

Table Excerpt Include

static	true
name	PayID
page	PayID
type	page

Key	Format	CND	Description	Beschreibung
TransID	ans..64	M	TransID for the identification of the payment process to be reversed	ID des Händlers zur Identifizierung des zu stornierenden Zahlungsvorgangs

Table Excerpt Include

static	true
name	MAC
page	MAC
type	page

Parameters for reversal of an authorisation extension

Multiexcerpt include

SpaceWithExcerpt	ENWORK
MultiExcerptName	Response_Intro
PageWithExcerpt	Reuse API

Table Filter

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

Multiexcerpt

MultiExcerptName	cancelAuth_response

Table Transformer

isFirstTimeEnter	false
dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1622762066221_513679147
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
join-column	Key
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

Key	Format		CND	Description	Beschreibung
TransID	ans..64		M	Merchant’s transaction number.	Transaktionsnummer des Händlers.
Status	a..50		M	OK or FAILED	OK oder FAILED

Table Excerpt Include

static	true
name	Description
page	Description
type	page

Table Excerpt Include

static	true
name	Code
page	Code
type	page

Result parameters for reversals of an authorisation extension

Credit card payment via POS terminals

To make a credit card payment via a POS terminal (POS: Point of Sale), send the payment request to the following URL:

Multiexcerpt include

SpaceWithExcerpt	ENWORK
MultiExcerptName	BaseURL
PageWithExcerpt	Wording

stationary.aspx

Multiexcerpt include

SpaceWithExcerpt	ENWORK
MultiExcerptName	Request_Intro
PageWithExcerpt	Reuse API

Table Filter

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

Multiexcerpt

MultiExcerptName	stationary_request

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1622751840612_248607272
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

Table Excerpt Include

static	true
name	TransID
page	TransID
type	page

Key

Format

CND

Description

Beschreibung

RefNr

ns..30

O

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	RefNr_Ctsf_Text
PageWithExcerpt	Reuse API

Format must be mutually agreed beforehand with

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	Wording

!

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	RefNr_Ctsf_Text
PageWithExcerpt	DE:Reuse API

Das Format muss vorher mit

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	DE:Wording

abgestimmt werden!

CCNr

n..16

M

Credit card number at least 12-digit, numerical without spaces

Kreditkartennummer mind. 12stellig numerisch ohne Leerzeichen

CCCVC

n..4

O

Card verification number: The last 3 digits on the signature strip of the credit card. 4 numbers in the case of American Express.

Kartenprüfnummer: Die letzten 3 Ziffern auf dem Unterschriftsfeld der Kreditkarte. Bei American Express 4 Ziffern.

CCExpiry

n6

M

Expiry date of the credit card in the format YYYYMM, e.g. 201707.

Ablaufdatum der Kreditkarte im Format YYYYMM, z.B. 201707

CCBrand

a..22

M

Credit card brand.

Please note the spelling! According to table of credit card brands!

Kreditkartenmarke.

Bitte beachten Sie die Schreibweise gemäß Tabelle der Kreditkartenmarken!

Track2

ans..80

M

Hexadecimal data on track 2 of the credit card

Hexadezimale Daten auf Spur 2 der Kreditkarte

Track3

ans..80

M

Hexadecimal data on track 3 of the credit card

Hexadezimale Daten auf Spur 3 der Kreditkarte

OrderDesc

ans..768

M

Description of purchased goods, unit prices etc.

Beschreibung der gekauften Waren, Einzelpreise etc.

Table Excerpt Include

static	true
name	Capture
page	Capture
type	page

Table Excerpt Include

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

Parameters for credit card payments via POS terminals

Multiexcerpt include

SpaceWithExcerpt	ENWORK
MultiExcerptName	Response_Intro
PageWithExcerpt	Reuse API

Table Filter

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

Multiexcerpt

MultiExcerptName	stationary_response

Table Transformer

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

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Response_MidPayIdXidCode
DisableCaching	true
PageWithExcerpt	Reuse API

Key	Format	CND	Description	Beschreibung
TransID	ans..64	M	Merchant’s transaction number	Transaktionsnummer des Händlers
TID	n..20	M	Usually a nine-digit terminal number	In der Regel neunstellige Terminalnummer
AuthCode	ans..6	M	Acquiring Bank's authorisation code	Autorisierungscode des Acquirers
Status	a..50	M	AUTHORIZED or FAILED. OK status applies only to Sale transactions.	AUTHORIZED oder FAILED. Nur bei Sale-Transaktionen lautet der Status OK.

Response parameters for credit card payments via POS terminals

Reversal of POS credit card payments

To reverse the capture of a credit card payment via a stationary terminal, please use the following URL:

Multiexcerpt include

SpaceWithExcerpt	ENWORK
MultiExcerptName	BaseURL
PageWithExcerpt	Wording

stationary_rev.aspx

Multiexcerpt include

SpaceWithExcerpt	ENWORK
MultiExcerptName	Request_Intro
PageWithExcerpt	Reuse API

Table Filter

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

Multiexcerpt

MultiExcerptName	stationary_rev_request

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1622751852857_248607272
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

Table Excerpt Include

static	true
name	PayID
page	PayID
type	page

Table Excerpt Include

static	true
name	XID
page	XID
type	page

Key	Format	CND	Description	Beschreibung
TransID	ans..64	M	ID of merchant for the identification of the payment process to be reversed	ID des Händlers zur Identifizierung des zu stornierenden Zahlungsvorgangs

Table Excerpt Include

static	true
name	MAC
page	MAC
type	page

Parameters for reversal of credit card payments via POS terminals

Multiexcerpt include

SpaceWithExcerpt	ENWORK
MultiExcerptName	Response_Intro
PageWithExcerpt	Reuse API

Table Filter

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

Multiexcerpt

MultiExcerptName	stationary_rev_response

Table Transformer

isFirstTimeEnter	false
dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1622761992731_-100898897
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
join-column	Key
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

Key	Format		CND	Description	Beschreibung
TransID	ans..64		M	Merchant’s transaction number.	Transaktionsnummer des Händlers.
Status	a..50		M	OK or FAILED	OK oder FAILED

Table Excerpt Include

static	true
name	Code
page	Code
type	page

Response parameters for reversal of credit card payments via POS terminals

PayNow

Silent Mode for credit cards with SSL and 3-D Secure method

PayNow links the benefits of

Multiexcerpt include

SpaceWithExcerpt	ENWORK
MultiExcerptName	Platform-Kurz
PageWithExcerpt	Wording

forms and Server-to-Server connections: As opposed to the

Multiexcerpt include

SpaceWithExcerpt	ENWORK
MultiExcerptName	Platform-Kurz
PageWithExcerpt	Wording

form, where the form is loaded from the

Multiexcerpt include

SpaceWithExcerpt	ENWORK
MultiExcerptName	Platform-Kurz
PageWithExcerpt	Wording

server by calling payssl.aspx, the PayNow form has to be provided by the merchant’s system. The form uses the same parameters as described here below.

In contrast to the

Multiexcerpt include

SpaceWithExcerpt	ENWORK
MultiExcerptName	Platform-Kurz
PageWithExcerpt	Wording

form, the parameters are not forwarded as URL parameters as is the case when calling the payssl.aspx, but as form input parameters. By the way for calling the PayNow.aspx the same parameters can be used as for PaySSL.aspx.

Note
Please notice that in case of Fallback to 3-D Secure 1.0 the URLSuccess or URLFailure is called with GET. Therefore your systems should be able to receive parameters both via GET and via POST.

Multiexcerpt

MultiExcerptName	paynow_LenData

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Platform-Kurz
PageWithExcerpt	Wording

-Formular

PayNow

payssl.aspx?MerchantID=[mid]&Len=[len]&Data=[data]

Code Block

language	xml

<form action=paynow.aspx>
<input type="hidden" name="MerchantID" value=[mid]>
<input type="hidden" name="Len"        value=[len]>
<input type="hidden" name="Data"       value=[data]>
:
</form>

The credit card data must be transmitted to paynow.aspx with the following parameters:

Table Filter

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

Multiexcerpt

MultiExcerptName	paynow_request

Table Transformer

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

Key	Format	CND	Description	Beschreibung
CCNr	n..16	M	Credit card number at least 12-digit, numerical without spaces	Kreditkartennummer: mindestens 12stellig ohne Leerzeichen
CCCVC	n3	O	Card verification number: The last 3 digits on the signature strip of the credit card	Kartenprüfnummer: Die letzten 3 Ziffern auf dem Unterschriftsfeld der Kreditkarte
CCExpiry	n6	M	Expiry date of the credit card in the format YYYYMM, e.g. 201807.	Ablaufdatum der Kreditkarte im Format YYYYMM, z.B. 201807
CCBrand	a..22	M	Credit card brand. Please note the spelling! According to table of credit card brands!	Kreditkartenmarke. Bitte beachten Sie die Schreibweise gemäß Tabelle der Kreditkartenmarken!

PayNow parameters for 3-D Secure method

After the customer has entered his credit card data, the payment data is forwarded to the PayNow page, where the further payment processing takes place via 3-D Secure. The form details must be directly forwarded to the PayNow page and may not be transmitted to the merchant’s system! Also, no PCI-relevant data may be transmitted to the PayNow page as additional input parameters!

Batch processing via the interface

Basic information about using Batch files and about their structure can be found in the Batch Manager manual. Within batch processing not alle functions are available which are usually available for the online interface.

Batch calls and answers

This section describes the parameters which must be transferred within the data set (Record) for executing a credit card payment and which information can be found within the response file about the payment status.

Notice: Within Batch process not all functions of online interface are available.

For Batch calls there must be considered batch versions, from which optional parameters depend. All version designations starting with „2.“ pertain calls for a group of enterprises. That means within a batch file for a particular MerchantID can be transferred transactions for other merchants with a separate Sub-MID.

For the connections ECPCC, GMO, Kalixa and SafeCharge the possible actions are limited to Capture, Credit and Reverse.

Following table gives an overview of all batch versions that are possible for a specific action and their specialities:

Table Filter

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

Multiexcerpt

MultiExcerptName	batch_versions

Table Transformer

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

Action	Version	Description	Beschreibung
Authorize	1.2 / 2.2	with textfeld1, textfeld2, RTF, cardholder, transactionID, schemeReferenceID	mit textfeld1, textfeld2, RTF, cardholder, transactionID, schemeReferenceID
	1.21 / 2.21	with textfeld1, textfeld2, RTF, approvalcode, cardholder, transactionID, schemeReferenceID	mit textfeld1, textfeld2, RTF, approvalcode, cardholder, transactionID, schemeReferenceID
	1.3 / 2.3	with CVC, transactionID, schemeReferenceID	mit CVC, transactionID, schemeReferenceID
	1.5 / 2.5	with CVC, Zone	mit CVC, Zone
Capture	1.2 / 2.2	with textfeld1, textfeld2	mit textfeld1, textfeld2
	1.21 / 2.21	with textfeld1, textfeld2, approvalcode	mit textfeld1, textfeld2, approvalcode
	1.4 / 2.4	with stop of authorisation renewal (FinishAuth)	mit Stopp der Autorisierungsverlängerung (FinishAuth)
CaptureEx	1.3 / 2.3	with CVC	mit CVC
Credit	1.2 / 2.2	with textfeld1, textfeld2	mit textfeld1, textfeld2
	1.21 / 2.21	with textfeld1, textfeld2	mit textfeld1, textfeld2
	1.4 / 2.4	with stop of authorisation renewal (FinishAuth)	mit Stopp der Autorisierungsverlängerung (FinishAuth)
CreditEx	1.2 / 2.2	with textfeld1, textfeld2	mit textfeld1, textfeld2
	1.21 / 2.21	with textfeld1, textfeld2	mit textfeld1, textfeld2
	1.3 / 2.3	with textfeld1, textfeld2	mit textfeld1, textfeld2
Sale	1.2 / 2.2	with textfeld1, textfeld2, RTF, cardholder, transactionID, schemeReferenceID	mit textfeld1, textfeld2, RTF, cardholder, transactionID, schemeReferenceID
	1.21 / 2.21	with textfeld1, textfeld2, RTF, approvalcode, cardholder, transactionID, schemeReferenceID	mit textfeld1, textfeld2, RTF, approvalcode, cardholder, transactionID, schemeReferenceID
	1.3 / 2.3	with CVC, textfeld1, textfeld2, transactionID, schemeReferenceID	mit CVC, textfeld1, textfeld2, transactionID, schemeReferenceID
	1.5 / 2.5	with CVC, Zone	mit CVC, Zone
Reverse	1.x / 2.x	Standard version	Standardversion

Description of the possible batch versions

The structure for a credit card payment within a Batch file to be submitted is the following:

Multiexcerpt

MultiExcerptName	batch_structure

Code Block

language	xml

HEAD,<MerchantID>,<Date>,<Version>
CC,Authorize,<Amount>,<Currency>,<TransID>,(<RefNr>),<CCBrand>,<CCNr|PCNr>, [<CCCVC>,]<CCExpiry>,<OrderDesc>[,<textfeld1>,<textfeld2>,<RTF>,<approvalcode>,<cardholder>,<Zone>,<transactionID>,<schemeReferenceID>]
CC,Capture,<Amount>,<Currency>,<TransID>,(<RefNr>),<PayID>,[<FinishAuth,<textfeld1>,<textfeld2>,<approvalcode>]
CC,Sale,<Amount>,<Currency>,<TransID>,(<RefNr>),<CCBrand>,<CCNr|PCNr>, [<CCCVC>,]<CCExpiry>,<OrderDesc>[,<textfeld1>,<textfeld2>,<RTF>,<approvalcode>,<cardholder>,<Zone>,<transactionID>,<schemeReferenceID>]]
CC,Credit,<Amount>,<Currency>,<TransID>,(<RefNr>),<PayID>[,<FinishAuth>,<textfeld1>,<textfeld2>]
CC,CreditEx,<Amount>,<Currency>,<TransID>,(<RefNr>),<CCBrand>,<CCNr|PCNr>, [<CCCVC>,]<CCExpiry>,<OrderDesc>[,<textfeld1>,<textfeld2>]
CC,Reverse,<Amount>,<Currency>,<TransID>,(<RefNr>),<PayID>
FOOT,<CountRecords>,<SumAmount>

Example for batch versions:

Multiexcerpt

MultiExcerptName	batch_examples

Code Block

language	xml
title	Version 1.2

CC,Sale,<Amount>,<Currency>,<TransID>,(<RefNr>),<CCBrand>,<CCNr|PCNr>,<CCExpiry>,<OrderDesc>
CC,Sale,<Amount>,<Currency>,<TransID>,(<RefNr>),<CCBrand>,<CCNr|PCNr>,<CCExpiry>,<OrderDesc>,<textfeld1>,<textfeld2>,<RTF>,<cardholder>,<transactionID>,<schemeReferenceID>

Code Block

language	xml
title	Version 1.21

CC,Sale,<Amount>,<Currency>,<TransID>,(<RefNr>),<CCBrand>,<CCNr|PCNr>,<CCExpiry>,<OrderDesc>,<textfeld1>,<textfeld2>,<RTF>,<approvalcode>,<cardholder>,<transactionID>,<schemeReferenceID>

Code Block

language	xml
title	Version 1.3

CC,Sale,<Amount>,<Currency>,<TransID>,(<RefNr>),<CCBrand>,<CCNr|PCNr>,<CCCVC>,<CCExpiry>,<OrderDesc>,<textfeld1>,<textfeld2>,<transactionID>,<schemeReferenceID>

Code Block

language	xml
title	Version 1.5

CC,Sale,<Amount>,<Currency>,<TransID>,(<RefNr>),<CCBrand>,<CCNr|PCNr>,<CCCVC>,<CCExpiry>,<OrderDesc>,<Zone>

Example for Master MID Funktion:

Multiexcerpt

MultiExcerptName	batch_mastermid

Code Block

language	xml

HEAD,[Master]MerchantID,Date,2.x
Type,Action,[Slave]MID,Amount,Currency,TransID,Data (depends on Action)
FOOT,CountRecords,SumAmount

The following table describes the individual fields and values used within the data set (record) in the batch file:

Table Filter

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

Multiexcerpt

MultiExcerptName	batch_request

Table Transformer

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

Key

Format

CND

Description

Beschreibung

Type

a..11

M

HEAD for Header, FOOT for Footer, CC for credit card

HEAD für Header, FOOT für Footer, CC für Kreditkarte

Action

a..20

M

The parameter Action defines the type of transaction:

Authorize (authorisation)

Capture

Sale

Credit

CreditEx (credit note without previous capture; please agree this with

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	Wording

beforehand)

Reverse (cancellation)

Der Action-Parameter definiert die Art der Transaktion:

Authorize (Autorisierung)

Capture (Buchung)

Sale (Verkauf)

Credit (Gutschrift)

CreditEx (Gutschrift ohne vorherige Buchung; bitte stimmen sie sich hierzu vorher mit dem

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	DE:Wording

ab)

Reverse (Storno)

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	PayID
page	PayID
type	page

Key

Format

CND

Description

Beschreibung

TransID

ans..64

M

TransactionID which should be unique for each payment.

Please note for some connections the different formats that are given within the specific parameters.

TransaktionsID, die für jede Zahlung eindeutig sein muss.

Bitte beachten Sie bei einigen Anbindungen die abweichenden Formate, die bei den spezifischen Parametern angegeben sind.

RefNr

ns..30

O

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	RefNr_Ctsf_Text
PageWithExcerpt	Reuse API

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	RefNr_Ctsf_Text
PageWithExcerpt	DE:Reuse API

OrderDesc

ans..127

O

Description of purchased goods, unit prices etc.

Beschreibung der gekauften Waren, Einzelpreise etc.

CCBrand

a..22

C

Credit card brand.

Please note the spelling! According to table of credit card brands!

Kreditkartenmarke.

Bitte beachten Sie die Schreibweise gemäß Tabelle der Kreditkartenmarken!

CCNr

n..16

C

Credit card number at least 12-digit, numerical without spaces. You can optionally transmit also a pseudo card number (PCN)

Kreditkartennummer mind. 12stellig numerisch ohne Leerzeichen. Optional können Sie auch eine Pseudokartennummer (PKN) übergeben

Table Excerpt Include

static	true
name	PCNr
page	PCNr
type	page

Table Excerpt Include

static	true
name	CCExpiry_Response
page	CCExpiry
type	page

Key

Format

CND

Description

Beschreibung

CCCVC

n..4

O

Card verification number in Version 1.3: In the case of Visa and MasterCard the last 3 numbers on the signature strip of the credit card. 4 numbers in the case of American Express.

Kartenprüfnummer in Version 1.3: Bei Visa und MasterCard die letzten 3 Ziffern auf dem Unterschriftsfeld der Kreditkarte. Bei American Express 4 Ziffern.

FinishAuth

ans1

O

Version=1.4: If using the authorisation renewal, cancel repeat with the value Y in the field FinishAuth in the case of Capture or Credit. Example: You capture a partial delivery. The rest of the order cannot be supplied. You therefore enter Y in the FinishAuth field for Part-capture so that the

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Platform-Kurz
PageWithExcerpt	Wording

does not authorise the remaining amount. Please note for this also the following section about Cancel authorisation renewals.

Version=1.4: Wenn Sie die Autorisierungsverlängerung nutzen, stoppen Sie die Wiederholung mit dem Wert Y im Feld FinishAuth bei Capture oder Credit. Beispiel: Sie buchen eine Teillieferung. Der Rest der Bestellung ist nicht lieferbar. Daher übergeben Sie beim Capture der Teilbuchung im Feld FinishAuth Y, damit das

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Platform-Kurz
PageWithExcerpt	DE:Wording

den Restbetrag nicht wieder au-torisiert. Beachten Sie dazu auch den folgenden Abschnitt zum Stopp von Autorisierungsverlängerungen.

Description of fields within the record for Batch files

The record area within the response file for Batch transactions looks as follows:

Multiexcerpt

MultiExcerptName	batch_transactions

Code Block

language	xml

HEAD,<MerchantID>,<Date>,<Version>
CC,Authorize,<Amount>,<Currency>,<TransID>,(<RefNr>),<PayID>,<CCBrand>,<CCNr|PCNr>,[<CCCVC>,]<CCExpiry>,<OrderDesc>[,<textfeld1>,<textfeld2>,<RTF>,<approvalcode>,<cardholder>,<Zone>,<transactionID>,<schemeReferenceID>],<Status>,<Code>
CC,Capture,<Amount>,<Currency>,<TransID>,(<RefNr>),<PayID>[<textfeld1>,<textfeld2>,<approvalcode>],<Status>,<Code>
CC,AuthSplit,<Amount>,<Currency>,<TransID>,(<RefNr>),<PayID>,FAILED,<Code>,<Description>,[<PCNr>]
CC,Renewal,<Amount>,<Currency>,<TransID>,(<RefNr>),<PayID>,FAILED,<Code>,<Description>,[<PCNr>]
CC,Sale,<Amount>,<Currency>,<TransID>,(<RefNr>),<PayID>,<CCBrand>,<CCNr|PCNr>,[<CCCVC>,]<CCExpiry>,<OrderDesc>[,<textfeld1>,<textfeld2>,<RTF>,<approvalcode>,<cardholder>,<Zone>,<transactionID>,<schemeReferenceID>],<Status>,<Code>
CC,Credit,<Amount>,<Currency>,<TransID>,(<RefNr>),<PayID>[,<FinishAuth>,<textfeld1>,<textfeld2>],<Status>,<Code>
CC,CreditEx,<Amount>,<Currency>,<TransID>,(<RefNr>),<CCBrand>,<CCNr|PCNr>,[<CCCVC>,]<CCExpiry>,<OrderDesc>[,<textfeld1>,<textfeld2>],<Status>,<Code>
CC,Reverse,<Amount>,<Currency>,<TransID>,(<RefNr>),<PayID>,<Status>,<Code>
FOOT,<CountRecords>,<SumAmount>

Example for batch versions:

Multiexcerpt

MultiExcerptName	batch_examples_response

Code Block

language	xml
title	Version 1.2

:

CC,Sale,<Amount>,<Currency>,<TransID>,(<RefNr>),<CCBrand>,<CCNr|PCNr>,<CCExpiry>,<OrderDesc>,<Status>,<Code>


CC,Sale,<Amount>,<Currency>,<TransID>,(<RefNr>),<CCBrand>,<CCNr|PCNr>,<CCExpiry>,<OrderDesc>,<textfeld1>,<textfeld2>,<RTF>,<cardholder>,<transactionID>,<schemeReferenceID>,<Status>,<Code>

Code Block

language	xml
title	Version 1.21

:

CC,Sale,<Amount>,<Currency>,<TransID>,(<RefNr>),<CCBrand>,<CCNr|PCNr>,<CCExpiry>,<OrderDesc>,<textfeld1>,<textfeld2>,<RTF>,<approvalcode>,<cardholder>,<transactionID>,<schemeReferenceID>,<Status>,<Code>

Code Block

language	xml
title	Version 1.3

:

CC,Sale,<Amount>,<Currency>,<TransID>,(<RefNr>),<CCBrand>,<CCNr|PCNr>,<CCCVC>,<CCExpiry>,<OrderDesc>,<textfeld1>,<textfeld2>,<transactionID>,<schemeReferenceID>,<Status>,<Code>

Code Block

language	xml
title	Version 1.5

:

CC,Sale,<Amount>,<Currency>,<TransID>,(<RefNr>),<CCBrand>,<CCNr|PCNr>,<CCCVC>,<CCExpiry>,<OrderDesc>,<Zone>,<Status>,<Code>

The following table describes the response parameters which the Batch Manager saves in the Record area for each transaction (standard parameters not explained here, such as <TransID> or <RefNR> and request parameters are returned unchanged and correspond to the call as specified before):

Table Filter

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

Multiexcerpt

MultiExcerptName	batch_response

Table Transformer

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

Key	Format	CND	Description	Beschreibung
Action	a..20	M	The parameter Action defines the type of transaction like capture or credit – see above.	Der Action-Parameter definiert die Art der Transaktion wie Capture (Buchung) oder Credit (Gutschrift) – siehe oben.

Table Excerpt Include

static	true
name	PayID
page	PayID
type	page

Key	Format	CND	Description	Beschreibung
Status	a..50	M	OK or FAILED	OK oder FAILED

Table Excerpt Include

static	true
name	Code
page	Code
type	page

Key	Format	CND	Description	Beschreibung
PCNr	n..16	C	The Pseudo Card Number is only returned in the case of transaction types Authorize or Sale & CreditEx. It starts with 0 and the last 3 digits correspond to those of the real card number.	Die Pseudo Card Number wird nur bei den Transaktionstypen Authorize oder Sale & CreditEx zurückgegeben. Sie beginnt mit 0, und die letzten 3 Stellen entsprechen denen der realen Kartennummer.

Description of result parameters within the record for Batch files

Cancel authorisation renewals

With a credit card authorisation you get the right to claim a payment. However an authorisation lasts only 30 days which is a problem if you capture a partial amount, for example as part payment for several partial shipments. In order to reproduce your payment request

Multiexcerpt include

SpaceWithExcerpt	ENWORK
MultiExcerptName	Platform-Kurz
PageWithExcerpt	Wording

can repeat an expired authorisation automatically.

If an order cannot be delivered or has been cancelled by the customer, it is very important that the automatic authorisations stop. Your customer's card limit will be otherwise reduced permanently because the

Multiexcerpt include

SpaceWithExcerpt	ENWORK
MultiExcerptName	Platform-Kurz
PageWithExcerpt	Wording

continues to charge your customer's card.

Under normal circumstances the

Multiexcerpt include

SpaceWithExcerpt	ENWORK
MultiExcerptName	Platform-Kurz
PageWithExcerpt	Wording

stops the automatic authorisation renewal when the authorised amount has been captured in full. In Batch version 1.4 you can also stop the authorisation renewal manually by changing the payment status. To perform this you submit a capture in your batch file whose amount is under the admissible limit. Since

Multiexcerpt include

SpaceWithExcerpt	ENWORK
MultiExcerptName	Platform-Kurz
PageWithExcerpt	Wording

refuses credit card captures below 1.00 euro, the payment status changes to FAILED in the case of lesser amounts.

Multiexcerpt include

SpaceWithExcerpt	ENWORK
MultiExcerptName	Platform-Kurz
PageWithExcerpt	Wording

therefore renews this authorisation no further. A corresponding capture entry of 0.05 euro’s is shown for example as follows:

CC,Capture,5,EUR,BestNr.0815,Rg.Nr.5180,a86dga4310d24453acd6f8a3112a769,y

Since the amount of 5 cents lies below the minimum amount of 1.00 euro,

Multiexcerpt include

SpaceWithExcerpt	ENWORK
MultiExcerptName	Platform-Kurz
PageWithExcerpt	Wording

refuses the capture with the error message MinValue. The payment status changes to FAILED and the authorisation renewal is stopped.

Space shortcuts

Page tree

Versions Compared

Old Version 3

New Version 4

Key

Capture / Credit / Reversal

Capture

Credit with reference

Credit without reference

Reversal

Reversal of an authorisation extension

Credit card payment via POS terminals

Reversal of POS credit card payments

PayNow

Silent Mode for credit cards with SSL and 3-D Secure method

Batch processing via the interface

Batch calls and answers

Cancel authorisation renewals

Paygate

Computop

Help

Intranet Tools

Space shortcuts

Page tree

Page History

Versions Compared

Old Version 3

New Version 4

Key

Capture / Credit / Reversal

Capture

Credit with reference

Credit without reference

Reversal

Reversal of an authorisation extension

Credit card payment via POS terminals

Reversal of POS credit card payments

PayNow

Silent Mode for credit cards with SSL and 3-D Secure method

Batch processing via the interface

Batch calls and answers

Cancel authorisation renewals