The scope of this documentation is to provide towards different POS partners the specifications of

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Platform-Name
PageWithExcerpt	Wording

POS API so that they can integrate and process POS payments towards different acquirer connections.

IMPORTANT: Based on the connection type desired i.e P2PE, VNP or SSL certain parameters will become mandatory and vice versa. The same also applies when specific payment methods are implemented such as SEPA ELV, CLV+ or Girocard or MTT ATB systems where additional data would be required from the standard request call.

For more detailed recommendation on the data requirement for specific products or integration types please get in touch with

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Partner-Name
PageWithExcerpt	Wording

team.

Multiexcerpt include
SpaceWithExcerpt EN
MultiExcerptName Platform-Kurz
PageWithExcerpt Wording
interface

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Definition
PageWithExcerpt	Definition EN

General terminal requests

The parameters listed here generally apply to all requests from a terminal to the

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Platform-Kurz
PageWithExcerpt	Wording

.

With the special payment method, you will find all parameters that apply to the respective payment method. Therefore, please note the description of the required payment method.
Some parameters are valid only for requests from certain areas: DCC: Dynamic Currency Conversion, MTT: Mass Transit Transaction.

In order to make a payment with POS Payment, please use the following URL:

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	BaseURL
PageWithExcerpt	Wording

posPayment.aspx

For the Integration test system, please use: https://dev.computop.de/Paygate/posPayment.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	1646660124750_-2095662974
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt

MultiExcerptName	POS_general_request

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1646660124753_369886467
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
MessageType	an2	M	Message type of request. Returned in response. For authorized values, see explanations in the appendix under Message Types.	Nachrichtentyp der Anfrage.Wird in der Antwort zurückgegeben.Autorisierte Werte finden Sie in den Erläuterungen im Anhang unter Nachrichtentypen.

Table Excerpt Include

static	true
name	MerchantID
page	MerchantID
type	page

Table Excerpt Include

static	true
name	TransID
page	TransID
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	RefNr
page	refnr
type	page

Key

Format

CND

Description

Beschreibung

Amount

n..10

M

Amount in the smallest currency unit (e.g. EUR Cent). Please contact the

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	Wording

, if you want to capture amounts <100 (smallest currency unit).

For DCC: Amount in foreign currency

For Cashback transactions this should contain the sum of payment amount and cashback amount.

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	DE:Wording

, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Für DCC: Betrag in Fremdwährung

Bei Cashback-Transaktionen sollte hier die Summe aus Zahlungsbetrag und Cashback-Betrag angegeben werden.

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	Currency
page	Currency
type	page

Table Excerpt Include

static	true
name	MAC
page	MAC
type	page

Key	Format	CND	Description	Beschreibung
POSTerminalID	an..20	M	TerminalID of the card reader	TerminalID des Kartenlesers
Device	an16	M	Serial number of the card reader	Seriennummer des Kartenlesers
Manufacturer	an..30	M	Manufacturer of the card reader (associated with the serial number)	Hersteller des Kartenlesers (verbunden mit der Seriennummer)
TerminalModel	..60	O	Model or type of card reader	Modell oder Typ des Kartenlesers
CCNr	n8.19	C	PAN of the card	PAN der Karte
CCBrand	an..22	M	Card brand or name of another payment method	Kartenmarke oder Name einer anderen Zahlungsmethode
EMVData	an..2048	C	Block for additional data. If there are no additional data, e.g. with MSR, then completely omit this parameter.	Block für Zusatzdaten.Wenn es keine Zusatzdaten gibt, z.B. bei MSR, dann lassen Sie diesen Parameter ganz weg.
OrderDesc	ans..200	O	Description of purchased goods, unit prices etc.	Beschreibung der gekauften Waren, Einzelpreise usw.
LocalDate	n4	C	The local month and day that the transaction takes place at the card acceptor location. The format is MMDD. Mandatory for SEPAELV, optional for others.	Der lokale Monat und Tag der Transaktion am Standort des Kartenakzeptors.Das Format ist MMTT.Obligatorisch für SEPAELV, optional für andere.
LocalTime	n6	C	The local time at which the transaction takes place at the point of card acceptor location. The format is hhmmss. Mandatory for SEPAELV, optional for others.	Die Ortszeit der Transaktion am Standort des Kartenakzeptors.Das Format ist hhmmss.Obligatorisch für SEPAELV, optional für andere.
ReceiptNr	n4	C	Mandatory for SEPAELV, Girocard transactions, optional for others. The value which terminals send the following format for ELV in BMP 3 (according to ZVTH): 38bbbb (bbbb = receipt number)	Obligatorisch für SEPAELV, Girocard-Transaktionen, optional für andere.Der Wert, den Terminals senden, hat für ELV in BMP 3 folgendes Format (gemäß ZVTH): 38bbbb (bbbb = Belegnummer)
ExtraCapabilities	an4	O	If a terminal supports additional skills such as Single Tap, each transaction must be marked with the appropriate terminal capability. Additional terminal capabilities (Terminal Capabilities) 0001 : Single Tap capable	Wenn ein Terminal zusätzliche Funktionen wie Single Tap unterstützt, muss jede Transaktion mit der entsprechenden Terminalfunktion gekennzeichnet werden. Zusätzliche Terminalfunktionen (Terminalfunktionen) 0001 : Single-Tap-fähig
DMACKSN	an..20	C	DUKPT Key Serial Number used to generate the DUKPT MAC (parameter DMAC). Mandatory for all devices except PhonePOS.	DUKPT-Schlüsselseriennummer, die zum Generieren des DUKPT-MAC (Parameter DMAC) verwendet wird.Obligatorisch für alle Geräte außer PhonePOS.
DMAC	an16	C	DUKPT Message Authentication Code, which is formed over the entire message (all parameters except DMAC). See chapter "Formation of the DUKPTMAC". Mandatory for all devices except PhonePOS.	DUKPT-Nachrichtenauthentifizierungscode, der über die gesamte Nachricht (alle Parameter außer DMAC) gebildet wird.Siehe Kapitel „Bildung des DUKPTMAC“.Obligatorisch für alle Geräte außer PhonePOS.

General parameters for terminal payments with POS Payment

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Response_Intro
PageWithExcerpt	Reuse API

Table Filter

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

Multiexcerpt

MultiExcerptName	POS_general_response

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1646660977734_1236696248
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
MessageType	an2	M	Message type transmitted in the request	In der Anfrage übermittelter Nachrichtentyp

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

isFirstTimeEnter	true
static	true
v	2
name	TransID
page	TransID
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	RefNr
page	refnr
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	Status_OK_FAILED
page	Status
type	page

Table Excerpt Include

static	true
name	Description
page	Description
type	page

Table Excerpt Include

static	true
name	Code
page	Code
type	page

Key	Format	CND	Description	Beschreibung
POSTerminalID	an..20	M	TerminalID of the card reader	TerminalID des Kartenlesers
EMVData	an..2048	C	Block for additional data	Block für zusätzliche Daten
ConfigUpdate	a3	O	If this parameter occurs in the response and has the value "yes", then there is an update of the terminal configuration. The update can then be retrieved via the posconfig.aspx.	Wenn dieser Parameter in der Antwort vorkommt und den Wert "yes" hat, dann liegt ein Update der Terminalkonfiguration vor.Das Update kann dann über die posconfig.aspx abgerufen werden.
DMACKSN	an..20	M	DUKPT Key Serial Number used to generate the DUKPT MAC (parameter DMAC)	DUKPT-Schlüsselseriennummer, die zum Generieren des DUKPT-MAC (Parameter DMAC) verwendet wird
DMAC	an16	M	DUKPT Message Authentication Code for the entire response	DUKPT-Nachrichtenauthentifizierungscode für die gesamte Antwort

General response parameters for terminal payments with POS Payment

Payments by credit card: reservation / booking

Some parameters are valid only for requests from certain areas: DCC: Dynamic Currency Conversion, MTT: Mass Transit Transaction.

In order to make a POS payment with credit card, please use the following URL:

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	BaseURL
PageWithExcerpt	Wording

posPayment.aspx

For the Integration test system, please use: https://dev.computop.de/Paygate/posPayment.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	1753872518990_-378932816
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt

MultiExcerptName	POS_creditcard_request

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1753872518992_-251979025
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
MessageType	an2	M	Message type of request. Returned in response. Allowed values: 01 for payment booking and 05 for reservation / authorization (Explanations in the appendix under Message Types)	Nachrichtentyp der Anfrage.Wird als Antwort zurückgegeben.Zulässige Werte: 01 für Zahlungsbuchung und 05 für Reservierung/Autorisierung (Erläuterungen im Anhang unter Nachrichtentypen)

Table Excerpt Include

static	true
name	MerchantID
page	MerchantID
type	page

Table Excerpt Include

static	true
name	TransID
page	TransID
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	RefNr
page	refnr
type	page

Key

Format

CND

Description

Beschreibung

Amount

n..10

M

Amount in the smallest currency unit (e.g. EUR Cent). Please contact the

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	Wording

, if you want to capture amounts <100 (smallest currency unit).

For DCC: Amount in foreign currency

For Cashback transactions this should contain the sum of payment amount and cashback amount.

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	DE:Wording

, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Für DCC: Betrag in Fremdwährung

Bei Cashback-Transaktionen sollte hier die Summe aus Zahlungsbetrag und Cashback-Betrag angegeben werden.

Key	Format	CND	Description	Beschreibung
CashbackAmount	n..10	O	Cashback Amount in case such transaction type is submitted. Given in the smallest currency unit (e.g. EUR Cent).	Cashback-Betrag, falls dieser Transaktionstyp übermittelt wird.Angegeben in der kleinsten Währungseinheit (z. B. EUR-Cent).

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	Currency
page	Currency
type	page

Table Excerpt Include

static	true
name	MAC
page	MAC
type	page

Key

Format

CND

Description

Beschreibung

POSTerminalID

an..20

M

TerminalID of the card reader

TerminalID des Kartenlesers

Device

an16

M

Serial number of the card reader

Seriennummer des Kartenlesers

Manufacturer

an..30

M

Manufacturer of the card reader (associated with the serial number)

Hersteller des Kartenlesers (verbunden mit der Seriennummer)

TerminalModel

..60

O

Model or type of card reader

Modell oder Typ des Kartenlesers

CCNr

n8.19

C

Mandatory if the credit card number is not passed in the DataEncrypted parameter

Pflicht, wenn die Kreditkartennummer nicht im Parameter DataEncrypted übergeben wird

CCBrand

an..22

M

Card brand: VISA, MasterCard, Maestro, AMEX, DINERS, JCB, CUP. Please note the spelling!
Always specify SEPAELV at ELV!

Kartenmarke: VISA, MasterCard, Maestro, AMEX, DINERS, JCB, CUP.Bitte auf die Schreibweise achten!
Bei ELV immer SEPAELV angeben!

CCCVC

n4

O

Card check number: The last 3 digits on the credit card sub-type, at AMEX 4 digits.

Kartenprüfnummer: Die letzten 3 Ziffern der Kreditkartenunterart, bei AMEX 4 Ziffern.

CCExpiry

n6

M

Expiration date of credit card (YYYYMM), e.g. 202507

Ablaufdatum der Kreditkarte (JJJJMM), zB 202507

CCSeqNo

n3

O

Card sequence number

Kartenfolgenummer

Track2

an..224

C

Mandatory with Magnetic Stripe Read (MSR). Data of the track2 for MSR or Track2EquivalentData (Tag 57) (in Hex formatting).

Obligatorisch beim Lesen von Magnetstreifen (MSR).Daten von Track2 für MSR oder Track2EquivalentData (Tag 57) (im Hex-Format).

EMVData

an..2048

C

EMC data as required for the passing on to the acquirer (in hex formatting). The exact structure is defined by the protocol used, which is stored in the master files of the terminal. If there are no EMC data, such as MSR, then completely omit this parameter.

EMC-Daten, wie sie für die Weitergabe an den Acquirer benötigt werden (im Hex-Format).Der genaue Aufbau wird durch das verwendete Protokoll vorgegeben, welches in den Stammdateien des Terminals hinterlegt ist. Wenn keine EMC-Daten, wie z.B. MSR, vorhanden sind, lassen Sie diesen Parameter ganz weg.

EntryMode

n3

M

POS entry mode

POS-Eingabemodus

PINData

an..128

C

Mandatory for online PIN. Encrypted PIN in ISO-0 format.

Pflicht für Online-PIN.Verschlüsselte PIN im ISO-0-Format.

PINKSN

an..20

C

Mandatory for online PIN. DUKPT Key Serial Number of the PIN.

Pflicht für Online-PIN. DUKPT-Schlüsselseriennummer der PIN.

DataEncrypted

an..2048

O

PAN + Track2 equivalent data (in TLV format) as encrypted value. If this field is present, the CCNr parameter is not required.

PAN + Track2-äquivalente Daten (im TLV-Format) als verschlüsselter Wert.Wenn dieses Feld vorhanden ist, ist der Parameter CCNr nicht erforderlich.

DataKSN

an..20

C

KSN is generated by the terminal. Needed to decrypt the data from the DataEncrypted parameter.

KSN wird vom Terminal generiert.Wird zum Entschlüsseln der Daten aus dem Parameter DataEncrypted benötigt.

OrderDesc

ans..200

O

Description of purchased goods, unit prices etc.

Beschreibung der gekauften Waren, Einzelpreise usw.

ChDesc

an..25

O

Text shown on the customer's credit card statement next to the payee

Text, der auf der Kreditkartenabrechnung des Kunden neben dem Zahlungsempfänger angezeigt wird

LocalDate

n4

C

The local month and day that the transaction takes place at the card acceptor location. The format is MMDD. Mandatory for SEPAELV, optional for others.

Der lokale Monat und Tag der Transaktion am Standort des Kartenakzeptors.Das Format ist MMTT. Pflicht für SEPAELV, optional für andere.

LocalTime

n6

C

The local time at which the transaction takes place at the point of card acceptor location. The format is hhmmss. Mandatory for SEPAELV, optional for others.

Die Ortszeit der Transaktion am Standort des Kartenakzeptors.Das Format ist hhmmss.Obligatorisch für SEPAELV, optional für andere.

ReceiptNr

n4

C

Mandatory for SEPAELV, Girocard transactions, optional for others. The value which terminals send the following format for ELV in BMP 3 (according to ZVTH): 38bbbb (bbbb = receipt number)

Obligatorisch für SEPAELV, Girocard-Transaktionen, optional für andere.Der Wert, den Terminals senden, hat für ELV in BMP 3 folgendes Format (gemäß ZVTH): 38bbbb (bbbb = Belegnummer)

dccStatus

a1

C

Mandatory for DCC; status of foreign currency settlement. Possible values: U foreign currency was used. E foreign currency was offered but not used.

Pflicht für DCC;Status der Fremdwährungsabrechnung.Mögliche Werte: U Fremdwährung wurde verwendet. E Fremdwährung wurde angeboten, aber nicht verwendet.

dccRateValue

ans13

C

Mandatory at DCC and dccStatus U; Exchange rate with decimal point

Pflicht bei DCC und dccStatus U;Wechselkurs mit Dezimalpunkt

baseAmount

n..10

C

Mandatory at DCC and dccStatus U; Amount in the smallest currency unit in Terminal currency

Pflicht bei DCC und dccStatus U; Betrag in der kleinsten Währungseinheit in Terminalwährung

baseCurrency

a3

C

Mandatory at DCC and dccStatus U; Currency set up at the terminal as standard

Pflicht bei DCC und dccStatus U; Am Terminal standardmäßig ingestellte Währung

dccMargin

ans..5

O

DCC margin/markup percentage

DCC-Marge/Aufschlag in Prozent

dccCommission

ans..12

O

DCC commission percentage

DCC-Provisionssatz in Prozent

dccSource

ans..32

O

Exchange rate source (e.g., "REUTERS WHOLESALE INTERBANK")

Wechselkursquelle (z. B. „REUTERS WHOLESALE INTERBANK“)

dccTimestamp

ans..20

O

Timestamp of exchange rate

Zeitstempel des Wechselkurses

dccRequestId

an..32

O

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Partner-Name
PageWithExcerpt	Wording

PayID of the DCC request (enables linking DCC and POS payment records)

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Partner-Name
PageWithExcerpt	DE:Wording

PayID der DCC-Anfrage (ermöglicht die Verknüpfung von DCC- und POS-Zahlungsdatensätzen)

ContractID

n..8

O

Additional contract number of the merchant with the acquirer, with which the default VU number can be overridden

Zusätzliche Vertragsnummer des Händlers mit dem Acquirer, mit der die Standard-VU-Nummer überschrieben werden kann

AccVerify

a..3

O

Allowed value: yes
If this parameter is transmitted, an account verification (Zero Value Account Verification) is executed. In this case, the parameters amount and currency are optional. The amount can be zero.

Zulässiger Wert: yes
Wenn dieser Parameter übermittelt wird, wird eine Kontoverifizierung (Zero Value Account Verification) durchgeführt.In diesem Fall sind die Parameter Amount und Currency optional.Der Betrag kann Null sein.

RTF

an1

O

For recurring payments. Allowed values: I (initial payment of a new subscription) or E (agreement that COF is used for further payments).

Für wiederkehrende Zahlungen.Erlaubte Werte: I (Anfangszahlung eines neuen Abonnements) oder E (Vereinbarung, dass COF für weitere Zahlungen verwendet wird).

PACFormat

n2

O

Defines the ISO PIN format present in PINData parameter. Valid values:

10: ISO-0

11: ISO-1

14: ISO-4

If this value is not set than ISO-0 is taken as the default one.

Definiert das im Parameter PINData vorhandene ISO-PIN-Format.Gültige Werte:

10: ISO-0

11: ISO-1

14: ISO-4

Wenn dieser Wert nicht festgelegt ist, wird ISO-0 als Standard verwendet.

ExtraCapabilities

an4

O

If a terminal supports additional skills such as Single Tap, each transaction must be marked with the appropriate terminal capability.

Additional terminal capabilities (Terminal Capabilities)
0001 : Single Tap capable

Wenn ein Terminal zusätzliche Funktionen wie Single Tap unterstützt, muss jede Transaktion mit der entsprechenden Terminalfunktion gekennzeichnet werden.

Zusätzliche Terminalfunktionen (Terminalfunktionen)
0001 : Single-Tap-fähig

DuplicateATC

a3

C

Mandatory if the same ATC is used for a second request during a payment process. This procedure is described for the single-tap process. As a rule, any further request with the same ATC is rejected by the acquirer or issuer. However, the single-tap process intended to repeat the ATC and must therefore be marked with this parameter.

yes : The same ATC was sent intended

Pflicht, wenn derselbe ATC für eine zweite Anfrage während eines Zahlungsvorgangs verwendet wird.Dieses Verfahren ist für das Single-Tap-Verfahren beschrieben.Jede weitere Anfrage mit demselben ATC wird in der Regel vom Acquirer oder Issuer abgelehnt.Das Single-Tap-Verfahren dient jedoch der Wiederholung des ATC und muss daher mit diesem Parameter gekennzeichnet werden.

yes : Derselbe ATC wurde absichtlich gesendet

DMACKSN

an..20

C

DUKPT Key Serial Number used to generate the DUKPT MAC (parameter DMAC). Mandatory for all devices except PhonePOS.

DUKPT-Schlüsselseriennummer, die zum Generieren des DUKPT-MAC (Parameter DMAC) verwendet wird.Obligatorisch für alle Geräte außer PhonePOS.

DMAC

an16

C

DUKPT Message Authentication Code, which is formed over the entire message (all parameters except DMAC). See chapter "Formation of the DUKPTMAC". Mandatory for all devices except PhonePOS.

DUKPT-Nachrichtenauthentifizierungscode, der über die gesamte Nachricht (alle Parameter außer DMAC) gebildet wird.Siehe Kapitel „Bildung des DUKPTMAC“.Obligatorisch für alle Geräte außer PhonePOS.

dccRateID

ans..20

O

Fiserv IPG-Rate. Only required in case of a DCC service via Fiserv.

Fiserv IPG-Rate.Nur erforderlich bei einem DCC-Dienst über Fiserv.

TraceNr

an..6

C

A number assigned by a terminal to identify uniquely a transaction. Mandatory for SEPAELV and girocard transactions, optional for others.

Eine vom Terminal vergebene Nummer zur eindeutigen Identifizierung einer Transaktion. Pflicht für SEPAELV- und girocard-Transaktionen, optional für andere.

ConditionCode

an..2

C

Additional information for transaction, to be communicated with CLV+ end. Mandatory for SEPAELV and girocard transactions, optional for others.

Zusätzliche Informationen zur Transaktion, die mit CLV+-Ende kommuniziert werden müssen. Pflicht für SEPAELV- und girocard-Transaktionen, optional für andere.

Parameters for POS payments with credit card

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Response_Intro
PageWithExcerpt	Reuse API

Table Filter

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

Multiexcerpt

MultiExcerptName	POS_creditcard_response

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1753872538463_-528097238
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
MessageType	an2	M	Message type transmitted in the request	In der Anfrage übermittelter Nachrichtentyp

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

isFirstTimeEnter	true
static	true
v	2
name	TransID
page	TransID
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	RefNr
page	refnr
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	Status_OK_FAILED
page	Status
type	page

Table Excerpt Include

static	true
name	Description
page	Description
type	page

Table Excerpt Include

static	true
name	Code
page	Code
type	page

Key

Format

CND

Description

Beschreibung

POSTerminalID

an..20

M

TerminalID of the card reader

TerminalID des Kartenlesers

CodeExt

an2

M

Response code of the acquirer

Antwortcode des Acquirers

ApprovalCode

n..6

C

Approval code of the acquirer (also known as the authCode or authorization . called Response). Configured at the merchant.

Freigabecode des Acquirers (auch AuthCode oder Autorisierungscode, auch Response genannt). Ist beim Händler konfiguriert.

EMVData

an..2048

C

Acquirer Response (in hex formatting). Includes, among other things, the Issuer Authorization Response Code (Tag 8A), the Issuer Scripts (Tag 71, 72) and Issuer Authentication Data (Tag 91).

Acquirer-Antwort (im Hex-Format).Enthält unter anderem den Issuer Authorization Response Code (Tag 8A), die Issuer Scripts (Tag 71, 72) und Issuer Authentication Data (Tag 91).

VUNr

ans..20

O

Contract number of the merchant with the acquirer. Configured at the merchant.

Vertragsnummer des Händlers mit dem Acquirer. Ist beim Händler konfiguriert.

TerminalID

ans..20

O

TerminalID, which

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Partner-Name
PageWithExcerpt	Wording

exchanges with the acquirer. Configured at the merchant.

TerminalID, die

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Partner-Name
PageWithExcerpt	DE:Wording

mit dem Acquirer austauscht. Ist beim Händler konfiguiert.

AQ

ans..30

O

Abbreviation of the acquirers. Configured at the merchant.

Abkürzung der Acquirer. Ist beim Händler konfiguriert.

TrxTime

ans21

O

Time of execution of the transaction in format: dd.MM.yyyy HH:mm:ssff. Configured at the merchant.

Ausführungszeitpunkt der Transaktion im Format: tt.MM.jjjj HH:mm:ssff. Ist beim Händler konfiguriert.

AdditionalResponseData

ans..99

O

Additional Response Data (at GICC BMP 44), which the acquirer sends in the response. Configured at the merchant.

Zusätzliche Antwortdaten (bei GICC BMP 44), die der Acquirer in der Antwort sendet. Ist beim Händler konfiguriert.

PCNr

n..16

O

Pseudo card number:

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Platform-Kurz
PageWithExcerpt	Wording

generated random number, which represents a real credit card number. The pseudocard number (PKN) starts with 0, and the last 3 digits correspond to those of the real card number. PKN can be used as a real card number for authorization, booking and credits.

Pseudokartennummer: Vom

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Platform-Kurz
PageWithExcerpt	DE:Wording

generierte Zufallszahl, die eine echte Kreditkartennummer darstellt.Die Pseudokartennummer (PKN) beginnt mit 0 und die letzten 3 Ziffern entsprechen denen der echten Kartennummer.Die PKN kann als echte Kartennummer für Autorisierung, Buchung und Gutschriften verwendet werden.

TransactionID

an..56

C

Value returned in response to an initial recurring payment (RTF-I or E)

Als Antwort auf eine erste wiederkehrende Zahlung zurückgegebener Wert (RTF-I oder E)

ConfigUpdate

a3

O

If this parameter occurs in the response and has the value "yes", then there is an update of the terminal configuration. The update can then be retrieved via the posconfig.aspx.

Wenn dieser Parameter in der Antwort vorkommt und den Wert "yes" hat, dann liegt ein Update der Terminalkonfiguration vor.Das Update kann dann über die posconfig.aspx abgerufen werden.

Last4CardholderPAN

n..4

O

MTT only: The last 4 digits of the printed PAN at VISA if the tokenized DPAN was used in the request

Nur MTT: Die letzten 4 Ziffern der gedruckten PAN bei VISA, wenn die tokenisierte DPAN in der Anfrage verwendet wurde

PAR

ans..999

O

Only MTT: Payment Account Reference, which VISA/MasterCard makes available to the merchant to identify a customer in their back office system

Nur MTT: Payment Account Reference, die VISA/MasterCard dem Händler zur Identifizierung eines Kunden in seinem Backoffice-System zur Verfügung stellt

EmbossedPANPCNr

n..19

O

MTT and MasterCard/Maestro only: Another Pseudo Card Number (s. Parameter PCNr), which refers to the printed PAN of the physical card. Included in the Acquirer response if a tokenized PAN was used in the request.

Nur MTT und MasterCard/Maestro: Eine weitere Pseudo-Kartennummer (s. Parameter PCNr), die sich auf die aufgedruckte PAN der physischen Karte bezieht. Ist in der Acquirer-Antwort enthalten, wenn in der Anfrage eine tokenisierte PAN verwendet wurde.

EmbossedPANExpiryDate

n..4

O

MTT and MasterCard/Maestro only: The expiration date belonging to the Embossed PAN parameter, which is included in the Acquirer response. Format: YYMM.

Nur MTT und MasterCard/Maestro: Das Ablaufdatum des Parameters Embossed PAN, der in der Acquirer-Antwort enthalten ist.Format: JJMM.

OriginalCode

ans..3

O

MTT only: Contains the original Response Code (OmniPay BM 60 SF68: Scheme Response Code) from the authorization platforms for payment systems

Nur MTT: Enthält den originalen Antwort-Code (OmniPay BM 60 SF68: Scheme Response Code) der Autorisierungsplattformen für Zahlungssysteme

schemeReferenceID

ans..64

O

MTT only: Cardmark-specific transaction ID required for subsequent card on file payments, delayed authorizations and resubmission.

Nur MTT: Für nachfolgende Zahlungen mit hinterlegten Karten, verzögerte Autorisierungen und erneute Übermittlungen ist eine kartenmarken-spezifische Transaktions-ID erforderlich.

DMACKSN

an..20

M

DUKPT Key Serial Number used to generate the DUKPT MAC (parameter DMAC)

DUKPT-Schlüsselseriennummer, die zum Generieren des DUKPT-MAC (Parameter DMAC) verwendet wird

DMAC

an16

M

DUKPT Message Authentication Code for the entire response

DUKPT-Nachrichtenauthentifizierungscode für die gesamte Antwort

Response parameters for POS payments with credit card

Booking notification (Capture)

Some parameters are valid only for requests from certain areas: DCC: Dynamic Currency Conversion, MTT: Mass Transit Transaction.

In order to capture a POS payment, please use the following URL:

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	BaseURL
PageWithExcerpt	Wording

posPayment.aspx

For the Integration test system, please use: https://dev.computop.de/Paygate/posPayment.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	1753885701226_1967701313
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt

MultiExcerptName	POS_capture_request

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1753885701229_1954718142
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
MessageType	an2	M	Message type of request. Returned in response. Allowed values: 0B for Booking Notification (Explanations in the appendix under Message Types)	Nachrichtentyp der Anfrage.Wird als Antwort zurückgegeben.Zulässige Werte: 0B für Buchungsbenachrichtigung (Erläuterungen im Anhang unter Nachrichtentypen)

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

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	RefNr
page	refnr
type	page

Key

Format

CND

Description

Beschreibung

Amount

n..10

M

Amount in the smallest currency unit (e.g. EUR Cent). Please contact the

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	Wording

, if you want to capture amounts <100 (smallest currency unit).

For DCC: Amount in foreign currency

For Cashback transactions this should contain the sum of payment amount and cashback amount.

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	DE:Wording

, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Für DCC: Betrag in Fremdwährung

Bei Cashback-Transaktionen sollte hier die Summe aus Zahlungsbetrag und Cashback-Betrag angegeben werden.

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	Currency
page	Currency
type	page

Table Excerpt Include

static	true
name	MAC
page	MAC
type	page

Key	Format	CND	Description	Beschreibung
POSTerminalID	an...20	M	TerminalID of the card reader	TerminalID des Kartenlesers
Device	an16	M	Serial number of the card reader	Seriennummer des Kartenlesers
Manufacturer	an..30	M	Manufacturer of the card reader (associated with the serial number)	Hersteller des Kartenlesers (verbunden mit der Seriennummer)
TerminalModel	..60	O	Model or type of card reader	Modell oder Typ des Kartenlesers
LocalDate	n4	M	The local month and day that the transaction takes place at the card acceptor location. The format is MMDD. Mandatory for SEPAELV, optional for others.	Der lokale Monat und Tag der Transaktion am Standort des Kartenakzeptors.Das Format ist MMTT. Pflicht für SEPAELV, optional für andere.
LocalTime	n6	M	The local time at which the transaction takes place at the point of card acceptor location. The format is hhmmss. Mandatory for SEPAELV, optional for others.	Die Ortszeit der Transaktion am Standort des Kartenakzeptors.Das Format ist hhmmss.Obligatorisch für SEPAELV, optional für andere.
DMACKSN	an..20	C	DUKPT Key Serial Number used to generate the DUKPT MAC (parameter DMAC). Mandatory for all devices except PhonePOS.	DUKPT-Schlüsselseriennummer, die zum Generieren des DUKPT-MAC (Parameter DMAC) verwendet wird.Obligatorisch für alle Geräte außer PhonePOS.
DMAC	an16	C	DUKPT Message Authentication Code, which is formed over the entire message (all parameters except DMAC). See chapter "Formation of the DUKPTMAC". Mandatory for all devices except PhonePOS.	DUKPT-Nachrichtenauthentifizierungscode, der über die gesamte Nachricht (alle Parameter außer DMAC) gebildet wird.Siehe Kapitel „Bildung des DUKPTMAC“.Obligatorisch für alle Geräte außer PhonePOS.

Parameters for captures of POS payments

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Response_Intro
PageWithExcerpt	Reuse API

Table Filter

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

Multiexcerpt

MultiExcerptName	POS_capture_response

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1753885747636_756022292
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
MessageType	an2	M	Message type transmitted in the request	In der Anfrage übermittelter Nachrichtentyp

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

isFirstTimeEnter	true
static	true
v	2
name	TransID
page	TransID
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	RefNr
page	refnr
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	Status_OK_FAILED
page	Status
type	page

Table Excerpt Include

static	true
name	Description
page	Description
type	page

Table Excerpt Include

static	true
name	Code
page	Code
type	page

Key	Format	CND	Description	Beschreibung
POSTerminalID	an...20	M	TerminalID of the card reader	TerminalID des Kartenlesers
ConfigUpdate	a3	O	If this parameter occurs in the response and has the value "yes", then there is an update of the terminal configuration. The update can then be retrieved via the posconfig.aspx.	Wenn dieser Parameter in der Antwort vorkommt und den Wert "yes" hat, dann liegt ein Update der Terminalkonfiguration vor.Das Update kann dann über die posconfig.aspx abgerufen werden.
DMACKSN	an..20	M	DUKPT Key Serial Number used to generate the DUKPT MAC (parameter DMAC)	DUKPT-Schlüsselseriennummer, die zum Generieren des DUKPT-MAC (Parameter DMAC) verwendet wird
DMAC	an16	M	DUKPT Message Authentication Code for the entire response	DUKPT-Nachrichtenauthentifizierungscode für die gesamte Antwort

Response parameters for captures of POS payments

Payments as SEPA-ELV

For parameters see section Credit card payment.
Important: The parameter CCBrand must be assigned the value SEPAELV.

Payments by girocard

Some parameters are valid only for requests from certain areas: DCC: Dynamic Currency Conversion, MTT: Mass Transit Transaction.

In order to make a POS payment with girocard, please use the following URL:

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	BaseURL
PageWithExcerpt	Wording

posPayment.aspx

For the Integration test system, please use: https://dev.computop.de/Paygate/posPayment.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	1753885850952_-741085171
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt

MultiExcerptName	POS_girocard_request

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1753885850954_1198436733
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
MessageType	an2	M	Message type of request. Returned in response. Allowed values: 01 for authorization and automated booking (Explanations in the appendix under Message Types)	Nachrichtentyp der Anfrage.Wird als Antwort zurückgegeben.Zulässige Werte: 01 für Autorisierung und automatisierte Buchung (Erläuterungen im Anhang unter Nachrichtentypen)
ProcessMode	an2	M	Possible values: 00: Offline 01: Online 0E: Emergency Offline (terminal is not connected to accept server) EC: Emergengy in EC network operation	Mögiche Werte: 00: Offline 01: Online 0E: Notfall offline (Terminal ist nicht mit dem Empfangsserver verbunden) EC: Notfall im EC-Netzwerkbetrieb

Table Excerpt Include

static	true
name	MerchantID
page	MerchantID
type	page

Table Excerpt Include

static	true
name	TransID
page	TransID
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	RefNr
page	refnr
type	page

Key

Format

CND

Description

Beschreibung

Amount

n..10

M

Amount in the smallest currency unit (e.g. EUR Cent). Please contact the

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	Wording

, if you want to capture amounts <100 (smallest currency unit).

For DCC: Amount in foreign currency

For Cashback transactions this should contain the sum of payment amount and cashback amount.

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	DE:Wording

, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Für DCC: Betrag in Fremdwährung

Bei Cashback-Transaktionen sollte hier die Summe aus Zahlungsbetrag und Cashback-Betrag angegeben werden.

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	Currency
page	Currency
type	page

Table Excerpt Include

static	true
name	MAC
page	MAC
type	page

Key	Format	CND	Description	Beschreibung
POSTerminalID	an...20	M	TerminalID of the card reader	TerminalID des Kartenlesers
Device	an16	M	Serial number of the card reader	Seriennummer des Kartenlesers
Manufacturer	an..30	M	Manufacturer of the card reader (associated with the serial number)	Hersteller des Kartenlesers (verbunden mit der Seriennummer)
TerminalModel	..60	O	Model or type of card reader	Modell oder Typ des Kartenlesers
CCNr	n8.19	M	PAN of the girocard	PAN der Girocard
CCBrand	an...22	M	Fixed value: girocard	Fester Wert: girocard
CCExpiry	n6	M	Expiration date of girocard (YYYYMM), e.g. 202507	Ablaufdatum der girocard (JJJJMM), z.B.202507
CCSeqNr	n3	O	Card sequence number	Kartenfolgenummer
Track2	an..224	M	Obligation to authorise or emergency operation. Data of the track2 for MSR or Track2EquivalentData (Tag 57) (in Hex formatting).	Autorisierungspflicht bzw. Notbetrieb.Daten des Track2 für MSR bzw. Track2EquivalentData (Tag 57) (im Hex-Format).
EMVData	an..2048	C	EMC data as required for the continuation to the headend (in hex formatting). The exact structure is defined by the protocol used, which is stored in the master files of the terminal. If there are no EMC data, such as MSR, then completely omit this parameter.	EMC-Daten, wie sie für die Weitergabe zum Headend benötigt werden (im Hex-Format).Der genaue Aufbau wird durch das verwendete Protokoll vorgegeben, welches in den Stammdateien des Terminals hinterlegt ist. Wenn keine EMC-Daten, wie z.B. MSR, vorhanden sind, lassen Sie diesen Parameter ganz weg.
EntryMode	n3	M	POS entry mode	POS-Eingabemodus
PINData	an..128	C	Mandatory for online PIN. Encrypted PIN in ISO-1 format.	Pflicht für Online-PIN.Verschlüsselte PIN im ISO-0-Format.
PINKSN	an..20	C	Mandatory for online PIN. DUKPT Key Serial Number of the PIN.	Pflicht für Online-PIN. DUKPT-Schlüsselseriennummer der PIN.
OrderDesc	ans..200	O	Description of purchased goods, unit prices etc.	Beschreibung der gekauften Waren, Einzelpreise usw.
LocalDate	n4	M	Date of the transaction. Format: MMTT	Datum der Transaktion.Format: MMTT
LocalTime	n6	M	Time of the transaction. Format: hhmmss	Uhrzeit der Transaktion.Format: hhmmss
ReceiptNr	n4	M	Number for the document. Will be continuously increased. Overflow to 9999.	Nummer für das Dokument.Wird fortlaufend erhöht.Überlauf bis 9999.
TerminalData	an...99	M	Terminal data includes: online time, POS data and approval number of the terminal. Format: Hex, TLV-coded (see also TA BMP 61).	Zu den Terminaldaten zählen: Onlinezeit, POS-Daten und Zulassungsnummer des Terminals.Format: Hex, TLV-kodiert (siehe auch TA BMP 61).
ConditionCode	n2	C	Condition code. Values from 00 to 99 as described in TA under BMP 25.	Bedingungscode.Werte von 00 bis 99 wie in TA unter BMP 25 beschrieben.
TraceNr	n6	M	Continuous 6-digit decimal. Is incremented for each transaction as described in TA.	Fortlaufende 6-stellige Dezimalzahl.Wird für jede Transaktion wie in TA beschrieben erhöht.
PACFormat	n2	O	Defines the PIN ISO format used. 10: ISO-0 11: ISO-1 At girocard, the PIN ISO 1 format is allowed.	Definiert das verwendete PIN-ISO-Format.10: ISO-0 11: ISO-1 Bei girocard ist das PIN-Format ISO 1 zulässig.
ExtraCapabilities	an4	O	If a terminal supports additional skills such as Single Tap, each transaction must be marked with the appropriate terminal capability. Additional terminal capabilities (Terminal Capabilities) 0001 : Single Tap capable	Wenn ein Terminal zusätzliche Funktionen wie Single Tap unterstützt, muss jede Transaktion mit der entsprechenden Terminalfunktion gekennzeichnet werden. Zusätzliche Terminalfunktionen (Terminalfunktionen) 0001 : Single-Tap-fähig
DMACKSN	an...20	C	DUKPT Key Serial Number used to generate the DUKPT MAC (parameter DMAC). Mandatory for all devices except PhonePOS.	DUKPT-Schlüsselseriennummer, die zum Generieren des DUKPT-MAC (Parameter DMAC) verwendet wird.Obligatorisch für alle Geräte außer PhonePOS.
DMAC	an16	C	DUKPT Message Authentication Code, which is formed over the entire message (all parameters except DMAC). See chapter "Formation of the DUKPTMAC". Mandatory for all devices except PhonePOS.	DUKPT-Nachrichtenauthentifizierungscode, der über die gesamte Nachricht (alle Parameter außer DMAC) gebildet wird.Siehe Kapitel „Bildung des DUKPTMAC“.Obligatorisch für alle Geräte außer PhonePOS.

Parameters for POS payments with girocard

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Response_Intro
PageWithExcerpt	Reuse API

Table Filter

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

Multiexcerpt

MultiExcerptName	POS_girocard_response

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1753885875348_628702407
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
MessageType	an2	M	Message type transmitted in the request	In der Anfrage übermittelter Nachrichtentyp

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

isFirstTimeEnter	true
static	true
v	2
name	TransID
page	TransID
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	RefNr
page	refnr
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	Status_OK_FAILED
page	Status
type	page

Table Excerpt Include

static	true
name	Description
page	Description
type	page

Table Excerpt Include

static	true
name	Code
page	Code
type	page

Key	Format	CND	Description	Beschreibung
POSTerminalID	an...20	M	TerminalID of the card reader	TerminalID des Kartenlesers
CodeExt	an2	M	Response code of the acquirer	Antwortcode des Acquirers
ApprovalCode	n..6	C	Approval code from the acquirer (also known as AuthCode or Authorisation ID. called Response). Configured at the merchant.	Freigabecode des Acquirers (auch AuthCode oder Autorisierungs-ID, Response genannt). Ist beim Händler konfiguriert.
EMVData	an..2048	C	Response headroom (in hex formatting). Includes, among other things, the Issuer Authorization Response Code (Tag 8A), the Issuer Scripts (Tag 71, 72) and Issuer Authentication Data (Tag 91)	Antwort-Headroom (im Hex-Format).Enthält unter anderem den Issuer Authorization Response Code (Tag 8A), die Issuer Scripts (Tag 71, 72) und Issuer Authentication Data (Tag 91)
ConfigUpdate	a3	O	If this parameter occurs in the response and has the value "yes", then there is an update of the terminal configuration. The update can then be retrieved via the posconfig.aspx.	Wenn dieser Parameter in der Antwort vorkommt und den Wert "yes" hat, dann liegt ein Update der Terminalkonfiguration vor.Das Update kann dann über die posconfig.aspx abgerufen werden.
DMACKSN	an..20	M	DUKPT Key Serial Number used to generate the DUKPT MAC (parameter DMAC)	DUKPT-Schlüsselseriennummer, die zum Generieren des DUKPT-MAC (Parameter DMAC) verwendet wird
DMAC	an16	M	DUKPT Message Authentication Code for the entire response	DUKPT-Nachrichtenauthentifizierungscode für die gesamte Antwort

Response parameters for POS payments with girocard

Payments with Alipay / Wechat

Payments can be made at the terminal via Alipay and Wechat. Some parameters are valid only for requests from certain areas: DCC: Dynamic Currency Conversion, MTT: Mass Transit Transaction.

In order to make a POS payment with Alipay or Wechat, please use the following URL:

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	BaseURL
PageWithExcerpt	Wording

posPayment.aspx

For the Integration test system, please use: https://dev.computop.de/Paygate/posPayment.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	1753885895238_1265890583
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt

MultiExcerptName	POS_alipay_request

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1753885895239_-532845184
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
MessageType	an2	M	Message type of request. Returned in response. Allowed values: 01 (Explanations in the appendix under Message Types)	Nachrichtentyp der Anfrage.Wird als Antwort zurückgegeben.Zulässige Werte: 01 (Erläuterungen im Anhang unter Nachrichtentypen)

Table Excerpt Include

static	true
name	MerchantID
page	MerchantID
type	page

Table Excerpt Include

static	true
name	TransID
page	TransID
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	RefNr
page	refnr
type	page

Key

Format

CND

Description

Beschreibung

Amount

n..10

M

Amount in the smallest currency unit (e.g. EUR Cent). Please contact the

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	Wording

, if you want to capture amounts <100 (smallest currency unit).

For DCC: Amount in foreign currency

For Cashback transactions this should contain the sum of payment amount and cashback amount.

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	DE:Wording

, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Für DCC: Betrag in Fremdwährung

Bei Cashback-Transaktionen sollte hier die Summe aus Zahlungsbetrag und Cashback-Betrag angegeben werden.

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	Currency
page	Currency
type	page

Key	Format	CND	Description	Beschreibung
POSTerminalID	an..20	M	TerminalID of the card reader	TerminalID des Kartenlesers
Device	an16	M	Serial number of the card reader	Seriennummer des Kartenlesers
Manufacturer	an..30	M	Manufacturer of the card reader (associated with the serial number)	Hersteller des Kartenlesers (verbunden mit der Seriennummer)
TerminalModel	..60	O	Model or type of card reader	Modell oder Typ des Kartenlesers
CCNr	n8.19	M	Not required for Alipay / Wechat. Please pass 0000000000000000 (16 x 0), because mandatory.	Für Alipay/Wechat nicht erforderlich.Bitte übergeben Sie 0000000000000000 (16 x 0), da obligatorisch.
CCBrand	an..22	M	At Alipay please always include, at Wechat always show Wechat!	Bei Alipay bitte immer angeben, bei Wechat immer Wechat anzeigen!
OrderDesc	ans..200	O	Description of purchased goods, unit prices etc.	Beschreibung der gekauften Waren, Einzelpreise usw.
ContractID	n..8	O	Additional contract number of the merchant with the acquirer, with which the default VU number can be overridden	Zusätzliche Vertragsnummer des Händlers mit dem Acquirer, mit der die Standard-VU-Nummer überschrieben werden kann
DMACKSN	an..20	C	DUKPT Key Serial Number used to generate the DUKPT MAC (parameter DMAC). Mandatory for all devices except PhonePOS.	DUKPT-Schlüsselseriennummer, die zum Generieren des DUKPT-MAC (Parameter DMAC) verwendet wird.Obligatorisch für alle Geräte außer PhonePOS.
DMAC	an16	C	DUKPT Message Authentication Code, which is formed over the entire message (all parameters except DMAC). See chapter "Formation of the DUKPTMAC". Mandatory for all devices except PhonePOS.	DUKPT-Nachrichtenauthentifizierungscode, der über die gesamte Nachricht (alle Parameter außer DMAC) gebildet wird.Siehe Kapitel „Bildung des DUKPTMAC“.Obligatorisch für alle Geräte außer PhonePOS.

Parameters for POS payments with Alipay or Wechat

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Response_Intro
PageWithExcerpt	Reuse API

Table Filter

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

Multiexcerpt

MultiExcerptName	POS_alipay_response

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1753885915218_1067745760
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
MessageType	an2	M	Message type transmitted in the request	In der Anfrage übermittelter Nachrichtentyp

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

isFirstTimeEnter	true
static	true
v	2
name	TransID
page	TransID
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	RefNr
page	refnr
type	page

Key

Format

CND

Description

Beschreibung

POSTerminalID

an..20

M

TerminalID of the card reader

TerminalID des Kartenlesers

Status

a..50

M

AUTHORIZE-REQUEST or FAILED

AUTHORIZE-REQUEST oder FAILED

Description

ans..1024

M

PENDING, because the approval of Alipay / Wechat is still waiting. Further description if the payment is rejected. Please do not use the Description but the Code parameter for the transaction status analysis!

PENDING, da die Freigabe von Alipay / Wechat noch aussteht.Nähere Beschreibung falls die Zahlung abgelehnt wird. Bitte nutzen Sie nicht den Parameter Description, sondern Code für die Auswertung des Transaktionsstatus!

Code

n8

M

If a valid QR code can be submitted, then 21190985 or 23030985 for PENDING otherwise error code according to

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Platform-Kurz
PageWithExcerpt	Wording

Response Codes (A4 Error codes)

Wenn ein gültiger QR-Code übermittelt werden kann, dann 21190985 oder 23030985 für PENDING, andernfalls Fehlercode gemäß

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Platform-Kurz
PageWithExcerpt	DE:Wording

-Antwortcodes (A4 Fehlercodes)

EMVData

an..2048

C

Value for the QR code in JSON format additionally base64-viren. Examples:
a) Alipay
ew0KCSJxCNvZSPiOiAHR0cHM6Ly9xci5hbGlwYXkuY29tL28JheDAwMTNo25tbW5XNiMDBlNiINCn0

b) Wechat eyJxCMNvZGUiOiJ3Zl4AW46Ly93eHHeS9iaXpwYXl1cmw/cHI9U0pwclkwWSJ9

base64-decoded:
a) Ã "qrcode":"https://qr.alipay.com/bax009917nmmndisb00e6", "tradeÃ3no:"1234567890123456"

b) Ã "qrcode":"weixin://wxpay/bizpayurl? pr-SJprY0Y"

Wert für den QR-Code im JSON-Format zusätzlich base64-viren.Beispiele:
a) Alipay
ew0KCSJxCNvZSPiOiAHR0cHM6Ly9xci5hbGlwYXkuY29tL28JheDAwMTNo25tbW5XNiMDBlNiINCn0

b) Wechat eyJxCMNvZGUiOiJ3Zl4AW46Ly93eHHeS9iaXpwYXl1cmw/cHI9U0pwclkwWSJ9

base64-dekodiert:
a) Ã "qrcode":"https://qr.alipay.com/bax009917nmmndisb00e6", "tradeÃ3no:"1234567890123456"

b) Ã "qrcode":"weixin://wxpay/bizpayurl? pr-SJprY0Y"

ConfigUpdate

a3

O

If this parameter occurs in the response and has the value "yes", then there is an update of the terminal configuration. The update can then be retrieved via the posconfig.aspx.

Wenn dieser Parameter in der Antwort vorkommt und den Wert "yes" hat, dann liegt ein Update der Terminalkonfiguration vor.Das Update kann dann über die posconfig.aspx abgerufen werden.

VUNr

ans..20

M

PartnerID of the merchant

PartnerID des Händlers

DMACKSN

an..20

M

DUKPT Key Serial Number used to generate the DUKPT MAC (parameter DMAC)

DUKPT-Schlüsselseriennummer, die zum Generieren des DUKPT-MAC (Parameter DMAC) verwendet wird

DMAC

an16

M

DUKPT Message Authentication Code for the entire response

DUKPT-Nachrichtenauthentifizierungscode für die gesamte Antwort

Response parameters for POS payments with Alipay or Wechat

Status checking by the terminal

Repeatedly calling the pospayment.aspx (Polling, MessageType F1) determines whether the operation has been approved in Alipay / Wechat. For this purpose, it is necessary to check whether the response parameter LastStatus has assumed the value OK or FAILED. The process is considered successfully approved if LastStatus displays the value OK and the AmountAuth parameter the payment amount. The process is considered rejected when LastStatus returns the value FAILED. As long as Alipay / Wechat has not approved the process, LastStatus contains the value AUTHORIZE-REQUEST.
The parameters from the Inquire section apply to call the status check.

Instalment purchase with easyCredit

Performing an instalment purchase transaction with a terminal. Some parameters are valid only for requests from certain areas: DCC: Dynamic Currency Conversion, MTT: Mass Transit Transaction.

In order to make a POS payment with easyCredit, please use the following URL:

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	BaseURL
PageWithExcerpt	Wording

posPayment.aspx

For the Integration test system, please use: https://dev.computop.de/Paygate/posPayment.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	1753885964839_2104255465
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt

MultiExcerptName	POS_easyCredit_request

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1753885964840_-689883239
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
MessageType	an2	M	Message type of request. Returned in response. Allowed values: 01 (Explanations in the appendix under Message Types)	Nachrichtentyp der Anfrage.Wird als Antwort zurückgegeben.Zulässige Werte: 01 (Erläuterungen im Anhang unter Nachrichtentypen)

Table Excerpt Include

static	true
name	MerchantID
page	MerchantID
type	page

Table Excerpt Include

static	true
name	TransID
page	TransID
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	RefNr
page	refnr
type	page

Key

Format

CND

Description

Beschreibung

Amount

n..10

M

Amount in the smallest currency unit (e.g. EUR Cent). Please contact the

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	Wording

, if you want to capture amounts <100 (smallest currency unit).

For DCC: Amount in foreign currency

For Cashback transactions this should contain the sum of payment amount and cashback amount.

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	DE:Wording

, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Für DCC: Betrag in Fremdwährung

Bei Cashback-Transaktionen sollte hier die Summe aus Zahlungsbetrag und Cashback-Betrag angegeben werden.

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	Currency
page	Currency
type	page

Table Excerpt Include

static	true
name	MAC
page	MAC
type	page

Key	Format	CND	Description	Beschreibung
POSTerminalID	an..20	M	TerminalID of the card reader	TerminalID des Kartenlesers
Device	an16	M	Serial number of the card reader	Seriennummer des Kartenlesers
Manufacturer	an..30	M	Manufacturer of the card reader (associated with the serial number)	Hersteller des Kartenlesers (verbunden mit der Seriennummer)
TerminalModel	..60	O	Model or type of card reader	Modell oder Typ des Kartenlesers
CCNr	n8.19	M	PAN of the card. With easyCredit the PAN consisting of country prefix, short bank code, account number and check digit.	PAN der Karte.Bei easyCredit besteht die PAN aus Länder-Präfix, kurzer Bankleitzahl, Kontonummer und Prüfziffer.
CCBrand	an..22	M	Please always include easyCredit with easyCredit!	Bitte bei easyCredit immer easyCredit mit angeben!
CCExpiry	n6	C	Mandatory for credit cards. Expiration date of credit card (YYYDMM), e.g. 202507.	Pflicht für Kreditkarten.Ablaufdatum der Kreditkarte (JJJJMM), z.B. 202507.
OrderDesc	ans..200	O	Description of purchased goods, unit prices etc.	Beschreibung der gekauften Waren, Einzelpreise usw.
ContractID	n..8	O	Additional contract number of the merchant with the acquirer, with which the default VU number can be overridden	Zusätzliche Vertragsnummer des Händlers mit dem Acquirer, mit der die Standard-VU-Nummer überschrieben werden kann
DMACKSN	an..20	C	DUKPT Key Serial Number used to generate the DUKPT MAC (parameter DMAC). Mandatory for all devices except PhonePOS.	DUKPT-Schlüsselseriennummer, die zum Generieren des DUKPT-MAC (Parameter DMAC) verwendet wird.Obligatorisch für alle Geräte außer PhonePOS.
DMAC	an16	C	DUKPT Message Authentication Code, which is formed over the entire message (all parameters except DMAC). See chapter "Formation of the DUKPTMAC". Mandatory for all devices except PhonePOS.	DUKPT-Nachrichtenauthentifizierungscode, der über die gesamte Nachricht (alle Parameter außer DMAC) gebildet wird.Siehe Kapitel „Bildung des DUKPTMAC“.Obligatorisch für alle Geräte außer PhonePOS.

Parameters for POS payments with easyCredit

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Response_Intro
PageWithExcerpt	Reuse API

Table Filter

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

Multiexcerpt

MultiExcerptName	POS_easyCredit_response

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1753885983180_1902514377
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
MessageType	an2	M	Message type transmitted in the request	In der Anfrage übermittelter Nachrichtentyp

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

isFirstTimeEnter	true
static	true
v	2
name	TransID
page	TransID
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	RefNr
page	refnr
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	Status_OK_FAILED
page	Status
type	page

Table Excerpt Include

static	true
name	Description
page	Description
type	page

Table Excerpt Include

static	true
name	Code
page	Code
type	page

Key	Format	CND	Description	Beschreibung
POSTerminalID	an...20	M	TerminalID of the card reader	TerminalID des Kartenlesers
CodeExt	an2	M	Response code from easyCredit posData.status code	Antwortcode von easyCredit posData.status code
ApprovalCode	n..6	C	With easyCredit the approval number	Bei easyCredit die Genehmigungsnummer
EMVData	an..2048	C	With easyCredit all elements from the JSON object posData. This contains the attributes for the document print. Format: JSON (packaged in base64).	Bei easyCredit alle Elemente aus dem JSON-Objekt posData. Dieses enthält die Attribute für den Belegdruck. Format: JSON (verpackt in Base64).
VUNr	ans..20	O	With easyCredit the sales office number of the store	Bei easyCredit die Verkaufsstellennummer des Geschäfts
ConfigUpdate	a3	O	If this parameter occurs in the response and has the value "yes", then there is an update of the terminal configuration. The update can then be retrieved via the posconfig.aspx.	Wenn dieser Parameter in der Antwort vorkommt und den Wert "yes" hat, dann liegt ein Update der Terminalkonfiguration vor.Das Update kann dann über die posconfig.aspx abgerufen werden.
DMACKSN	an..20	M	DUKPT Key Serial Number used to generate the DUKPT MAC (parameter DMAC)	DUKPT-Schlüsselseriennummer, die zum Generieren des DUKPT-MAC (Parameter DMAC) verwendet wird
DMAC	an16	M	DUKPT Message Authentication Code for the entire response	DUKPT-Nachrichtenauthentifizierungscode für die gesamte Antwort

Response parameters for POS payments with easyCredit

Inquire

With the help of the Inquire Request, you will receive information about a transaction from which you only know your own TransID. Some parameters are valid only for requests from certain areas: DCC: Dynamic Currency Conversion, MTT: Mass Transit Transaction.

In order to inquire information about a POS payment, please use the following URL:

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	BaseURL
PageWithExcerpt	Wording

posPayment.aspx

For the Integration test system, please use: https://dev.computop.de/Paygate/posPayment.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	1753886008224_1350030533
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt

MultiExcerptName	POS_inquire_request

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1753886008225_810474370
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
MessageType	an2	M	Message type of request. Returned in response. Allowed values in the attachment under Message Types. Here always: F1 (Explanations in the appendix under Message Types)	Nachrichtentyp der Anfrage.Wird als Antwort zurückgegeben Erlaubte Werte im Anhang unter Nachrichtentypen. Hier immer:: F1 (Erläuterungen im Anhang unter Nachrichtentypen)

Table Excerpt Include

static	true
name	MerchantID
page	MerchantID
type	page

Table Excerpt Include

static	true
name	TransID
page	TransID
type	page

Table Excerpt Include

static	true
name	MAC
page	MAC
type	page

Key	Format	CND	Description	Beschreibung
POSTerminalID	an..20	M	TerminalID of the card reader	TerminalID des Kartenlesers
Device	an16	M	Serial number of the card reader	Seriennummer des Kartenlesers
Manufacturer	an..30	C	Manufacturer of the card reader (associated with the serial number) Mandatory for SEPAELV and Girocard, optional for others.	Hersteller des Kartenlesers (verbunden mit der Seriennummer) Pflicht für SEPAELV und Girocard, optional für andere.
TerminalModel	..60	O	Model or type of card reader	Modell oder Typ des Kartenlesers
DMACKSN	an..20	C	DUKPT Key Serial Number used to generate the DUKPT MAC (parameter DMAC). Mandatory for all devices except PhonePOS.	DUKPT-Schlüsselseriennummer, die zum Generieren des DUKPT-MAC (Parameter DMAC) verwendet wird.Obligatorisch für alle Geräte außer PhonePOS.
DMAC	an16	C	DUKPT Message Authentication Code, which is formed over the entire message (all parameters except DMAC). See chapter "Formation of the DUKPTMAC". Mandatory for all devices except PhonePOS.	DUKPT-Nachrichtenauthentifizierungscode, der über die gesamte Nachricht (alle Parameter außer DMAC) gebildet wird.Siehe Kapitel „Bildung des DUKPTMAC“.Obligatorisch für alle Geräte außer PhonePOS.

Parameters for inquiring information about POS payments

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Response_Intro
PageWithExcerpt	Reuse API

Table Filter

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

Multiexcerpt

MultiExcerptName	POS_inquire_response

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1753886028598_1942644789
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
MessageType	an2	M	Message type transmitted in the request	In der Anfrage übermittelter Nachrichtentyp

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	C	Transaction number of the merchant. In the event of an error, not included in the answer.	Transaktionsnummer des Händlers.Im Fehlerfall nicht in der Antwort enthalten.
Status	a..50	M	OK or FAILED. Refers to the Inquire request itself.	OK oder FAILED.Bezieht sich auf die Anfrage selbst.

Table Excerpt Include

static	true
name	Description
page	Description
type	page

Table Excerpt Include

static	true
name	Code
page	Code
type	page

Key	Format	CND	Description	Beschreibung
POSTerminalID	an...20	M	TerminalID of the card reader	TerminalID des Kartenlesers
AmountAuth	n..10	O	Authorized amount of the requested operation	Autorisierter Betrag der angeforderten Operation
AmountCap	n..10	O	Captured amount of the requested process	Gebuchter Betrag des angeforderten Vorgangs
AmountCred	n..10	O	Credited amount of the requested process	Gutgeschriebener Betrag des angeforderten Vorgangs
LastStatus	n..10	O	Status of the requested process	Status des angeforderten Vorgangs
ConfigUpdate	a3	O	If this parameter occurs in the response and has the value "yes", then there is an update of the terminal configuration. The update can then be retrieved via the posconfig.aspx.	Wenn dieser Parameter in der Antwort vorkommt und den Wert "yes" hat, dann liegt ein Update der Terminalkonfiguration vor.Das Update kann dann über die posconfig.aspx abgerufen werden.
DMACKSN	an..20	M	DUKPT Key Serial Number used to generate the DUKPT MAC (parameter DMAC)	DUKPT-Schlüsselseriennummer, die zum Generieren des DUKPT-MAC (Parameter DMAC) verwendet wird
DMAC	an16	M	DUKPT Message Authentication Code for the entire response	DUKPT-Nachrichtenauthentifizierungscode für die gesamte Antwort

Response parameters for inquiring information about POS payments

Card Reversal / Automatic Reversal

Reversal initiated by the map or triggered automatically by the terminal after a timeout. Some parameters are valid only for requests from certain areas: DCC: Dynamic Currency Conversion, MTT: Mass Transit Transaction.

In order to automatically reverse a POS payment, please use the following URL:

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	BaseURL
PageWithExcerpt	Wording

posPayment.aspx

For the Integration test system, please use: https://dev.computop.de/Paygate/posPayment.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	1753886064238_1258994329
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt

MultiExcerptName	POS_reversal_request

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1753886064239_1967042286
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
MessageType	an2	M	Message type of request. Returned in response. Allowed value: F0 (Explanations in the appendix under Message Types)	Nachrichtentyp der Anfrage.Wird als Antwort zurückgegeben.Zulässiger Wert: F0 (Erläuterungen im Anhang unter Nachrichtentypen)

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

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	RefNr
page	refnr
type	page

Key

Format

CND

Description

Beschreibung

Amount

n..10

M

Amount in the smallest currency unit (e.g. EUR Cent). Please contact the

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	Wording

, if you want to capture amounts <100 (smallest currency unit).

For DCC: Amount in foreign currency

For Cashback transactions this should contain the sum of payment amount and cashback amount.

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	DE:Wording

, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Für DCC: Betrag in Fremdwährung

Bei Cashback-Transaktionen sollte hier die Summe aus Zahlungsbetrag und Cashback-Betrag angegeben werden.

Key	Format	CND	Description	Beschreibung
CashbackAmount	n..10	O	Cashback Amount in case such transaction type is submitted. Given in the smallest currency unit (e.g. EUR Cent).	Cashback-Betrag, falls dieser Transaktionstyp übermittelt wird.Angegeben in der kleinsten Währungseinheit (z. B. EUR-Cent).

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	Currency
page	Currency
type	page

Table Excerpt Include

static	true
name	MAC
page	MAC
type	page

Key	Format	CND	Description	Beschreibung
POSTerminalID	an..20	M	TerminalID of the card reader	TerminalID des Kartenlesers
Device	an16	M	Serial number of the card reader	Seriennummer des Kartenlesers
Manufacturer	an..30	C	Manufacturer of the card reader (associated with the serial number) Mandatory for SEPAELV and Girocard, optional for others.	Hersteller des Kartenlesers (verbunden mit der Seriennummer) Pflicht für SEPAELV und Girocard, optional für andere.
TerminalModel	..60	O	Model or type of card reader	Modell oder Typ des Kartenlesers
EMVData	an..2048	C	Data of the original transaction incl. AAC at Card Reversal (in Hex formatting). If there are no EMC data, such as MSR, then completely omit this parameter.	Daten der ursprünglichen Transaktion inkl. AAC bei Kartenrückbuchung (im Hex-Format).Sollten keine EMC-Daten, wie z.B. MSR, vorhanden sein, dann lassen Sie diesen Parameter komplett weg.
CCSeqNo	n3	O	Card sequence number	Kartenfolgenummer
OrderDesc	ans..200	O	Description of purchased goods, unit prices etc.	Beschreibung der gekauften Waren, Einzelpreise usw.
LocalDate	n4	C	The local month and day that the transaction takes place at the card acceptor location. The format is MMDD. Mandatory for SEPAELV, optional for others.	Der lokale Monat und Tag der Transaktion am Standort des Kartenakzeptors.Das Format ist MMTT. Pflicht für SEPAELV, optional für andere.
LocalTime	n6	C	The local time at which the transaction takes place at the point of card acceptor location. The format is hhmmss. Mandatory for SEPAELV, optional for others.	Die Ortszeit der Transaktion am Standort des Kartenakzeptors.Das Format ist hhmmss.Obligatorisch für SEPAELV, optional für andere.
ReceiptNr	n4	C	Mandatory for SEPAELV, Girocard transactions, optional for others. The value which terminals send the following format for ELV in BMP 3 (according to ZVTH): 38bbbb (bbbb = receipt number)	Obligatorisch für SEPAELV, Girocard-Transaktionen, optional für andere.Der Wert, den Terminals senden, hat für ELV in BMP 3 folgendes Format (gemäß ZVTH): 38bbbb (bbbb = Belegnummer)
dccStatus	a1	C	Mandatory for DCC; status of foreign currency settlement. Possible values: U foreign currency was used. E foreign currency was offered but not used.	Pflicht für DCC;Status der Fremdwährungsabrechnung.Mögliche Werte: U Fremdwährung wurde verwendet. E Fremdwährung wurde angeboten, aber nicht verwendet.
TraceNr	n6	O	Continuous 6-digit decimal. Is incremented for each transaction as described in TA.	Fortlaufende 6-stellige Dezimalzahl.Wird für jede Transaktion wie in TA beschrieben erhöht.
ConditionCode	n2	C	Mandatory only for girocard. Condition code. Values from 00 to 99 as described in TA under BMP 25.	Nur bei girocard Pflicht. Bedingungscode.Werte von 00 bis 99 wie in TA unter BMP 25 beschrieben.
TerminalData	an..99	C	Mandatory only for girocard. Terminal data includes: online time, POS data and approval number of the terminal. Format: Hex, TLV-coded (see also TA BMP 61).	Nur bei girocard Pflicht. Zu den Terminaldaten gehören: Online-Zeit, POS-Daten und Zulassungsnummer des Terminals.Format: Hex, TLV-kodiert (siehe auch TA BMP 61).
DMACKSN	an..20	C	DUKPT Key Serial Number used to generate the DUKPT MAC (parameter DMAC). Mandatory for all devices except PhonePOS.	DUKPT-Schlüsselseriennummer, die zum Generieren des DUKPT-MAC (Parameter DMAC) verwendet wird.Obligatorisch für alle Geräte außer PhonePOS.
DMAC	an16	C	DUKPT Message Authentication Code, which is formed over the entire message (all parameters except DMAC). See chapter "Formation of the DUKPTMAC". Mandatory for all devices except PhonePOS.	DUKPT-Nachrichtenauthentifizierungscode, der über die gesamte Nachricht (alle Parameter außer DMAC) gebildet wird.Siehe Kapitel „Bildung des DUKPTMAC“.Obligatorisch für alle Geräte außer PhonePOS.

Parameters for reversals of POS payments

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Response_Intro
PageWithExcerpt	Reuse API

Table Filter

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

Multiexcerpt

MultiExcerptName	POS_reversal_response

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1753886084705_1275444312
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
MessageType	an2	M	Message type transmitted in the request	In der Anfrage übermittelter Nachrichtentyp

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

isFirstTimeEnter	true
static	true
v	2
name	TransID
page	TransID
type	page

Table Excerpt Include

static	true
name	Amount
page	Amount
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	Currency
page	Currency
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	Status_OK_FAILED
page	Status
type	page

Table Excerpt Include

static	true
name	Description
page	Description
type	page

Table Excerpt Include

static	true
name	Code
page	Code
type	page

Key

Format

CND

Description

Beschreibung

CodeExt

an2

M

Response code of the acquirer

Antwortcode des Acquirers

EMVData

an..2048

C

Acquirer Response (in hex formatting). Includes, among other things, the Issuer Authorization Response Code (Tag 8A), the Issuer Scripts (Tag 71, 72) and Issuer Authentication Data (Tag 91)

Acquirer-Antwort (im Hex-Format).Enthält unter anderem den Issuer Authorization Response Code (Tag 8A), die Issuer Scripts (Tag 71, 72) und Issuer Authentication Data (Tag 91)

POSTerminalID

an...20

M

TerminalID of the card reader

TerminalID des Kartenlesers

ConfigUpdate

a3

O

If this parameter occurs in the response and has the value "yes", then there is an update of the terminal configuration. The update can then be retrieved via the posconfig.aspx.

Wenn dieser Parameter in der Antwort vorkommt und den Wert "yes" hat, dann liegt ein Update der Terminalkonfiguration vor.Das Update kann dann über die posconfig.aspx abgerufen werden.

VUNr

ans..20

O

Only by credit card: contract number of the merchant with the acquirer. Configured at the merchant.

Nur bei Kreditkarten: Vertragsnummer des Händlers mit dem Acquirer. Ist beim Händler konfiguriert.

TerminalID

ans..20

O

Only with credit card: TerminalID that

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Partner-Name
PageWithExcerpt	Wording

exchanges with the acquirer. Configured at the merchant.

Nur bei Kreditkarten: TerminalID, die

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Partner-Name
PageWithExcerpt	DE:Wording

mit dem Acquirer austauscht. Ist beim Händler konfiguriert.

AQ

ans..30

O

Abbreviation of the Acquirers. Configured at the merchant.

Abkürzung der Acquirer. Ist beim Händler konfiguriert.

TrxTime

ans21

O

Time of execution of the transaction in format: dd.MM.yyyy HH:mm:ssff. Configured at the merchant.

Ausführungszeitpunkt der Transaktion im Format: tt.MM.jjjj HH:mm:ssff. Ist beim Händler konfiguriert.

DMACKSN

an..20

M

DUKPT Key Serial Number used to generate the DUKPT MAC (parameter DMAC)

DUKPT-Schlüsselseriennummer, die zum Generieren des DUKPT-MAC (Parameter DMAC) verwendet wird

DMAC

an16

M

DUKPT Message Authentication Code for the entire response

DUKPT-Nachrichtenauthentifizierungscode für die gesamte Antwort

Response parameters for reversals of POS payments

Manual Reversal

This reversal is triggered by the terminal operator. Some parameters are valid only for requests from certain areas: DCC: Dynamic Currency Conversion, MTT: Mass Transit Transaction.

In order to reverse a POS payment manually, please use the following URL:

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	BaseURL
PageWithExcerpt	Wording

posPayment.aspx

For the Integration test system, please use: https://dev.computop.de/Paygate/posPayment.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	1753886109168_-1731264548
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt

MultiExcerptName	POS_manual_reversal_request

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1753886109169_-128415215
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
MessageType	an2	M	Message type of request. Returned in response. Allowed value: 02 (Explanations in the appendix under Message Types)	Nachrichtentyp der Anfrage.Wird als Antwort zurückgegeben.Zulässiger Wert: 02 (Erläuterungen im Anhang unter Nachrichtentypen)

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

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	RefNr
page	refnr
type	page

Key

Format

CND

Description

Beschreibung

Amount

n..10

M

Amount in the smallest currency unit (e.g. EUR Cent). Please contact the

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	Wording

, if you want to capture amounts <100 (smallest currency unit).

For DCC: Amount in foreign currency

For Cashback transactions this should contain the sum of payment amount and cashback amount.

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	DE:Wording

, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Für DCC: Betrag in Fremdwährung

Bei Cashback-Transaktionen sollte hier die Summe aus Zahlungsbetrag und Cashback-Betrag angegeben werden.

Key	Format	CND	Description	Beschreibung
CashbackAmount	n..10	O	Cashback Amount in case such transaction type is submitted. Given in the smallest currency unit (e.g. EUR Cent).	Cashback-Betrag, falls dieser Transaktionstyp übermittelt wird.Angegeben in der kleinsten Währungseinheit (z. B. EUR-Cent).

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	Currency
page	Currency
type	page

Table Excerpt Include

static	true
name	MAC
page	MAC
type	page

Key	Format	CND	Description	Beschreibung
POSTerminalID	an..20	M	TerminalID of the card reader	TerminalID des Kartenlesers
Device	an16	M	Serial number of the card reader	Seriennummer des Kartenlesers
Manufacturer	an..30	M	Manufacturer of the card reader (associated with the serial number)	Hersteller des Kartenlesers (verbunden mit der Seriennummer)
TerminalModel	..60	O	Model or type of card reader	Modell oder Typ des Kartenlesers
LocalDate	n4	M	Date of the transaction. Format: MMTT	Datum der Transaktion.Format: MMTT
LocalTime	n6	M	Time of the transaction. Format: hhmmss	Uhrzeit der Transaktion.Format: hhmmss
ReceiptNr	n4	M	Number for the document. Will be continuously increased. Overflow to 9999.	Nummer für das Dokument.Wird fortlaufend erhöht.Überlauf bis 9999.
TraceNr	n6	M	Continuous 6-digit decimal. Is incremented for each transaction as described in TA.	Fortlaufende 6-stellige Dezimalzahl.Wird für jede Transaktion wie in TA beschrieben erhöht.
ConditionCode	n2	C	Additional information for transaction, to be communicated with CLV+ end. Mandatory for SEPAELV and girocard transactions, optional for others. Values from 00 to 99 as described in TA under BMP 25.	Zusätzliche Informationen zur Transaktion, die mit CLV+-Ende kommuniziert werden müssen. Pflicht für SEPAELV- und girocard-Transaktionen, optional für andere. Werte von 00 bis 99 wie in TA unter BMP 25 beschrieben.
TerminalData	an..99	C	Mandatory only for girocard. Terminal data includes: online time, POS data and approval number of the terminal. Format: Hex, TLV-coded (see also TA BMP 61).	Nur bei girocard Pflicht. Zu den Terminaldaten gehören: Online-Zeit, POS-Daten und Zulassungsnummer des Terminals.Format: Hex, TLV-kodiert (siehe auch TA BMP 61).
CCExpiry	n6	C	Mandatory for credit cards. Expiry date of the card (YYYYMM), e.g. 202507. Must be sent for SEPAELV transactions.	Pflicht für Kreditkarten.Ablaufdatum der Karte (JJJJMM), z.B. 202507. Muss bei SEPAELV-Transaktionen übermittelt werden.
CCSeqNr	n3	O	Card sequence number. Must be sent for SEPAELV transactions.	Kartenfolgenummer. Muss für SEPAELV-Transaktionen gesendet werden.
EntryMode	n3	C	Mandatory for credit cards. POS Entry Mode (Tag 9F39). Must be sent for SEPAELV transactions.	Pflicht für Kreditkarten. POS-Eingabemodus (Tag 9F39).Muss für SEPAELV-Transaktionen gesendet werden.
DMACKSN	an..20	C	DUKPT Key Serial Number used to generate the DUKPT MAC (parameter DMAC). Mandatory for all devices except PhonePOS.	DUKPT-Schlüsselseriennummer, die zum Generieren des DUKPT-MAC (Parameter DMAC) verwendet wird.Obligatorisch für alle Geräte außer PhonePOS.
DMAC	an16	C	DUKPT Message Authentication Code, which is formed over the entire message (all parameters except DMAC). See chapter "Formation of the DUKPTMAC". Mandatory for all devices except PhonePOS.	DUKPT-Nachrichtenauthentifizierungscode, der über die gesamte Nachricht (alle Parameter außer DMAC) gebildet wird.Siehe Kapitel „Bildung des DUKPTMAC“.Obligatorisch für alle Geräte außer PhonePOS.

Parameters for manual reversals of POS payments

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Response_Intro
PageWithExcerpt	Reuse API

Table Filter

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

Multiexcerpt

MultiExcerptName	POS_manual_reversal_response

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1753886127002_-2022916002
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
MessageType	an2	M	Message type transmitted in the request	In der Anfrage übermittelter Nachrichtentyp

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

isFirstTimeEnter	true
static	true
v	2
name	TransID
page	TransID
type	page

Table Excerpt Include

static	true
name	Amount
page	Amount
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	Currency
page	Currency
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	Status_OK_FAILED
page	Status
type	page

Table Excerpt Include

static	true
name	Description
page	Description
type	page

Table Excerpt Include

static	true
name	Code
page	Code
type	page

Key

Format

CND

Description

Beschreibung

CodeExt

an2

O

Response code of the acquirer

Antwortcode des Acquirers

POSTerminalID

an...20

M

TerminalID of the card reader

TerminalID des Kartenlesers

VUNr

ans..20

O

Only by credit card: contract number of the merchant with the acquirer. Configured at the merchant.

Nur bei Kreditkarten: Vertragsnummer des Händlers mit dem Acquirer. Ist beim Händler konfiguriert.

TerminalID

ans..20

O

Only with credit card: TerminalID that

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Partner-Name
PageWithExcerpt	Wording

exchanges with the acquirer. Configured at the merchant.

Nur bei Kreditkarten: TerminalID, die

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Partner-Name
PageWithExcerpt	DE:Wording

mit dem Acquirer austauscht. Ist beim Händler konfiguriert.

AQ

ans..30

O

Abbreviation of the Acquirers. Configured at the merchant.

Abkürzung der Acquirer. Ist beim Händler konfiguriert.

TrxTime

ans21

O

Time of execution of the transaction in format: dd.MM.yyyy HH:mm:ssff. Configured at the merchant.

Ausführungszeitpunkt der Transaktion im Format: tt.MM.jjjj HH:mm:ssff. Ist beim Händler konfiguriert.

ConfigUpdate

a3

O

If this parameter occurs in the response and has the value "yes", then there is an update of the terminal configuration. The update can then be retrieved via the posconfig.aspx.

Wenn dieser Parameter in der Antwort vorkommt und den Wert "yes" hat, dann liegt ein Update der Terminalkonfiguration vor.Das Update kann dann über die posconfig.aspx abgerufen werden.

OriginalCode

ans..3

O

MTT only: Contains the original Response Code (OmniPay BM 60 SF68: Scheme Response Code) from the authorization platforms for payment systems

Nur MTT: Enthält den originalen Antwort-Code (OmniPay BM 60 SF68: Scheme Response Code) der Autorisierungsplattformen für Zahlungssysteme

DMACKSN

an..20

M

DUKPT Key Serial Number used to generate the DUKPT MAC (parameter DMAC)

DUKPT-Schlüsselseriennummer, die zum Generieren des DUKPT-MAC (Parameter DMAC) verwendet wird

DMAC

an16

M

DUKPT Message Authentication Code for the entire response

DUKPT-Nachrichtenauthentifizierungscode für die gesamte Antwort

Response parameters for manual reversals of POS payments

Credit without reference

Triggering a credit via the terminal. Some parameters are valid only for requests from certain areas: DCC: Dynamic Currency Conversion, MTT: Mass Transit Transaction.

In order to credit a POS payment, please use the following URL:

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	BaseURL
PageWithExcerpt	Wording

posPayment.aspx

For the Integration test system, please use: https://dev.computop.de/Paygate/posPayment.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	1753886152014_-69784513
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt

MultiExcerptName	POS_creditex_request

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1753886152016_152394775
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
MessageType	an2	M	Message type of request. Returned in response. Allowed value: 03 (Explanations in the appendix under Message Types)	Nachrichtentyp der Anfrage.Wird als Antwort zurückgegeben.Zulässiger Wert: 03 (Erläuterungen im Anhang unter Nachrichtentypen)

Table Excerpt Include

static	true
name	MerchantID
page	MerchantID
type	page

Table Excerpt Include

static	true
name	TransID
page	TransID
type	page

Table Excerpt Include

static	true
name	MAC
page	MAC
type	page

Key

Format

CND

Description

Beschreibung

RefNr

ans..30

O

Unique reference number. For DCC: dccReferenceData (reference of the DCC request).

Eindeutige Referenznummer.Für DCC: dccReferenceData (Referenz der DCC-Anfrage).

Amount

n..10

M

Amount in the smallest currency unit (e.g. EUR Cent). Please contact the

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	Wording

, if you want to capture amounts <100 (smallest currency unit).

For DCC: Amount in foreign currency

For Cashback transactions this should contain the sum of payment amount and cashback amount.

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	DE:Wording

, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Für DCC: Betrag in Fremdwährung

Bei Cashback-Transaktionen sollte hier die Summe aus Zahlungsbetrag und Cashback-Betrag angegeben werden.

Currency

a3

M

Currency, three characters DIN / ISO 4217. At DCC: The foreign currency.

Währung, dreistellig DIN/ISO 4217. Bei DCC: Die Fremdwährung.

dccStatus

a1

C

Mandatory for DCC; status of foreign currency settlement. Possible values: U foreign currency was used. E foreign currency was offered but not used.

Pflicht für DCC;Status der Fremdwährungsabrechnung.Mögliche Werte: U Fremdwährung wurde verwendet. E Fremdwährung wurde angeboten, aber nicht verwendet.

dccRateValue

ans13

C

Mandatory at DCC and dccStatus U ; Exchange rate with decimal point

Pflicht bei DCC und dccStatus U;Wechselkurs mit Dezimalpunkt

dccRateID

ans..20

C

Fiserv IPG-Rate. Only present in case of a DCC service via Fiserv.

Fiserv IPG-Rate.Nur vorhanden bei einem DCC-Dienst über Fiserv.

baseAmount

n..10

C

Mandatory at DCC and dccStatus U ; Amount in the smallest currency unit in Terminal currency

Pflicht bei DCC und dccStatus U; Betrag in der kleinsten Währungseinheit in Terminalwährung

baseCurrency

a3

C

Mandatory at DCC and dccStatus U ; Currency set up at the terminal as standard

Pflicht bei DCC und dccStatus U; Am Terminal standardmäßig ingestellte Währung

dccMargin

ans..5

O

DCC margin/markup percentage

DCC-Marge/Aufschlag in Prozent

dccCommission

ans..12

O

DCC commission percentage

DCC-Provisionssatz in Prozent

dccSource

ans..32

O

Exchange rate source (e.g., "REUTERS WHOLESALE INTERBANK")

Wechselkursquelle (z. B. „REUTERS WHOLESALE INTERBANK“)

dccTimestamp

ans..20

O

Timestamp of exchange rate

Zeitstempel des Wechselkurses

dccRequestId

an..32

O

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Partner-Name
PageWithExcerpt	Wording

PayID of the DCC request (enables linking DCC and POS payment records)

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Partner-Name
PageWithExcerpt	DE:Wording

PayID der DCC-Anfrage (ermöglicht die Verknüpfung von DCC- und POS-Zahlungsdatensätzen)

POSTerminalID

an..20

M

TerminalID of the card reader

TerminalID des Kartenlesers

Device

an16

M

Serial number of the card reader

Seriennummer des Kartenlesers

Manufacturer

an..30

C

Manufacturer of the card reader (associated with the serial number)

Mandatory for SEPAELV and Girocard, optional for others.

Hersteller des Kartenlesers (verbunden mit der Seriennummer)

Pflicht für SEPAELV und Girocard, optional für andere.

TerminalModel

..60

O

Model or type of card reader

Modell oder Typ des Kartenlesers

CCNr

n8..19

M

Card number

Kartennummer

CCBrand

an..22

M

Card brand: VISA, MasterCard, Maestro, AMEX, DINERS, JCB, CUP. Please note the spelling! Always specify SEPAELV at ELV!

Kartenmarke: VISA, MasterCard, Maestro, AMEX, DINERS, JCB, CUP.Bitte achten Sie auf die Schreibweise!Bei ELV immer SEPAELV angeben!

CCExpiry

n6

M

Expiration date of the card (YYYYMM), e.g. 202507

Ablaufdatum der Karte (JJJJMM), zB 202507

CCSeqNr

n3

O

Card sequence number

Kartenfolgenummer

Track2

an..224

C

Data of the track2 for MSR or Track2EquivalentData (Tag 57) (in Hex formatting). At MSR Track2 or Track2Enc is mandatory.

Daten des Track2 für MSR oder Track2EquivalentData (Tag 57) (im Hex-Format).Bei MSR ist Track2 bzw. Track2Enc zwingend erforderlich.

DataEncrypted

an..2048

O

Pan + Track2 Equivalent Data (in TLV format) as an encrypted value. If this field is present, the parameter CCNr is not required. PKSC#7 padding is recommended for the TLV string.

Pan + Track2-Äquivalentdaten (im TLV-Format) als verschlüsselter Wert.Wenn dieses Feld vorhanden ist, ist der Parameter CCNr nicht erforderlich.Für die TLV-Zeichenfolge wird PKSC#7-Padding empfohlen.

DataKSN

an..20

C

KSN is generated by the terminal. Is required to decrypt the data from the parameter DataEncrypted.

KSN wird vom Terminal generiert.Wird zum Entschlüsseln der Daten aus dem Parameter DataEncrypted benötigt.

EntryMode

n3

C

Mandatory for credit cards. POS Entry Mode.

Pflicht für Kreditkarten. POS-Eingabemodus.

OrderDesc

ans..200

O

Description of purchased goods, unit prices etc.

Beschreibung der gekauften Waren, Einzelpreise usw.

DMACKSN

an..20

C

DUKPT Key Serial Number used to generate the DUKPT MAC (parameter DMAC). Mandatory for all devices except PhonePOS.

DUKPT-Schlüsselseriennummer, die zum Generieren des DUKPT-MAC (Parameter DMAC) verwendet wird.Obligatorisch für alle Geräte außer PhonePOS.

DMAC

an16

C

DUKPT Message Authentication Code, which is formed over the entire message (all parameters except DMAC). See chapter "Formation of the DUKPTMAC". Mandatory for all devices except PhonePOS.

DUKPT-Nachrichtenauthentifizierungscode, der über die gesamte Nachricht (alle Parameter außer DMAC) gebildet wird.Siehe Kapitel „Bildung des DUKPTMAC“.Obligatorisch für alle Geräte außer PhonePOS.

Parameters for credits of POS payments

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Response_Intro
PageWithExcerpt	Reuse API

Table Filter

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

Multiexcerpt

MultiExcerptName	POS_creditex_response

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1753886177582_-487660440
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
MessageType	an2	M	Message type transmitted in the request	In der Anfrage übermittelter Nachrichtentyp

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

isFirstTimeEnter	true
static	true
v	2
name	TransID
page	TransID
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	Status_OK_FAILED
page	Status
type	page

Table Excerpt Include

static	true
name	Description
page	Description
type	page

Table Excerpt Include

static	true
name	Code
page	Code
type	page

Key

Format

CND

Description

Beschreibung

POSTerminalID

an...20

M

TerminalID of the card reader

TerminalID des Kartenlesers

CodeExt

an2

M

Response code of the acquirer

Antwortcode des Acquirers

VUNr

ans..20

O

Only at credit card. Contract number of the merchant with the acquirer. Configured at the merchant.

Nur bei Kreditkarten: Vertragsnummer des Händlers mit dem Acquirer. Ist beim Händler konfiguriert.

TerminalID

ans..20

O

Only at credit card. TerminalID, which

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Partner-Name
PageWithExcerpt	Wording

exchanges with the acquirer. Configured at the merchant.

Nur bei Kreditkarten: TerminalID, die

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Partner-Name
PageWithExcerpt	DE:Wording

mit dem Acquirer austauscht. Ist beim Händler konfiguriert.

AQ

ans..30

O

Abbreviation of the acquirers. Configured at the merchant.

Abkürzung der Acquirer. Ist beim Händler konfiguriert.

TrxTime

ans21

O

Time of execution of the transaction in format: dd.MM.yyyy HH:mm:ssff. Configured at the merchant.

Ausführungszeitpunkt der Transaktion im Format: tt.MM.jjjj HH:mm:ssff. Ist beim Händler konfiguriert.

ConfigUpdate

a3

O

If this parameter occurs in the response and has the value "yes", then there is an update of the terminal configuration. The update can then be retrieved via the posconfig.aspx.

Wenn dieser Parameter in der Antwort vorkommt und den Wert "yes" hat, dann liegt ein Update der Terminalkonfiguration vor.Das Update kann dann über die posconfig.aspx abgerufen werden.

DMACKSN

an..20

M

DUKPT Key Serial Number used to generate the DUKPT MAC (parameter DMAC)

DUKPT-Schlüsselseriennummer, die zum Generieren des DUKPT-MAC (Parameter DMAC) verwendet wird

DMAC

an16

M

DUKPT Message Authentication Code for the entire response

DUKPT-Nachrichtenauthentifizierungscode für die gesamte Antwort

Response parameters for credits of POS payments

POS Increment

Not yet available for all acquirers. Some parameters are valid only for requests from certain areas: DCC: Dynamic Currency Conversion, MTT: Mass Transit Transaction.

In order to increment a POS payment, please use the following URL:

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	BaseURL
PageWithExcerpt	Wording

posPayment.aspx

For the Integration test system, please use: https://dev.computop.de/Paygate/posPayment.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	1753886201183_1400392149
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt

MultiExcerptName	POS_increment_request

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1753886201185_1934524961
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
MessageType	an2	M	Message type of request. Returned in response. Allowed value: 06 (Explanations in the appendix under Message Types)	Nachrichtentyp der Anfrage.Wird als Antwort zurückgegeben.Zulässiger Wert: 06 (Erläuterungen im Anhang unter Nachrichtentypen)

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

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	RefNr
page	refnr
type	page

Key

Format

CND

Description

Beschreibung

Amount

n..10

M

Amount in the smallest currency unit (e.g. EUR Cent). Please contact the

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	Wording

, if you want to capture amounts <100 (smallest currency unit).

For DCC: Amount in foreign currency

For Cashback transactions this should contain the sum of payment amount and cashback amount.

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	DE:Wording

, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Für DCC: Betrag in Fremdwährung

Bei Cashback-Transaktionen sollte hier die Summe aus Zahlungsbetrag und Cashback-Betrag angegeben werden.

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	Currency
page	Currency
type	page

Table Excerpt Include

static	true
name	MAC
page	MAC
type	page

Key	Format	CND	Description	Beschreibung
POSTerminalID	an..20	M	TerminalID of the card reader	TerminalID des Kartenlesers
Device	an16	M	Serial number of the card reader	Seriennummer des Kartenlesers
Manufacturer	an..30	M	Manufacturer of the card reader (associated with the serial number)	Hersteller des Kartenlesers (verbunden mit der Seriennummer)
TerminalModel	..60	O	Model or type of card reader	Modell oder Typ des Kartenlesers
CCSeqNr	n3	O	Card sequence number	Kartenfolgenummer
Track2	an..224	C	Mandatory with Magnetic Stripe Read (MSR). Data of the track2 for MSR or Track2EquivalentData (Tag 57) (in Hex formatting).	Obligatorisch beim Lesen von Magnetstreifen (MSR).Daten von Track2 für MSR oder Track2EquivalentData (Tag 57) (im Hex-Format).
EMVData	an..2048	C	EMC data as required for the passing on to the acquirer (in hex formatting). The exact structure is defined by the protocol used, which is stored in the master files of the terminal. If there are no EMC data, such as MSR, then completely omit this parameter.	EMC-Daten, wie sie für die Weitergabe an den Acquirer benötigt werden (im Hex-Format).Der genaue Aufbau wird durch das verwendete Protokoll vorgegeben, welches in den Stammdateien des Terminals hinterlegt ist. Wenn keine EMC-Daten, wie z.B. MSR, vorhanden sind, lassen Sie diesen Parameter ganz weg.
EntryMode	n3	M	POS Entry Mode	POS-Eingabemodus
DataEncrypted	an..2048	O	PAN + Track2 Equivalent Data (in TLV format) as encrypted value. If this field is present, the CCNr parameter is not required.	PAN + Track2-äquivalente Daten (im TLV-Format) als verschlüsselter Wert.Wenn dieses Feld vorhanden ist, ist der Parameter CCNr nicht erforderlich.
DataKSN	an..20	C	KSN is generated by the terminal. Is required to decrypt the data from the parameter DataEncrypted.	KSN wird vom Terminal generiert.Wird zum Entschlüsseln der Daten aus dem Parameter DataEncrypted benötigt.
LocalDate	n4	M	Date of the transaction. Format: MMTT	Datum der Transaktion.Format: MMTT
LocalTime	n6	M	Time of the transaction. Format: hhmmss	Uhrzeit der Transaktion.Format: hhmmss
ReceiptNr	n4	M	Number for the document. Will be continuously increased. Overflow to 9999.	Nummer für das Dokument.Wird fortlaufend erhöht.Überlauf bis 9999.
DMACKSN	an..20	C	DUKPT Key Serial Number used to generate the DUKPT MAC (parameter DMAC). Mandatory for all devices except PhonePOS.	DUKPT-Schlüsselseriennummer, die zum Generieren des DUKPT-MAC (Parameter DMAC) verwendet wird.Obligatorisch für alle Geräte außer PhonePOS.
DMAC	an16	C	DUKPT Message Authentication Code, which is formed over the entire message (all parameters except DMAC). See chapter "Formation of the DUKPTMAC". Mandatory for all devices except PhonePOS.	DUKPT-Nachrichtenauthentifizierungscode, der über die gesamte Nachricht (alle Parameter außer DMAC) gebildet wird.Siehe Kapitel „Bildung des DUKPTMAC“.Obligatorisch für alle Geräte außer PhonePOS.

Parameters for increments of POS payments

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Response_Intro
PageWithExcerpt	Reuse API

Table Filter

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

Multiexcerpt

MultiExcerptName	POS_increment_response

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1753886221679_1116792851
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
MessageType	an2	M	Message type transmitted in the request	In der Anfrage übermittelter Nachrichtentyp

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

isFirstTimeEnter	true
static	true
v	2
name	TransID
page	TransID
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	RefNr
page	refnr
type	page

Table Excerpt Include

static	true
name	Amount
page	Amount
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	Currency
page	Currency
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	Status_OK_FAILED
page	Status
type	page

Table Excerpt Include

static	true
name	Description
page	Description
type	page

Table Excerpt Include

static	true
name	Code
page	Code
type	page

Key

Format

CND

Description

Beschreibung

CodeExt

an2

O

Response code of the acquirer

Antwortcode des Acquirers

POSTerminalID

an...20

M

TerminalID of the card reader

TerminalID des Kartenlesers

OriginalCode

ans..3

O

MTT only: Contains the original Response Code (OmniPay BM 60 SF68: Scheme Response Code) from the authorization platforms for payment systems

Nur MTT: Enthält den originalen Antwort-Code (OmniPay BM 60 SF68: Scheme Response Code) der Autorisierungsplattformen für Zahlungssysteme

VUNr

ans..20

O

Contract number of the merchant with the acquirer. Configured at the merchant.

Vertragsnummer des Händlers mit dem Acquirer. Ist beim Händler konfiguriert.

TerminalID

ans..20

O

TerminalID that

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Partner-Name
PageWithExcerpt	Wording

exchanges with the acquirer. Configured at the merchant.

TerminalID, die

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Partner-Name
PageWithExcerpt	DE:Wording

mit dem Acquirer austauscht. Ist beim Händler konfiguriert.

AQ

ans..30

O

Abbreviation of the Acquirers. Configured at the merchant.

Abkürzung der Acquirer. Ist beim Händler konfiguriert.

TrxTime

ans21

O

Time of execution of the transaction in format: dd.MM.yyyy HH:mm:ssff. Configured at the merchant.

Ausführungszeitpunkt der Transaktion im Format: tt.MM.jjjj HH:mm:ssff. Ist beim Händler konfiguriert.

EMVData

an..2048

C

Block for additional data

Block für zusätzliche Daten

ConfigUpdate

a3

O

If this parameter occurs in the response and has the value "yes", then there is an update of the terminal configuration. The update can then be retrieved via the posconfig.aspx.

Wenn dieser Parameter in der Antwort vorkommt und den Wert "yes" hat, dann liegt ein Update der Terminalkonfiguration vor.Das Update kann dann über die posconfig.aspx abgerufen werden.

DMACKSN

an..20

M

DUKPT Key Serial Number used to generate the DUKPT MAC (parameter DMAC)

DUKPT-Schlüsselseriennummer, die zum Generieren des DUKPT-MAC (Parameter DMAC) verwendet wird

DMAC

an16

M

DUKPT Message Authentication Code for the entire response

DUKPT-Nachrichtenauthentifizierungscode für die gesamte Antwort

Response parameters for increments of POS payments

DCC transactions via VPN

In order to make a DCC request, please use the following URL:

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	BaseURL
PageWithExcerpt	Wording

posdcc.aspx

For the Integration test system, please use: https://dev.computop.de/Paygate/posdcc.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	1753959306404_1396277395
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt

MultiExcerptName	DCC_request

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1753959306406_-1582012039
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
MessageType	an2	M	Message type of request. Returned in response. Allowed value: FC (Explanations in the appendix under Message Types)	Nachrichtentyp der Anfrage.Wird als Antwort zurückgegeben.Zulässiger Wert: FC (Erläuterungen im Anhang unter Nachrichtentypen)

Table Excerpt Include

static	true
name	MerchantID
page	MerchantID
type	page

Table Excerpt Include

static	true
name	TransID
page	TransID
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	RefNr
page	refnr
type	page

Key

Format

CND

Description

Beschreibung

Amount

n..10

M

Amount in the smallest currency unit (e.g. EUR Cent). Please contact the

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	Wording

, if you want to capture amounts <100 (smallest currency unit).

For DCC: Amount in foreign currency

For Cashback transactions this should contain the sum of payment amount and cashback amount.

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	DE:Wording

, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Für DCC: Betrag in Fremdwährung

Bei Cashback-Transaktionen sollte hier die Summe aus Zahlungsbetrag und Cashback-Betrag angegeben werden.

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	Currency
page	Currency
type	page

Key	Format	CND	Description	Beschreibung
POSTerminalID	an...20	M	TerminalID of the card reader	TerminalID des Kartenlesers
Device	an16	M	Serial number of the card reader	Seriennummer des Kartenlesers
CCBIN	n10	M	The first 10 digits of the card number	Die ersten 10 Ziffern der Kartennummer
CCExpiry	n6	M	Expiration date of credit card (YYYDMM), e.g. 202507	Ablaufdatum der Kreditkarte (JJJJMM), z.B. 202507
CCBrand	a..22	M	Card brand	Kartenmarke
ContractID	n..8	O	Additional contract number of the merchant	Zusätzliche Vertragsnummer des Händlers

Parameters for DCC requests

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Response_Intro
PageWithExcerpt	Reuse API

Table Filter

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

Multiexcerpt

MultiExcerptName	DCC_response

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1753959319570_1449281907
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
MessageType	an2	M	Message type transmitted in the request	In der Anfrage übermittelter Nachrichtentyp

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

isFirstTimeEnter	true
static	true
v	2
name	TransID
page	TransID
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	RefNr
page	refnr
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	Status_OK_FAILED
page	Status
type	page

Table Excerpt Include

static	true
name	Description
page	Description
type	page

Table Excerpt Include

static	true
name	Code
page	Code
type	page

Key	Format	CND	Description	Beschreibung
POSTerminalID	an...20	M	TerminalID of the card reader	TerminalID des Kartenlesers
CodeExt	n..10	O	The status of the DCC request if the merchant is activated and inquiry fails	Der Status der DCC-Anfrage, wenn der Händler aktiviert ist und die Anfrage fehlschlägt
ErrorText	an..256	O	Error text when registered at the merchant fails	Fehlertext bei fehlgeschlagener Registrierung beim Händler
dccRateID	ans..20	O	Fiserv IPG-Rate. Only present in case of a DCC service via Fiserv.	Fiserv IPG-Rate.Nur vorhanden bei einem DCC-Dienst über Fiserv.
			Following parameters are returned only if there is a successful query	Folgende Parameter werden nur bei erfolgreicher Abfrage zurückgegeben
dccRateValue	ans..13	C	Exchange rate with decimal separator	Wechselkurs mit Dezimaltrennzeichen
dccForeignCurrencyCode	a3	C	Foreign currency, three characters DIN / ISO 4217	Fremdwährung, dreistellig DIN / ISO 4217
expirationTime	ans..19	C	Time stamp indicating how long exchange rate is valid. Specification in UTC. Format: YYYY-MM-ddTHH:mm:ss	Zeitstempel, der die Gültigkeitsdauer des Wechselkurses angibt.Angabe in UTC. Format: JJJJ-MM-TTTHH:mm:ss
dccForeignAmount	n..10	C	Foreign currency amount in the smallest currency unit	Fremdwährungsbetrag in der kleinsten Währungseinheit
dccMargin	ans..5	C	Exchange rate fee in percent. This value is the markup applied to foreign exchange rate for the transaction. This markup is also referred to as the rate margin which corresponds to the margin that is applied to the wholesale foreign exchange rate used in the DCC transaction. The rate margin is supplied for receipt printing purposes and to meet regulatory requirements where applicable. Examples 3 3.4 3,75	Wechselkursgebühr in Prozent. Dieser Wert gibt den Aufschlag auf den Wechselkurs der Transaktion an. Dieser Aufschlag wird auch als Kursmarge bezeichnet und entspricht der Marge, die auf den Großhandelswechselkurs der DCC-Transaktion angewendet wird. Die Kursmarge wird für den Belegdruck und gegebenenfalls zur Erfüllung gesetzlicher Anforderungen angegeben. Beispiele: 3 3,4 3,75
dccCommission	ans7	C	Reserved, Fixed "00.0000" - dd.dddd	Reserviert, Fest "00.0000" - dd.dddd
dccSource	ans...32	C	Exchange rate provider: "REUTERS WHOLESALE INTERBANK"	Wechselkursanbieter: „REUTERS WHOLESALE INTERBANK“
dccTimestamp	ans19	C	Time stamp when the shift course was requested. Specification in UTC. Format: YYYY-MM-ddTHH:mm:ss	Zeitstempel der Anforderung des Wechselkurses.Angabe in UTC. Format: JJJJ-MM-TTTHH:mm:ss

Response parameters for DCC requests

Terminal configuration

Retrieve the terminal configuration data from the

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Platform-Kurz
PageWithExcerpt	Wording

.

In order to retrieve the POS terminal configuration data, please use the following URL:

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	BaseURL
PageWithExcerpt	Wording

posConfig.aspx

For the Integration test system, please use: https://dev.computop.de/Paygate/posConfig.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	1753886263935_-872910117
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt

MultiExcerptName	POS_config_request

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1753886263936_1780151500
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
MessageType	an2	M	Message type of request. Returned in response. Here always: F2 (Explanations in the appendix under Message Types)	Nachrichtentyp der Anfrage.Wird als Antwort zurückgegeben. Hier immer: F2 (Erläuterungen im Anhang unter Nachrichtentypen)

Table Excerpt Include

static	true
name	MerchantID
page	MerchantID
type	page

Key	Format	CND	Description	Beschreibung
POSTerminalID	an..20	M	TerminalID of the card reader	TerminalID des Kartenlesers
Device	an16	M	Serial number of the card reader	Seriennummer des Kartenlesers
Manufacturer	an..30	M	Manufacturer of the card reader (associated with the serial number)	Hersteller des Kartenlesers (verbunden mit der Seriennummer)
TerminalModel	..60	O	Model or type of card reader	Modell oder Typ des Kartenlesers
DMACKSN	an..20	M	DUKPT Key Serial Number used to generate the DUKPT MAC (parameter DMAC).	DUKPT-Schlüsselseriennummer, die zum Generieren des DUKPT-MAC (Parameter DMAC) verwendet wird
DMAC	an16	M	DUKPT Message Authentication Code, which is formed over the entire message (all parameters except DMAC). See chapter "Formation of the DUKPTMAC".	DUKPT-Nachrichtenauthentifizierungscode, der über die gesamte Nachricht (alle Parameter außer DMAC) gebildet wird.Siehe Kapitel „Bildung des DUKPTMAC“.

Parameters for retrieving POS terminal configuration data

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Response_Intro
PageWithExcerpt	Reuse API

Table Filter

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

Multiexcerpt

MultiExcerptName	POS_config_response

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1753886285497_-2054549643
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
MessageType	an2	M	Message type transmitted in the request	In der Anfrage übermittelter Nachrichtentyp

Table Excerpt Include

static	true
name	MID
page	mid
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	Status_OK_FAILED
page	Status
type	page

Table Excerpt Include

static	true
name	Description
page	Description
type	page

Table Excerpt Include

static	true
name	Code
page	Code
type	page

Key	Format	CND	Description	Beschreibung
ConfigData	ans..8192	M	Configuration data in the agreed format	Konfigurationsdaten im vereinbarten Format
POSTerminalID	an...20	M	TerminalID of the card reader	TerminalID des Kartenlesers
DMACKSN	an..20	M	DUKPT Key Serial Number used to generate the DUKPT MAC (parameter DMAC)	DUKPT-Schlüsselseriennummer, die zum Generieren des DUKPT-MAC (Parameter DMAC) verwendet wird
DMAC	an16	M	DUKPT Message Authentication Code for the entire response	DUKPT-Nachrichtenauthentifizierungscode für die gesamte Antwort

Response parameters for retrieving POS terminal configuration data

Terminal configuration v2 (Special interface with no Merchant ID in request)

Retrieve the terminal configuration data from the

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Platform-Kurz
PageWithExcerpt	Wording

.

In order to retrieve the POS terminal configuration data, please use the following URL:

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	BaseURL
PageWithExcerpt	Wording

posConfigExt.aspx

For the Integration test system, please use: https://dev.computop.de/Paygate/posConfigExt.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	1753886312567_1462054903
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt

MultiExcerptName	POS_config2_request

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1753886312568_-2008246738
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
MessageType	an2	M	Message type of request. Returned in response. Here always: F2 (Explanations in the appendix under Message Types)	Nachrichtentyp der Anfrage.Wird als Antwort zurückgegeben. Hier immer: F2 (Erläuterungen im Anhang unter Nachrichtentypen)

Key	Format	CND	Description	Beschreibung
POSTerminalID	an..20	M	TerminalID of the card reader	TerminalID des Kartenlesers
Device	an16	M	Serial number of the card reader	Seriennummer des Kartenlesers
Manufacturer	an..30	M	Manufacturer of the card reader (associated with the serial number)	Hersteller des Kartenlesers (verbunden mit der Seriennummer)
TerminalModel	..60	O	Model or type of card reader	Modell oder Typ des Kartenlesers
DMACKSN	an..20	M	DUKPT Key Serial Number used to generate the DUKPT MAC (parameter DMAC).	DUKPT-Schlüsselseriennummer, die zum Generieren des DUKPT-MAC (Parameter DMAC) verwendet wird
DMAC	an16	M	DUKPT Message Authentication Code, which is formed over the entire message (all parameters except DMAC). See chapter "Formation of the DUKPTMAC".	DUKPT-Nachrichtenauthentifizierungscode, der über die gesamte Nachricht (alle Parameter außer DMAC) gebildet wird.Siehe Kapitel „Bildung des DUKPTMAC“.

Parameters for retrieving POS terminal configuration data

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Response_Intro
PageWithExcerpt	Reuse API

Table Filter

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

Multiexcerpt

MultiExcerptName	POS_config2_response

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1753886334308_1777965302
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
MessageType	an2	M	Message type transmitted in the request	In der Anfrage übermittelter Nachrichtentyp

Table Excerpt Include

static	true
name	MID
page	mid
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	Status_OK_FAILED
page	Status
type	page

Table Excerpt Include

static	true
name	Description
page	Description
type	page

Table Excerpt Include

static	true
name	Code
page	Code
type	page

Key	Format	CND	Description	Beschreibung
ConfigData	ans..8192	M	Configuration data in the agreed format	Konfigurationsdaten im vereinbarten Format
POSTerminalID	an...20	M	TerminalID of the card reader	TerminalID des Kartenlesers
DMACKSN	an..20	M	DUKPT Key Serial Number used to generate the DUKPT MAC (parameter DMAC)	DUKPT-Schlüsselseriennummer, die zum Generieren des DUKPT-MAC (Parameter DMAC) verwendet wird
DMAC	an16	M	DUKPT Message Authentication Code for the entire response	DUKPT-Nachrichtenauthentifizierungscode für die gesamte Antwort

Response parameters for retrieving POS terminal configuration data

Payment facilitator

To use the functionality of the Payment Facilitator, you need to add the following parameters to your request.

The following table describes the request parameters:

Table Filter

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

Multiexcerpt

MultiExcerptName	POS_payment-facilitator

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1753886384720_722442003
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
subMID	ans..15	C	SubMerchantID, which is assigned by the Payment Facilitator and transmitted in the call to identify submerchants in the transaction process.	SubMerchantID, die vom Zahlungsvermittler vergeben und im Aufruf übermittelt wird, um Subhändler im Transaktionsprozess zu identifizieren.
subMIDName	ans..22	C	Name of the SubMerchantID	Name der SubMerchantID
subMIDAddrCity	ans..13	C	City of SubMerchantID	Ort der SubMerchantID
subMIDAddrCountryCode	a2	C	Country code of the SubMerchantID in the format ISO-3166-1, alphanumerical 2-digit	Ländercode der SubMerchantID im Format ISO-3166-1, alphanumerisch 2-stellig
subMIDAddrStreet	ans..38	C	Road of SubMerchantID	Straße der SubMerchantID
subMIDAddrZip	ans..10	C	Postal code of SubMerchantID	Postleitzahl der SubMerchantID
subMIDAddrState	ans3	C	Federal state of SubMerchantID	Bundesland der SubMerchantID

Additional parameters for using the Payment Facilitator

CUT-OFF

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

Multiexcerpt

MultiExcerptName	POS_cutoff_request

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1753886410673_-4163927
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
MessageType	an2	M	Message type of request. Returned in response. Allowed value: CF (Explanations in the appendix under Message Types)	Nachrichtentyp der Anfrage.Wird als Antwort zurückgegeben. Zulässiger Wert: CF (Erläuterungen im Anhang unter Nachrichtentypen)

Table Excerpt Include

static	true
name	MerchantID
page	MerchantID
type	page

Table Excerpt Include

static	true
name	TransID
page	TransID
type	page

Key	Format	CND	Description	Beschreibung
POSTerminalID	an..20	M	TerminalID of the card reader	TerminalID des Kartenlesers
Device	an16	M	Serial number of the card reader	Seriennummer des Kartenlesers
cutoff	JSON	O	Base64 encoded JSON object	Base64-codiertes JSON-Objekt
DMACKSN	an..20	M	DUKPT Key Serial Number used to generate the DUKPT MAC (parameter DMAC).	DUKPT-Schlüsselseriennummer, die zum Generieren des DUKPT-MAC (Parameter DMAC) verwendet wird
DMAC	an16	M	DUKPT Message Authentication Code, which is formed over the entire message (all parameters except DMAC). See chapter "Formation of the DUKPTMAC".	DUKPT-Nachrichtenauthentifizierungscode, der über die gesamte Nachricht (alle Parameter außer DMAC) gebildet wird.Siehe Kapitel „Bildung des DUKPTMAC“.

Parameters for Cut-Off

Example value of parameter: cutoff

Code Block

{
    "receiptNr": {
        "from": <receiptNrFrom>,
        "to": <receiptNrTo>
    },
    "numberOfTx": [
        {
            "brand":"VISA",
            "numberOfTx": <numberOfTx>,
            "checkSum": <checkSum>
        },
        {
            "brand":"MastereCard",
            "numberOfTx": <numberOfTx>,
            "checkSum": <checkSum>
        },
        {
            "brand":"Maestro",
            "numberOfTx": <numberOfTx>,
            "checkSum": <checkSum>
        },
        {
            "brand":"AMEX",
            "numberOfTx": <numberOfTx>,
            "checkSum": <checkSum>
        },
        {
            "brand":"DINERS",
            "numberOfTx": <numberOfTx>,
            "checkSum": <checkSum>
        },
         {
            "brand":"Discover",
            "numberOfTx": <numberOfTx>,
            "checkSum": <checkSum>
        },
        {
            "brand":"JCB",
            "numberOfTx": <numberOfTx>,
            "checkSum": <checkSum>
        },
         {
            "brand":"CUP",
            "numberOfTx": <numberOfTx>,
            "checkSum": <checkSum>
        },
        {
            "brand":"GIROCARD",
            "numberOfTx": <numberOfTx>,
            "checkSum": <checkSum>
        },
        {
            "brand":"SEPAELV",
            "numberOfTx": <numberOfTx>,
            "checkSum": <checkSum>
        }
    ]
}

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Response_Intro
PageWithExcerpt	Reuse API

Table Filter

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

Multiexcerpt

MultiExcerptName	POS_cutoff_response

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1753886429239_1848728100
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
MessageType	an2	M	Message type transmitted in the request	In der Anfrage übermittelter Nachrichtentyp

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	C	Only on success: Merchant's transaction number.	Nur bei Erfolg: Transaktionsnummer des Händlers.
POSTerminalID	an..20	M	TerminalID of the card reader	TerminalID des Kartenlesers
Status	a..50	M	OK (URLSuccess) or FAILED (URLFailure). Refers to the inquire request itself.	OK (URLSuccess) oder FAILED (URLFailure). Bezieht sich auf die Anfrage selbst.

Table Excerpt Include

static	true
name	Description
page	Description
type	page

Table Excerpt Include

static	true
name	Code
page	Code
type	page

Key	Format	CND	Description	Beschreibung
DMACKSN	an..20	M	DUKPT Key Serial Number used to generate the DUKPT MAC (parameter DMAC).	DUKPT-Schlüsselseriennummer, die zum Generieren des DUKPT-MAC (Parameter DMAC) verwendet wird
DMAC	an16	M	DUKPT Message Authentication Code, which is formed over the entire message (all parameters except DMAC). See chapter "Formation of the DUKPTMAC".	DUKPT-Nachrichtenauthentifizierungscode, der über die gesamte Nachricht (alle Parameter außer DMAC) gebildet wird.Siehe Kapitel „Bildung des DUKPTMAC“.

Response parameters for Cut-Off

EMV data elements

The EMV data block is sent as hex string. The data is TLV coded. A detailed description of TLV and the EMV tags can be found in the EMV Specification "EMV v4.3 Book 3 Application Specification", which can be downloaded here: https://www.emvco.com/specifications.aspx?id=223
See Annex A for a tag list.

The following tags are required for a credit card payment when they are provided by the terminal or the card:

Tag	Description
9F06	Application Identifier (AID)
9F26	Application Cryptogram
9F27	Cryptogram Information Data
9F10	Issuer Application Data (IAD)
9F37	Unpredictable Number
9F36	Application Trx. Counter (ATC)
95	Terminal Verification Results
9A	Transaction Date
9C	Transaction Type
9F02	Transaction Amount
5F2A	Transaction Currency Code
82	Application Interchange Profile
9F1A	Terminal Country Code
9F03	Amount, Other (Cashback Amount if applicable)
9F33	Terminal Capabilities Must be sent for SEPAELV transactions.
9F34	CVM Results Must be sent for SEPAELV transactions.
9F35	Terminal Type
9F1E	Interface Device (IFD) Serial No
9F53	Transaction Category Code
84	Dedicated File Name
9F09	Terminal Application Version No.
9F41	Transaction Sequence Counter
DF01	Issuer Script Results
DF02	Error Detection
9F7C	Customer Exclusive Data
9F6E	Form Factor Indicator

The following tags are optional for a credit card payment:

Tag	Description
57	Track2 Equivalent Data
5F20	Cardholder Name

The following tag is for a CLV+ payment:

Tag	Description
DF64	Mandate ID, it will be returned when signature from customer first time obtained and Mandate ID is created for future frictionless payment

Response tags at SEPA-ELV

For SEPA ELV, the answer can optionally contain the following tags:

5F53 (IBAN)
DF65 (creditor ID)

Note: If the fields are present, they must also be printed on the document.
5F53 (IBAN)
Length: 34 bytes, Format: on
The IBAN may be optionally included in the BMP55 of the reply message (210,1410). It is a maximum of 34 digits long and must not contain special characters and lowercase letters. In Germany, a 22-digit IBAN is used.
If the IBAN is included in the BMP55, it is printed completely or masked by the terminal from the BMP55 taken on the handler and customer receipt below the map data using masking rule (Tag DF25)
Example of masking:
IBAN DE8553-0002
5F53 16 44 45 35 35 33 32 39 32 33 34 30 32 34 30 30 30 30 30 32
"DE85532912340123600002"
DF65 (creditor ID)
Length: 8 - 35 bytes, Format: ans
In the case of online transactions, the operator computer can optionally include a creditor ID in the reply message (BMP55, day DF65-). If a creditor ID (DF65) is included in the BMP55 of the reply message, it will be included on the trader or instead of the configured (conecrater "Gl") Customer document printed.
Example:
DF65 12 444539385A5A5A3039393939393939393939393939393939393939

Formation of the DUKPTMAC

To perform messaging authentication, a MAC (Message Authentication Code) is added to the message by the sender and verified by the recipient.

The input block for calculating the MAC is structured as follows: Calculate an SHA-256 via the message; including the MessageType field + the MerchantID field up to the DUKPTMAC field (DMAC, excluded).
This result is an input block of 32 bytes, which is used to calculate the MAC.

The MAC is generated using a work key derived from the 3-DES DUKPT security scheme. The output of the MAC calculation is an 8-byte message authentication block (MAB) consisting of a MAC (highest quality 4 bytes) and a MAC remain (lowest 4 bytes). The MAC field of the message is set to the MAB. MAC generation and verification is done according to ANSI X9.19.

Message Types

Overview types

01 Purchase (Sale)
02 Reversal
03 Refund
05 Authorization (Reservation)
06 Incremental Auth
0B Capture
CF Cut Off
E0 HSM as a Service
F0 Automatic reversal
F1 Inquire
F2 Terminal Configuration

Explanations

Tag	Description
01 Purchase (CT: Sale)	Authorization and Capture in one transaction is called Sale
02 Reversal	Reversal of Authorization; Reversal of Sales (only possible if settlement has not yet taken place at the acquirer. Otherwise only credit is possible)
03 Refund (CT: Credit)	Refund at POS without previous Sale
05 (Pre-)Authorize	Increment possible (CT: Reservation)
06 Pre-Authorization	Increment possible (CT: Reservation)
0B Capture	Capture an Authorization

Space shortcuts

Page tree

Versions Compared

Old Version 5

New Version 6

Key

On this page

Multiexcerpt include
SpaceWithExcerpt EN
MultiExcerptName Platform-Kurz
PageWithExcerpt Wording
interface

General terminal requests

Payments by credit card: reservation / booking

Booking notification (Capture)

Payments as SEPA-ELV

Payments by girocard

Payments with Alipay / Wechat

Status checking by the terminal

Instalment purchase with easyCredit

Inquire

Card Reversal / Automatic Reversal

Manual Reversal

Credit without reference

POS Increment

DCC transactions via VPN

Terminal configuration

Terminal configuration v2 (Special interface with no Merchant ID in request)

Payment facilitator

CUT-OFF

EMV data elements

Response tags at SEPA-ELV

Formation of the DUKPTMAC

Message Types

Overview types

Explanations

Paygate

Computop

Help

Intranet Tools

Space shortcuts

Page tree

Page History

Versions Compared

Old Version 5

New Version 6

Key

On this page

Multiexcerpt includeSpaceWithExcerptENMultiExcerptNamePlatform-KurzPageWithExcerptWording interface

General terminal requests

Payments by credit card: reservation / booking

Booking notification (Capture)

Payments as SEPA-ELV

Payments by girocard

Payments with Alipay / Wechat

Status checking by the terminal

Instalment purchase with easyCredit

Inquire

Card Reversal / Automatic Reversal

Manual Reversal

Credit without reference

POS Increment

DCC transactions via VPN

Terminal configuration

Terminal configuration v2 (Special interface with no Merchant ID in request)

Payment facilitator

CUT-OFF

EMV data elements

Response tags at SEPA-ELV

Formation of the DUKPTMAC

Message Types

Overview types

Explanations

Multiexcerpt include
SpaceWithExcerpt EN
MultiExcerptName Platform-Kurz
PageWithExcerpt Wording
interface