You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Next »

Diese Dokumentation soll verschiedenen POS-Partnern die Spezifikationen der Computop Paygate POS API zur Verfügung stellen, damit sie POS-Zahlungen über verschiedene Acquirer-Anbindungen integrieren und verarbeiten können

WICHTIG: Je nach gewünschter Anbindungsart (z. B. P2PE, VNP oder SSL) sind bestimmte Parameter obligatorisch und umgekehrt. Dies gilt auch für die Implementierung bestimmter Zahlungsmethoden wie SEPA ELV, CLV+, Girocard oder MTT ATB, für die zusätzliche Daten aus der Standardanfrage benötigt werden.

Für detailliertere Empfehlungen zu den Datenanforderungen für bestimmte Produkte oder Integrationsarten wenden Sie sich bitte an das Computop-Team.

Auf dieser Seite



Paygate-Schnittstelle

Definitionen

Datenformate

FormatBeschreibung

a

alphabetisch

as

alphabetisch mit Sonderzeichen

n

numerisch

an

alphanumerisch

ans

alphanumerisch mit Sonderzeichen

ns

numerisch mit Sonderzeichen

bool

Bool’scher Ausdruck (true oder false)

3

feste Länge mit 3 Stellen/Zeichen

..3

variable Länge mit maximal 3 Stellen/Zeichen

enum

Aufzählung erlaubter Werte

dttm

ISODateTime (JJJJ-MM-TTThh:mm:ss)


Abkürzungen

AbkürzungBeschreibungKommentar

CND

Bedingung (condition)


M

Pflicht (mandatory)

Wenn ein Parameter Pflicht ist, dann muss er vorhanden sein

O

optional

Wenn ein Parameter optional ist, dann kann er vorhanden sein, ist aber nicht erforderlich

C

bedingt (conditional)

Wenn ein Parameter bedingt ist, dann gibt es eine Bedingungsregel, die angibt, ob er Pflicht oder optional ist


Hinweis: Bitte beachten Sie, dass die Bezeichnungen der Parameter in Groß- oder Kleinbuchstaben zurückgegeben werden können.


Allgemeine Terminalanfragen

Die hier aufgeführten Parameter gelten grundsätzlich für alle Anfragen eines Terminals an das Paygate.

Bei der speziellen Zahlungsart finden Sie alle Parameter, die für die jeweilige Zahlungsart gelten. Bitte beachten Sie daher die Beschreibung der gewünschten Zahlungsart.

Einige Parameter gelten nur für Anfragen aus bestimmten Bereichen: DCC: Dynamische Währungsumrechnung, MTT: Mass Transit Transaction.

Um eine Zahlung mit POS Payment durchzuführen, verwenden Sie bitte folgende URL:

Für das Integrationstestsystem verwenden Sie bittehttps://dev.computop.de/Paygate/posPayment.aspx.


Hinweis: Aus Sicherheitsgründen lehnt das Paygate alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp.

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...

Key

Format

CND

Description

MessageTypean2MMessage type of request. Returned in response. For authorized values, see explanations in the appendix under Message Types.

KeyFormatCNDDescription

MerchantID

ans..30

M

MerchantID, assigned by Computop. Additionally this parameter has to be passed in plain language too.

KeyFormatCNDDescription
TransID

ans..64

MTransactionID provided by you which should be unique for each payment

KeyFormatCNDDescription
refnr

ans..30

O

Merchant’s unique reference number

Key

Format

CND

Description

Amountn..10M

Amount in the smallest currency unit (e.g. EUR Cent). Please contact the Computop Helpdesk, 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.

KeyFormatCNDDescription
Currency

a3

M

Currency, three letters DIN / ISO 4217, e.g. EUR, USD, GBP. Please find an overview here: A1 Currency table

KeyFormatCNDDescription

MAC

an64

M
Hash Message Authentication Code (HMAC) with SHA-256 algorithm. Details can be found here:

Key

Format

CND

Description

POSTerminalIDan..20MTerminalID of the card reader

Device

an16MSerial number of the card reader
Manufactureran..30MManufacturer of the card reader (associated with the serial number)
TerminalModel..60OModel or type of card reader
CCNrn8.19CPAN of the card
CCBrandan..22MCard brand or name of another payment method
EMVDataan..2048C

Block for additional data. If there are no additional data, e.g. with MSR, then completely omit this parameter.

OrderDescans..200ODescription of purchased goods, unit prices etc.
LocalDaten4C

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.

LocalTimen6C

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.

ReceiptNrn4C

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)

ExtraCapabilitiesan4O

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

DMACKSNan..20C

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

DMACan16C

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.

Allgemeine Parameter für Terminalzahlungen mit POS Payment


Die folgende Tabelle beschreibt die Parameter, die das Paygate als Antwort zurückgibt:

(info) es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden

(info) die Parameter (z.B. mid, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...

Key

Format

CND

Description

MessageTypean2M

Message type transmitted in the request

KeyFormatCNDDescription

mid

ans..30

M

MerchantID, assigned by Computop

KeyFormatCNDDescription
PayID

an32

M

ID assigned by Paygate for the payment, e.g. for referencing in batch files as well as for capture or credit request.

KeyFormatCNDDescription
XID

an32

M

ID for all single transactions (authorisation, capture, credit note) for one payment assigned by Paygate

KeyFormatCNDDescription
TransID

ans..64

MTransactionID provided by you which should be unique for each payment

KeyFormatCNDDescription
refnr

ans..30

O

Merchant’s unique reference number

KeyFormatCNDDescription
Status

a..50

M

OK (URLSuccess) or FAILED (URLFailure)

KeyFormatCNDDescription
Description

ans..1024

M
Further details in the event that payment is rejected. Please do not use the Description but the Code parameter for the transaction status analysis!

KeyFormatCNDDescription
Code

an8

M

Error code according to Paygate Response Codes (A4 Error codes)

Key

Format

CND

Description

POSTerminalIDan..20MTerminalID of the card reader
EMVDataan..2048C

Block for additional data

ConfigUpdatea3O

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.

DMACKSNan..20M

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

DMACan16M

DUKPT Message Authentication Code for the entire response

Allgemeine Antwortparameter für Terminalzahlungen mit POS Payment


Zahlungen per Kreditkarte: Reservierung / Buchung

Einige Parameter gelten nur für Anfragen aus bestimmten Bereichen: DCC: Dynamische Währungsumrechnung, MTT: Mass Transit Transaction.

Um eine POS-Zahlung mit Kreditkarte vorzunehmen, verwenden Sie bitte folgende URL:

Für das Integrationstestsystem verwenden Sie bittehttps://dev.computop.de/Paygate/posPayment.aspx.


Hinweis: Aus Sicherheitsgründen lehnt das Paygate alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp.

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...

Key

Format

CND

Description

MessageTypean2MMessage type of request. Returned in response. Allowed values:
01 for payment booking and
05 for reservation / authorization
(Explanations in the appendix under Message Types)

KeyFormatCNDDescription

MerchantID

ans..30

M

MerchantID, assigned by Computop. Additionally this parameter has to be passed in plain language too.

KeyFormatCNDDescription
TransID

ans..64

MTransactionID provided by you which should be unique for each payment

KeyFormatCNDDescription
refnr

ans..30

O

Merchant’s unique reference number

Key

Format

CND

Description

Amountn..10M

Amount in the smallest currency unit (e.g. EUR Cent). Please contact the Computop Helpdesk, 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.

Key

Format

CND

Description

CashbackAmountn..10OCashback Amount in case such transaction type is submitted. Given in the smallest currency unit (e.g. EUR Cent).

KeyFormatCNDDescription
Currency

a3

M

Currency, three letters DIN / ISO 4217, e.g. EUR, USD, GBP. Please find an overview here: A1 Currency table

KeyFormatCNDDescription

MAC

an64

M
Hash Message Authentication Code (HMAC) with SHA-256 algorithm. Details can be found here:

Key

Format

CND

Description

POSTerminalIDan..20MTerminalID of the card reader

Device

an16MSerial number of the card reader
Manufactureran..30MManufacturer of the card reader (associated with the serial number)
TerminalModel..60OModel or type of card reader
CCNrn8.19CMandatory if the credit card number is not passed in the DataEncrypted parameter
CCBrandan..22MCard brand: VISA, MasterCard, Maestro, AMEX, DINERS, JCB, CUP. Please note the spelling! 
Always specify SEPAELV at ELV!
CCCVCn4OCard check number: The last 3 digits on the credit card sub-type, at AMEX 4 digits.
CCExpiryn6MExpiration date of credit card (YYYYMM), e.g. 202507
CCSeqNon3OCard sequence number
Track2an..224CMandatory with Magnetic Stripe Read (MSR). Data of the track2 for MSR or Track2EquivalentData (Tag 57) (in Hex formatting).
EMVDataan..2048C

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.

EntryModen3M

POS entry mode

PINDataan..128C

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

PINKSNan..20C

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

DataEncryptedan..2048O

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

DataKSNan..20C

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

OrderDescans..200ODescription of purchased goods, unit prices etc.
ChDescan..25OText shown on the customer's credit card statement next to the payee
LocalDaten4C

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.

LocalTimen6C

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.

ReceiptNrn4C

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)

dccStatusa1C

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

dccRateValueans13C

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

baseAmountn..10C

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

baseCurrencya3C

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

dccMarginans..5O

DCC margin/markup percentage

dccCommissionans..12O

DCC commission percentage

dccSourceans..32O

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

dccTimestampans..20O

Timestamp of exchange rate

dccRequestIdan..32O

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

ContractIDn..8O

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

AccVerifya..3O

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.

RTFan1O

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

PACFormatn2O

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.

ExtraCapabilitiesan4O

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

DuplicateATCa3CMandatory 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
DMACKSNan..20C

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

DMACan16C

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.

dccRateIDans..20O

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

TraceNran..6C

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

ConditionCodean..2C

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

Parameter für POS-Zahlungen mit Kreditkarte


Die folgende Tabelle beschreibt die Parameter, die das Paygate als Antwort zurückgibt:

(info) es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden

(info) die Parameter (z.B. mid, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...

Key

Format

CND

Description

MessageTypean2M

Message type transmitted in the request

KeyFormatCNDDescription

mid

ans..30

M

MerchantID, assigned by Computop

KeyFormatCNDDescription
PayID

an32

M

ID assigned by Paygate for the payment, e.g. for referencing in batch files as well as for capture or credit request.

KeyFormatCNDDescription
XID

an32

M

ID for all single transactions (authorisation, capture, credit note) for one payment assigned by Paygate

KeyFormatCNDDescription
TransID

ans..64

MTransactionID provided by you which should be unique for each payment

KeyFormatCNDDescription
refnr

ans..30

O

Merchant’s unique reference number

KeyFormatCNDDescription
Status

a..50

M

OK (URLSuccess) or FAILED (URLFailure)

KeyFormatCNDDescription
Description

ans..1024

M
Further details in the event that payment is rejected. Please do not use the Description but the Code parameter for the transaction status analysis!

KeyFormatCNDDescription
Code

an8

M

Error code according to Paygate Response Codes (A4 Error codes)

Key

Format

CND

Description

POSTerminalIDan..20MTerminalID of the card reader
CodeExtan2MResponse code of the acquirer
ApprovalCoden..6CApproval code of the acquirer (also known as the authCode or authorization . called Response). Configured at the merchant.
EMVDataan..2048C

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

VUNrans..20O

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

TerminalIDans..20O

TerminalID, which Computop exchanges with the acquirer. Configured at the merchant.

AQans..30O

Abbreviation of the acquirers. Configured at the merchant.

TrxTimeans21O

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

AdditionalResponseDataans..99O

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

PCNrn..16O

Pseudo card number: Paygate 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.

TransactionIDan..56C

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

ConfigUpdatea3O

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.

Last4CardholderPANn..4O

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

PARans..999O

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

EmbossedPANPCNrn..19O

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.

EmbossedPANExpiryDaten..4O

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

OriginalCodeans..3O

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

schemeReferenceIDans..64O

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

DMACKSNan..20M

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

DMACan16M

DUKPT Message Authentication Code for the entire response

Antwortparameter für POS-Zahlungen mit Kreditkarte


Buchungsbenachrichtigung (Capture)

Einige Parameter gelten nur für Anfragen aus bestimmten Bereichen: DCC: Dynamische Währungsumrechnung, MTT: Mass Transit Transaction.

Um eine POS-Zahlung zu buchen, verwenden Sie bitte folgende URL:

Für das Integrationstestsystem verwenden Sie bittehttps://dev.computop.de/Paygate/posPayment.aspx.


Hinweis: Aus Sicherheitsgründen lehnt das Paygate alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp.

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...

Key

Format

CND

Description

MessageTypean2MMessage type of request. Returned in response. Allowed values:
0B for Booking Notification
(Explanations in the appendix under Message Types)

KeyFormatCNDDescription

MerchantID

ans..30

M

MerchantID, assigned by Computop. Additionally this parameter has to be passed in plain language too.

KeyFormatCNDDescription
PayID

an32

M

ID assigned by Paygate for the payment, e.g. for referencing in batch files as well as for capture or credit request.

KeyFormatCNDDescription
TransID

ans..64

MTransactionID provided by you which should be unique for each payment

KeyFormatCNDDescription
refnr

ans..30

O

Merchant’s unique reference number

Key

Format

CND

Description

Amountn..10M

Amount in the smallest currency unit (e.g. EUR Cent). Please contact the Computop Helpdesk, 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.

KeyFormatCNDDescription
Currency

a3

M

Currency, three letters DIN / ISO 4217, e.g. EUR, USD, GBP. Please find an overview here: A1 Currency table

KeyFormatCNDDescription

MAC

an64

M
Hash Message Authentication Code (HMAC) with SHA-256 algorithm. Details can be found here:

Key

Format

CND

Description

POSTerminalIDan...20MTerminalID of the card reader

Device

an16MSerial number of the card reader
Manufactureran..30MManufacturer of the card reader (associated with the serial number)
TerminalModel..60OModel or type of card reader
LocalDaten4M

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.

LocalTimen6M

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.

DMACKSNan..20C

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

DMACan16C

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.

Parameter für Buchungen von POS-Zahlungen


Die folgende Tabelle beschreibt die Parameter, die das Paygate als Antwort zurückgibt:

(info) es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden

(info) die Parameter (z.B. mid, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...

Key

Format

CND

Description

MessageTypean2MMessage type transmitted in the request

KeyFormatCNDDescription

mid

ans..30

M

MerchantID, assigned by Computop

KeyFormatCNDDescription
PayID

an32

M

ID assigned by Paygate for the payment, e.g. for referencing in batch files as well as for capture or credit request.

KeyFormatCNDDescription
XID

an32

M

ID for all single transactions (authorisation, capture, credit note) for one payment assigned by Paygate

KeyFormatCNDDescription
TransID

ans..64

MTransactionID provided by you which should be unique for each payment

KeyFormatCNDDescription
refnr

ans..30

O

Merchant’s unique reference number

KeyFormatCNDDescription
Status

a..50

M

OK (URLSuccess) or FAILED (URLFailure)

KeyFormatCNDDescription
Description

ans..1024

M
Further details in the event that payment is rejected. Please do not use the Description but the Code parameter for the transaction status analysis!

KeyFormatCNDDescription
Code

an8

M

Error code according to Paygate Response Codes (A4 Error codes)

Key

Format

CND

Description

POSTerminalIDan...20MTerminalID of the card reader
ConfigUpdatea3O

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.

DMACKSNan..20M

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

DMACan16M

DUKPT Message Authentication Code for the entire response

Antwortparameter für Buchungen von POS-Zahlungen


Zahlungen als SEPA-ELV

Parameter siehe Abschnitt Kreditkartenzahlung.
Wichtig: Der Parameter CCBrand muss den Wert SEPAELV haben.


Zahlungen per Girocard

Einige Parameter gelten nur für Anfragen aus bestimmten Bereichen: DCC: Dynamische Währungsumrechnung, MTT: Mass Transit Transaction.

Um eine POS-Zahlung mit Girocard durchzuführen, verwenden Sie bitte folgende URL:

Für das Integrationstestsystem verwenden Sie bittehttps://dev.computop.de/Paygate/posPayment.aspx.


Hinweis: Aus Sicherheitsgründen lehnt das Paygate alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp.

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...

Key

Format

CND

Description

MessageTypean2MMessage type of request. Returned in response. Allowed values:
01 for authorization and automated booking
(Explanations in the appendix under Message Types)
ProcessModean2MPossible values:
00: Offline
01: Online
0E: Emergency Offline (terminal is not connected to accept server) 
EC: Emergengy in EC network operation

KeyFormatCNDDescription

MerchantID

ans..30

M

MerchantID, assigned by Computop. Additionally this parameter has to be passed in plain language too.

KeyFormatCNDDescription
TransID

ans..64

MTransactionID provided by you which should be unique for each payment

KeyFormatCNDDescription
refnr

ans..30

O

Merchant’s unique reference number

Key

Format

CND

Description

Amountn..10M

Amount in the smallest currency unit (e.g. EUR Cent). Please contact the Computop Helpdesk, 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.

KeyFormatCNDDescription
Currency

a3

M

Currency, three letters DIN / ISO 4217, e.g. EUR, USD, GBP. Please find an overview here: A1 Currency table

KeyFormatCNDDescription

MAC

an64

M
Hash Message Authentication Code (HMAC) with SHA-256 algorithm. Details can be found here:

Key

Format

CND

Description

POSTerminalIDan...20MTerminalID of the card reader

Device

an16MSerial number of the card reader
Manufactureran..30MManufacturer of the card reader (associated with the serial number)
TerminalModel..60OModel or type of card reader
CCNrn8.19MPAN of the girocard
CCBrandan...22MFixed value: girocard
CCExpiryn6MExpiration date of girocard (YYYYMM), e.g. 202507
CCSeqNrn3OCard sequence number
Track2an..224MObligation to authorise or emergency operation. Data of the track2 for MSR or Track2EquivalentData (Tag 57) (in Hex formatting).
EMVDataan..2048C

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.

EntryModen3M

POS entry mode

PINDataan..128C

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

PINKSNan..20C

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

OrderDescans..200ODescription of purchased goods, unit prices etc.
LocalDaten4M

Date of the transaction. Format: MMTT

LocalTimen6M

Time of the transaction. Format: hhmmss

ReceiptNrn4M

Number for the document. Will be continuously increased. Overflow to 9999.

TerminalDataan...99M

Terminal data includes: online time, POS data and approval number of the terminal. Format: Hex, TLV-coded (see also TA BMP 61).

ConditionCoden2C

Condition code. Values from 00 to 99 as described in TA under BMP 25.

TraceNrn6M

Continuous 6-digit decimal. Is incremented for each transaction as described in TA.

PACFormatn2O

Defines the PIN ISO format used. 10: ISO-0 11: ISO-1

At girocard, the PIN ISO 1 format is allowed.

ExtraCapabilitiesan4O

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

DMACKSNan...20C

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

DMACan16C

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.

Parameter für POS-Zahlungen mit Girocard


Die folgende Tabelle beschreibt die Parameter, die das Paygate als Antwort zurückgibt:

(info) es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden

(info) die Parameter (z.B. mid, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...

Key

Format

CND

Description

MessageTypean2M

Message type transmitted in the request

KeyFormatCNDDescription

mid

ans..30

M

MerchantID, assigned by Computop

KeyFormatCNDDescription
PayID

an32

M

ID assigned by Paygate for the payment, e.g. for referencing in batch files as well as for capture or credit request.

KeyFormatCNDDescription
XID

an32

M

ID for all single transactions (authorisation, capture, credit note) for one payment assigned by Paygate

KeyFormatCNDDescription
TransID

ans..64

MTransactionID provided by you which should be unique for each payment

KeyFormatCNDDescription
refnr

ans..30

O

Merchant’s unique reference number

KeyFormatCNDDescription
Status

a..50

M

OK (URLSuccess) or FAILED (URLFailure)

KeyFormatCNDDescription
Description

ans..1024

M
Further details in the event that payment is rejected. Please do not use the Description but the Code parameter for the transaction status analysis!

KeyFormatCNDDescription
Code

an8

M

Error code according to Paygate Response Codes (A4 Error codes)

Key

Format

CND

Description

POSTerminalIDan...20MTerminalID of the card reader
CodeExtan2MResponse code of the acquirer
ApprovalCoden..6CApproval code from the acquirer (also known as AuthCode or Authorisation ID. called Response). Configured at the merchant.
EMVDataan..2048C

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)

ConfigUpdatea3O

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.

DMACKSNan..20M

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

DMACan16M

DUKPT Message Authentication Code for the entire response

Anwortparameter für POS-Zahlungen mit Girocard


Zahlungen mit Alipay / Wechat

Zahlungen können am Terminal über Alipay und Wechat erfolgen. Einige Parameter gelten nur für Anfragen aus bestimmten Bereichen: DCC: Dynamische Währungsumrechnung, MTT: Mass Transit Transaction.

Um eine POS-Zahlung mit Alipay oder Wechat durchzuführen, verwenden Sie bitte folgende URL:

Für das Integrationstestsystem verwenden Sie bittehttps://dev.computop.de/Paygate/posPayment.aspx.


Hinweis: Aus Sicherheitsgründen lehnt das Paygate alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp.

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...

Key

Format

CND

Description

MessageTypean2MMessage type of request. Returned in response. Allowed values:
01 
(Explanations in the appendix under Message Types)

KeyFormatCNDDescription

MerchantID

ans..30

M

MerchantID, assigned by Computop. Additionally this parameter has to be passed in plain language too.

KeyFormatCNDDescription
TransID

ans..64

MTransactionID provided by you which should be unique for each payment

KeyFormatCNDDescription
refnr

ans..30

O

Merchant’s unique reference number

Key

Format

CND

Description

Amountn..10M

Amount in the smallest currency unit (e.g. EUR Cent). Please contact the Computop Helpdesk, 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.

KeyFormatCNDDescription
Currency

a3

M

Currency, three letters DIN / ISO 4217, e.g. EUR, USD, GBP. Please find an overview here: A1 Currency table

Key

Format

CND

Description

POSTerminalIDan..20MTerminalID of the card reader

Device

an16MSerial number of the card reader
Manufactureran..30MManufacturer of the card reader (associated with the serial number)
TerminalModel..60OModel or type of card reader
CCNrn8.19MNot required for Alipay / Wechat. Please pass 0000000000000000 (16 x 0), because mandatory.
CCBrandan..22MAt Alipay please always include, at Wechat always show Wechat!
OrderDescans..200ODescription of purchased goods, unit prices etc.
ContractIDn..8O

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

DMACKSNan..20C

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

DMACan16C

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.

Parameter für POS-Zahlungen mit Alipay oder Wechat


Die folgende Tabelle beschreibt die Parameter, die das Paygate als Antwort zurückgibt:

(info) es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden

(info) die Parameter (z.B. mid, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...

Key

Format

CND

Description

MessageTypean2M

Message type transmitted in the request

KeyFormatCNDDescription

mid

ans..30

M

MerchantID, assigned by Computop

KeyFormatCNDDescription
PayID

an32

M

ID assigned by Paygate for the payment, e.g. for referencing in batch files as well as for capture or credit request.

KeyFormatCNDDescription
XID

an32

M

ID for all single transactions (authorisation, capture, credit note) for one payment assigned by Paygate

KeyFormatCNDDescription
TransID

ans..64

MTransactionID provided by you which should be unique for each payment

KeyFormatCNDDescription
refnr

ans..30

O

Merchant’s unique reference number

Key

Format

CND

Description

POSTerminalIDan..20MTerminalID of the card reader
Statusa..50MAUTHORIZE-REQUEST or FAILED
Descriptionans..1024MPENDING, 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!
Coden8M

If a valid QR code can be submitted, then 21190985 or 23030985 for PENDING otherwise error code according to Paygate Response Codes (A4 Error codes)

EMVDataan..2048C

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"

ConfigUpdatea3O

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.

VUNrans..20M

PartnerID of the merchant

DMACKSNan..20M

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

DMACan16M

DUKPT Message Authentication Code for the entire response

Antwortparameter für POS-Zahlungen mit Alipay oder Wechat


Statusprüfung durch das Terminal

Durch wiederholtes Aufrufen der Datei pospayment.aspx (Polling, MessageType F1) wird ermittelt, ob der Vorgang in Alipay/WeChat freigegeben wurde. Dazu muss geprüft werden, ob der Antwortparameter LastStatus den Wert OK oder FAILED angenommen hat. Der Vorgang gilt als erfolgreich freigegeben, wenn LastStatus den Wert OK und der Parameter AmountAuth den Zahlungsbetrag anzeigt. Der Vorgang gilt als abgelehnt, wenn LastStatus den Wert FAILED zurückgibt. Solange Alipay/WeChat den Vorgang nicht freigegeben hat, enthält LastStatus den Wert AUTHORIZE-REQUEST
Für den Aufruf der Statusprüfung gelten die Parameter aus dem Abschnitt Abfrage (Inquire).


Ratenkauf mit easyCredit

Durchführung einer Ratenkauf-Transaktion mit einem Terminal. Einige Parameter gelten nur für Anfragen aus bestimmten Bereichen: DCC: Dynamische Währungsumrechnung, MTT: Mass Transit Transaction.

Um eine POS-Zahlung mit easyCredit durchzuführen, verwenden Sie bitte folgende URL:

Für das Integrationstestsystem verwenden Sie bittehttps://dev.computop.de/Paygate/posPayment.aspx.


Hinweis: Aus Sicherheitsgründen lehnt das Paygate alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp.

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...

Key

Format

CND

Description

MessageTypean2MMessage type of request. Returned in response. Allowed values:
01 
(Explanations in the appendix under Message Types)

KeyFormatCNDDescription

MerchantID

ans..30

M

MerchantID, assigned by Computop. Additionally this parameter has to be passed in plain language too.

KeyFormatCNDDescription
TransID

ans..64

MTransactionID provided by you which should be unique for each payment

KeyFormatCNDDescription
refnr

ans..30

O

Merchant’s unique reference number

Key

Format

CND

Description

Amountn..10M

Amount in the smallest currency unit (e.g. EUR Cent). Please contact the Computop Helpdesk, 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.

KeyFormatCNDDescription
Currency

a3

M

Currency, three letters DIN / ISO 4217, e.g. EUR, USD, GBP. Please find an overview here: A1 Currency table

KeyFormatCNDDescription

MAC

an64

M
Hash Message Authentication Code (HMAC) with SHA-256 algorithm. Details can be found here:

Key

Format

CND

Description

POSTerminalIDan..20MTerminalID of the card reader

Device

an16MSerial number of the card reader
Manufactureran..30MManufacturer of the card reader (associated with the serial number)
TerminalModel..60OModel or type of card reader
CCNrn8.19MPAN of the card. With easyCredit the PAN consisting of country prefix, short bank code, account number and check digit.
CCBrandan..22MPlease always include easyCredit with easyCredit!
CCExpiryn6CMandatory for credit cards. Expiration date of credit card (YYYDMM), e.g. 202507.
OrderDescans..200ODescription of purchased goods, unit prices etc.
ContractIDn..8O

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

DMACKSNan..20C

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

DMACan16C

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.

Parameter für POS-Zahlungen mit easyCredit


Die folgende Tabelle beschreibt die Parameter, die das Paygate als Antwort zurückgibt:

(info) es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden

(info) die Parameter (z.B. mid, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...

Key

Format

CND

Description

MessageTypean2M

Message type transmitted in the request

KeyFormatCNDDescription

mid

ans..30

M

MerchantID, assigned by Computop

KeyFormatCNDDescription
PayID

an32

M

ID assigned by Paygate for the payment, e.g. for referencing in batch files as well as for capture or credit request.

KeyFormatCNDDescription
XID

an32

M

ID for all single transactions (authorisation, capture, credit note) for one payment assigned by Paygate

KeyFormatCNDDescription
TransID

ans..64

MTransactionID provided by you which should be unique for each payment

KeyFormatCNDDescription
refnr

ans..30

O

Merchant’s unique reference number

KeyFormatCNDDescription
Status

a..50

M

OK (URLSuccess) or FAILED (URLFailure)

KeyFormatCNDDescription
Description

ans..1024

M
Further details in the event that payment is rejected. Please do not use the Description but the Code parameter for the transaction status analysis!

KeyFormatCNDDescription
Code

an8

M

Error code according to Paygate Response Codes (A4 Error codes)

Key

Format

CND

Description

Beschreibung

POSTerminalIDan...20MTerminalID of the card reader

TerminalID des Kartenlesers

CodeExtan2MResponse code from easyCredit posData.status code

Antwortcode von easyCredit posData.status code

ApprovalCoden..6CWith easyCredit the approval number

Bei easyCredit die Genehmigungsnummer

EMVDataan..2048C

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

VUNrans..20O

With easyCredit the sales office number of the store

Bei easyCredit die Verkaufsstellennummer des Geschäfts

ConfigUpdatea3O

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.

DMACKSNan..20M

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

DMACan16M

DUKPT Message Authentication Code for the entire response

DUKPT-Nachrichtenauthentifizierungscode für die gesamte Antwort

Antwortparameter für POS-Zahlungen mit easyCredit


Abfrage (Inquire)

Mit Hilfe der Inquire-Anfrage erhalten Sie Informationen zu einer Transaktion, von der Sie nur Ihre eigene TransID kennen. Einige Parameter gelten nur für Anfragen aus bestimmten Bereichen: DCC: Dynamische Währungsumrechnung, MTT: Mass Transit Transaction.

Um Informationen zu einer POS-Zahlung abzufragen, verwenden Sie bitte folgende URL:

Für das Integrationstestsystem verwenden Sie bittehttps://dev.computop.de/Paygate/posPayment.aspx.


Hinweis: Aus Sicherheitsgründen lehnt das Paygate alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp.

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...

Key

Format

CND

Description

MessageTypean2MMessage type of request. Returned in response. Allowed values in the attachment under Message Types. Here always:
F1
(Explanations in the appendix under Message Types)

KeyFormatCNDDescription

MerchantID

ans..30

M

MerchantID, assigned by Computop. Additionally this parameter has to be passed in plain language too.

KeyFormatCNDDescription
TransID

ans..64

MTransactionID provided by you which should be unique for each payment

KeyFormatCNDDescription

MAC

an64

M
Hash Message Authentication Code (HMAC) with SHA-256 algorithm. Details can be found here:

Key

Format

CND

Description

POSTerminalIDan..20MTerminalID of the card reader

Device

an16MSerial number of the card reader
Manufactureran..30C

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

Mandatory for SEPAELV and Girocard, optional for others.

TerminalModel..60OModel or type of card reader
DMACKSNan..20C

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

DMACan16C

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.

Parameter zur Abfrage von Informationen zu POS-Zahlungen


Die folgende Tabelle beschreibt die Parameter, die das Paygate als Antwort zurückgibt:

(info) es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden

(info) die Parameter (z.B. mid, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...

Key

Format

CND

Description

MessageTypean2M

Message type transmitted in the request

KeyFormatCNDDescription

mid

ans..30

M

MerchantID, assigned by Computop

KeyFormatCNDDescription
PayID

an32

M

ID assigned by Paygate for the payment, e.g. for referencing in batch files as well as for capture or credit request.

Key

Format

CND

Description

TransIDans..64C

Transaction number of the merchant. In the event of an error, not included in the answer.

Statusa..50M

OK or FAILED. Refers to the Inquire request itself.

KeyFormatCNDDescription
Description

ans..1024

M
Further details in the event that payment is rejected. Please do not use the Description but the Code parameter for the transaction status analysis!

KeyFormatCNDDescription
Code

an8

M

Error code according to Paygate Response Codes (A4 Error codes)

Key

Format

CND

Description

POSTerminalIDan...20MTerminalID of the card reader
AmountAuthn..10OAuthorized amount of the requested operation
AmountCapn..10OCaptured amount of the requested process
AmountCredn..10OCredited amount of the requested process
LastStatusn..10OStatus of the requested process
ConfigUpdatea3O

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.

DMACKSNan..20M

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

DMACan16M

DUKPT Message Authentication Code for the entire response

Antwortparameter zur Abfrage von Informationen zu POS-Zahlungen


Kartenstornierung / automatische Stornierung

Die Stornierung wird von der Karte initiiert oder nach einer Zeitüberschreitung automatisch vom Terminal ausgelöst. Einige Parameter gelten nur für Anfragen aus bestimmten Bereichen: DCC: Dynamische Währungsumrechnung, MTT: Mass Transit Transaction.

Um eine POS-Zahlung automatisch zu stornieren, verwenden Sie bitte folgende UR:

Für das Integrationstestsystem verwenden Sie bittehttps://dev.computop.de/Paygate/posPayment.aspx.


Hinweis: Aus Sicherheitsgründen lehnt das Paygate alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp.

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...

Key

Format

CND

Description

MessageTypean2MMessage type of request. Returned in response. Allowed value: 
F0
(Explanations in the appendix under Message Types)

KeyFormatCNDDescription

MerchantID

ans..30

M

MerchantID, assigned by Computop. Additionally this parameter has to be passed in plain language too.

KeyFormatCNDDescription
PayID

an32

M

ID assigned by Paygate for the payment, e.g. for referencing in batch files as well as for capture or credit request.

KeyFormatCNDDescription
TransID

ans..64

MTransactionID provided by you which should be unique for each payment

KeyFormatCNDDescription
refnr

ans..30

O

Merchant’s unique reference number

Key

Format

CND

Description

Amountn..10M

Amount in the smallest currency unit (e.g. EUR Cent). Please contact the Computop Helpdesk, 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.

Key

Format

CND

Description

CashbackAmountn..10OCashback Amount in case such transaction type is submitted. Given in the smallest currency unit (e.g. EUR Cent).

KeyFormatCNDDescription
Currency

a3

M

Currency, three letters DIN / ISO 4217, e.g. EUR, USD, GBP. Please find an overview here: A1 Currency table

KeyFormatCNDDescription

MAC

an64

M
Hash Message Authentication Code (HMAC) with SHA-256 algorithm. Details can be found here:

Key

Format

CND

Description

POSTerminalIDan..20MTerminalID of the card reader

Device

an16MSerial number of the card reader
Manufactureran..30C

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

Mandatory for SEPAELV and Girocard, optional for others.

TerminalModel..60OModel or type of card reader
EMVDataan..2048C

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.

CCSeqNon3OCard sequence number
OrderDescans..200ODescription of purchased goods, unit prices etc.
LocalDaten4C

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.

LocalTimen6C

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.

ReceiptNrn4C

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)

dccStatusa1C

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

TraceNrn6O

Continuous 6-digit decimal. Is incremented for each transaction as described in TA.

ConditionCoden2C

Mandatory only for girocard. Condition code. Values from 00 to 99 as described in TA under BMP 25.

TerminalDataan..99C

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

DMACKSNan..20C

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

DMACan16C

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.

Parameter für die Stornierung von POS-Zahlungen


Die folgende Tabelle beschreibt die Parameter, die das Paygate als Antwort zurückgibt:

(info) es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden

(info) die Parameter (z.B. mid, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...

Key

Format

CND

Description

MessageTypean2M

Message type transmitted in the request

KeyFormatCNDDescription

mid

ans..30

M

MerchantID, assigned by Computop

KeyFormatCNDDescription
PayID

an32

M

ID assigned by Paygate for the payment, e.g. for referencing in batch files as well as for capture or credit request.

KeyFormatCNDDescription
XID

an32

M

ID for all single transactions (authorisation, capture, credit note) for one payment assigned by Paygate

KeyFormatCNDDescription
TransID

ans..64

MTransactionID provided by you which should be unique for each payment

KeyFormatCNDDescription
Amountn..10M

Amount in the smallest currency unit (e.g. EUR Cent). Please contact the Computop Helpdesk, if you want to capture amounts <100 (smallest currency unit).

KeyFormatCNDDescription
Currency

a3

M

Currency, three letters DIN / ISO 4217, e.g. EUR, USD, GBP. Please find an overview here: A1 Currency table

KeyFormatCNDDescription
Status

a..50

M

OK (URLSuccess) or FAILED (URLFailure)

KeyFormatCNDDescription
Description

ans..1024

M
Further details in the event that payment is rejected. Please do not use the Description but the Code parameter for the transaction status analysis!

KeyFormatCNDDescription
Code

an8

M

Error code according to Paygate Response Codes (A4 Error codes)

Key

Format

CND

Description

CodeExtan2MResponse code of the acquirer
EMVDataan..2048C

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)

POSTerminalIDan...20MTerminalID of the card reader
ConfigUpdatea3O

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.

VUNrans..20O

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

TerminalIDans..20O

Only with credit card: TerminalID that Computop exchanges with the acquirer. Configured at the merchant.

AQans..30O

Abbreviation of the Acquirers. Configured at the merchant.

TrxTimeans21O

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

DMACKSNan..20M

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

DMACan16M

DUKPT Message Authentication Code for the entire response

Anwortparameter für die Stornierung von POS-Zahlungen


Manuelle Stornierung

Diese Stornierung wird durch den Terminalbetreiber ausgelöst. Einige Parameter gelten nur für Anfragen aus bestimmten Bereichen: DCC: Dynamische Währungsumrechnung, MTT: Mass Transit Transaction.

Um eine POS-Zahlung manuell zu stornieren, verwenden Sie bitte folgende URL:

Für das Integrationstestsystem verwenden Sie bittehttps://dev.computop.de/Paygate/posPayment.aspx.


Hinweis: Aus Sicherheitsgründen lehnt das Paygate alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp.

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...

Key

Format

CND

Description

MessageTypean2MMessage type of request. Returned in response. Allowed value: 
02
(Explanations in the appendix under Message Types)

KeyFormatCNDDescription

MerchantID

ans..30

M

MerchantID, assigned by Computop. Additionally this parameter has to be passed in plain language too.

KeyFormatCNDDescription
PayID

an32

M

ID assigned by Paygate for the payment, e.g. for referencing in batch files as well as for capture or credit request.

KeyFormatCNDDescription
TransID

ans..64

MTransactionID provided by you which should be unique for each payment

KeyFormatCNDDescription
refnr

ans..30

O

Merchant’s unique reference number

Key

Format

CND

Description

Amountn..10M

Amount in the smallest currency unit (e.g. EUR Cent). Please contact the Computop Helpdesk, 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.

Key

Format

CND

Description

CashbackAmountn..10OCashback Amount in case such transaction type is submitted. Given in the smallest currency unit (e.g. EUR Cent).

KeyFormatCNDDescription
Currency

a3

M

Currency, three letters DIN / ISO 4217, e.g. EUR, USD, GBP. Please find an overview here: A1 Currency table

KeyFormatCNDDescription

MAC

an64

M
Hash Message Authentication Code (HMAC) with SHA-256 algorithm. Details can be found here:

Key

Format

CND

Description

POSTerminalIDan..20MTerminalID of the card reader

Device

an16MSerial number of the card reader
Manufactureran..30M

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

TerminalModel..60OModel or type of card reader
LocalDaten4M

Date of the transaction. Format: MMTT

LocalTimen6M

Time of the transaction. Format: hhmmss

ReceiptNrn4M

Number for the document. Will be continuously increased. Overflow to 9999.

TraceNrn6M

Continuous 6-digit decimal. Is incremented for each transaction as described in TA.

ConditionCoden2C

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.

TerminalDataan..99C

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

CCExpiryn6C

Mandatory for credit cards. Expiry date of the card (YYYYMM), e.g. 202507. Must be sent for SEPAELV transactions.

CCSeqNrn3O

Card sequence number. Must be sent for SEPAELV transactions.

EntryModen3C

Mandatory for credit cards. POS Entry Mode (Tag 9F39). Must be sent for SEPAELV transactions.

DMACKSNan..20C

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

DMACan16C

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.

Parameter für manuelle Stornierung von POS-Zahlungen


Die folgende Tabelle beschreibt die Parameter, die das Paygate als Antwort zurückgibt:

(info) es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden

(info) die Parameter (z.B. mid, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...

Key

Format

CND

Description

MessageTypean2M

Message type transmitted in the request

KeyFormatCNDDescription

mid

ans..30

M

MerchantID, assigned by Computop

KeyFormatCNDDescription
PayID

an32

M

ID assigned by Paygate for the payment, e.g. for referencing in batch files as well as for capture or credit request.

KeyFormatCNDDescription
XID

an32

M

ID for all single transactions (authorisation, capture, credit note) for one payment assigned by Paygate

KeyFormatCNDDescription
TransID

ans..64

MTransactionID provided by you which should be unique for each payment

KeyFormatCNDDescription
Amountn..10M

Amount in the smallest currency unit (e.g. EUR Cent). Please contact the Computop Helpdesk, if you want to capture amounts <100 (smallest currency unit).

KeyFormatCNDDescription
Currency

a3

M

Currency, three letters DIN / ISO 4217, e.g. EUR, USD, GBP. Please find an overview here: A1 Currency table

KeyFormatCNDDescription
Status

a..50

M

OK (URLSuccess) or FAILED (URLFailure)

KeyFormatCNDDescription
Description

ans..1024

M
Further details in the event that payment is rejected. Please do not use the Description but the Code parameter for the transaction status analysis!

KeyFormatCNDDescription
Code

an8

M

Error code according to Paygate Response Codes (A4 Error codes)

Key

Format

CND

Description

CodeExtan2OResponse code of the acquirer
POSTerminalIDan...20MTerminalID of the card reader
VUNrans..20O

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

TerminalIDans..20O

Only with credit card: TerminalID that Computop exchanges with the acquirer. Configured at the merchant.

AQans..30O

Abbreviation of the Acquirers. Configured at the merchant.

TrxTimeans21O

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

ConfigUpdatea3O

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.

OriginalCodeans..3O

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

DMACKSNan..20M

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

DMACan16M

DUKPT Message Authentication Code for the entire response

Antwortparameter für manuelle Stornierung von POS-Zahlungen


Gutschrift ohne Referenz

Auslösen einer Gutschrift über das Terminal. Einige Parameter gelten nur für Anfragen aus bestimmten Bereichen: DCC: Dynamische Währungsumrechnung, MTT: Mass Transit Transaction.

Um eine POS-Zahlung gutzuschreiben, verwenden Sie bitte folgende URL:

Für das Integrationstestsystem verwenden Sie bittehttps://dev.computop.de/Paygate/posPayment.aspx.


Hinweis: Aus Sicherheitsgründen lehnt das Paygate alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp.

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...

Key

Format

CND

Description

MessageTypean2MMessage type of request. Returned in response. Allowed value: 
03
(Explanations in the appendix under Message Types)

KeyFormatCNDDescription

MerchantID

ans..30

M

MerchantID, assigned by Computop. Additionally this parameter has to be passed in plain language too.

KeyFormatCNDDescription
TransID

ans..64

MTransactionID provided by you which should be unique for each payment

KeyFormatCNDDescription

MAC

an64

M
Hash Message Authentication Code (HMAC) with SHA-256 algorithm. Details can be found here:

Key

Format

CND

Description

RefNrans..30O

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

Amount

n..10M

Amount in the smallest currency unit (e.g. EUR Cent). Please contact the Computop Helpdesk, 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.

Currencya3M

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

dccStatusa1CMandatory for DCC; status of foreign currency settlement. Possible values: U foreign currency was used. E foreign currency was offered but not used.
dccRateValueans13CMandatory at DCC and dccStatus U ; Exchange rate with decimal point
dccRateIDans..20CFiserv IPG-Rate. Only present in case of a DCC service via Fiserv.
baseAmountn..10CMandatory at DCC and dccStatus U ; Amount in the smallest currency unit in Terminal currency
baseCurrencya3CMandatory at DCC and dccStatus U ; Currency set up at the terminal as standard
dccMarginans..5O

DCC margin/markup percentage

dccCommissionans..12O

DCC commission percentage

dccSourceans..32O

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

dccTimestampans..20O

Timestamp of exchange rate

dccRequestIdan..32O

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

POSTerminalIDan..20MTerminalID of the card reader

Device

an16MSerial number of the card reader
Manufactureran..30C

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

Mandatory for SEPAELV and Girocard, optional for others.

TerminalModel..60OModel or type of card reader
CCNrn8..19MCard number
CCBrandan..22MCard brand: VISA, MasterCard, Maestro, AMEX, DINERS, JCB, CUP. Please note the spelling! Always specify SEPAELV at ELV!
CCExpiryn6MExpiration date of the card (YYYYMM), e.g. 202507
CCSeqNrn3OCard sequence number
Track2an..224CData of the track2 for MSR or Track2EquivalentData (Tag 57) (in Hex formatting). At MSR Track2 or Track2Enc is mandatory.
DataEncryptedan..2048O

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.

DataKSNan..20CKSN is generated by the terminal. Is required to decrypt the data from the parameter DataEncrypted.
EntryModen3CMandatory for credit cards. POS Entry Mode.
OrderDescans..200ODescription of purchased goods, unit prices etc.
DMACKSNan..20C

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

DMACan16C

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.

Parameter für Gutschriften von POS-Zahlungen


Die folgende Tabelle beschreibt die Parameter, die das Paygate als Antwort zurückgibt:

(info) es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden

(info) die Parameter (z.B. mid, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...

Key

Format

CND

Description

MessageTypean2M

Message type transmitted in the request

KeyFormatCNDDescription

mid

ans..30

M

MerchantID, assigned by Computop

KeyFormatCNDDescription
PayID

an32

M

ID assigned by Paygate for the payment, e.g. for referencing in batch files as well as for capture or credit request.

KeyFormatCNDDescription
XID

an32

M

ID for all single transactions (authorisation, capture, credit note) for one payment assigned by Paygate

KeyFormatCNDDescription
TransID

ans..64

MTransactionID provided by you which should be unique for each payment

KeyFormatCNDDescription
Status

a..50

M

OK (URLSuccess) or FAILED (URLFailure)

KeyFormatCNDDescription
Description

ans..1024

M
Further details in the event that payment is rejected. Please do not use the Description but the Code parameter for the transaction status analysis!

KeyFormatCNDDescription
Code

an8

M

Error code according to Paygate Response Codes (A4 Error codes)

Key

Format

CND

Description

POSTerminalIDan...20MTerminalID of the card reader
CodeExtan2MResponse code of the acquirer
VUNrans..20OOnly at credit card. Contract number of the merchant with the acquirer. Configured at the merchant.
TerminalIDans..20O

Only at credit card. TerminalID, which Computop exchanges with the acquirer. Configured at the merchant.

AQans..30OAbbreviation of the acquirers. Configured at the merchant.
TrxTimeans21OTime of execution of the transaction in format: dd.MM.yyyy HH:mm:ssff. Configured at the merchant.
ConfigUpdatea3O

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.

DMACKSNan..20M

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

DMACan16M

DUKPT Message Authentication Code for the entire response

Antwortparameter für Gutschriften von POS-Zahlungen


POS-Erhöhung

Noch nicht für alle Acquirer verfügbar. Einige Parameter gelten nur für Anfragen aus bestimmten Bereichen: DCC: Dynamische Währungsumrechnung, MTT: Mass Transit Transaction.

Um eine POS-Zahlung zu erhöhen, verwenden Sie bitte folgende URL:

Für das Integrationstestsystem verwenden Sie bittehttps://dev.computop.de/Paygate/posPayment.aspx.


Hinweis: Aus Sicherheitsgründen lehnt das Paygate alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp.

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...

Key

Format

CND

Description

MessageTypean2MMessage type of request. Returned in response. Allowed value: 
06
(Explanations in the appendix under Message Types)

KeyFormatCNDDescription

MerchantID

ans..30

M

MerchantID, assigned by Computop. Additionally this parameter has to be passed in plain language too.

KeyFormatCNDDescription
PayID

an32

M

ID assigned by Paygate for the payment, e.g. for referencing in batch files as well as for capture or credit request.

KeyFormatCNDDescription
TransID

ans..64

MTransactionID provided by you which should be unique for each payment

KeyFormatCNDDescription
refnr

ans..30

O

Merchant’s unique reference number

Key

Format

CND

Description

Amountn..10M

Amount in the smallest currency unit (e.g. EUR Cent). Please contact the Computop Helpdesk, 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.

KeyFormatCNDDescription
Currency

a3

M

Currency, three letters DIN / ISO 4217, e.g. EUR, USD, GBP. Please find an overview here: A1 Currency table

KeyFormatCNDDescription

MAC

an64

M
Hash Message Authentication Code (HMAC) with SHA-256 algorithm. Details can be found here:

Key

Format

CND

Description

POSTerminalIDan..20MTerminalID of the card reader

Device

an16MSerial number of the card reader
Manufactureran..30M

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

TerminalModel..60OModel or type of card reader
CCSeqNrn3OCard sequence number
Track2an..224CMandatory with Magnetic Stripe Read (MSR). Data of the track2 for MSR or Track2EquivalentData (Tag 57) (in Hex formatting).
EMVDataan..2048C

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.

EntryModen3MPOS Entry Mode
DataEncryptedan..2048OPAN + Track2 Equivalent Data (in TLV format) as encrypted value. If this field is present, the CCNr parameter is not required.
DataKSNan..20CKSN is generated by the terminal. Is required to decrypt the data from the parameter DataEncrypted.
LocalDaten4M

Date of the transaction. Format: MMTT

LocalTimen6M

Time of the transaction. Format: hhmmss

ReceiptNrn4M

Number for the document. Will be continuously increased. Overflow to 9999.

DMACKSNan..20C

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

DMACan16C

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.

Parameter für Erhöhung von POS-Zahlungen


Die folgende Tabelle beschreibt die Parameter, die das Paygate als Antwort zurückgibt:

(info) es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden

(info) die Parameter (z.B. mid, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...

Key

Format

CND

Description

MessageTypean2M

Message type transmitted in the request

KeyFormatCNDDescription

mid

ans..30

M

MerchantID, assigned by Computop

KeyFormatCNDDescription
PayID

an32

M

ID assigned by Paygate for the payment, e.g. for referencing in batch files as well as for capture or credit request.

KeyFormatCNDDescription
XID

an32

M

ID for all single transactions (authorisation, capture, credit note) for one payment assigned by Paygate

KeyFormatCNDDescription
TransID

ans..64

MTransactionID provided by you which should be unique for each payment

KeyFormatCNDDescription
refnr

ans..30

O

Merchant’s unique reference number

KeyFormatCNDDescription
Amountn..10M

Amount in the smallest currency unit (e.g. EUR Cent). Please contact the Computop Helpdesk, if you want to capture amounts <100 (smallest currency unit).

KeyFormatCNDDescription
Currency

a3

M

Currency, three letters DIN / ISO 4217, e.g. EUR, USD, GBP. Please find an overview here: A1 Currency table

KeyFormatCNDDescription
Status

a..50

M

OK (URLSuccess) or FAILED (URLFailure)

KeyFormatCNDDescription
Description

ans..1024

M
Further details in the event that payment is rejected. Please do not use the Description but the Code parameter for the transaction status analysis!

KeyFormatCNDDescription
Code

an8

M

Error code according to Paygate Response Codes (A4 Error codes)

Key

Format

CND

Description

CodeExtan2OResponse code of the acquirer
POSTerminalIDan...20MTerminalID of the card reader
OriginalCodeans..3OMTT only: Contains the original Response Code (OmniPay BM 60 SF68: Scheme Response Code) from the authorization platforms for payment systems
VUNrans..20O

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

TerminalIDans..20O

TerminalID that Computop exchanges with the acquirer. Configured at the merchant.

AQans..30O

Abbreviation of the Acquirers. Configured at the merchant.

TrxTimeans21O

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

EMVDataan..2048C

Block for additional data

ConfigUpdatea3O

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.

DMACKSNan..20M

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

DMACan16M

DUKPT Message Authentication Code for the entire response

Antwortparameter für Erhöhung von POS-Zahlungen


DCC-Transaktionen über VPN

Um eine DCC-Anfrage zu stellen, verwenden Sie bitte folgende URL:

Für das Integrationstestsystem verwenden Sie bitte: https://dev.computop.de/Paygate/posdcc.aspx.


Hinweis: Aus Sicherheitsgründen lehnt das Paygate alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp.

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...

Key

Format

CND

Description

MessageTypean2MMessage type of request. Returned in response. Allowed value: 
FC 
(Explanations in the appendix under Message Types)

KeyFormatCNDDescription

MerchantID

ans..30

M

MerchantID, assigned by Computop. Additionally this parameter has to be passed in plain language too.

KeyFormatCNDDescription
TransID

ans..64

MTransactionID provided by you which should be unique for each payment

KeyFormatCNDDescription
refnr

ans..30

O

Merchant’s unique reference number

Key

Format

CND

Description

Amountn..10M

Amount in the smallest currency unit (e.g. EUR Cent). Please contact the Computop Helpdesk, 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.

KeyFormatCNDDescription
Currency

a3

M

Currency, three letters DIN / ISO 4217, e.g. EUR, USD, GBP. Please find an overview here: A1 Currency table

Key

Format

CND

Description

POSTerminalIDan...20MTerminalID of the card reader
Devicean16MSerial number of the card reader
CCBINn10MThe first 10 digits of the card number
CCExpiryn6MExpiration date of credit card (YYYDMM), e.g. 202507
CCBranda..22MCard brand
ContractIDn..8OAdditional contract number of the merchant

Parameter für DCC-Anfragen


Die folgende Tabelle beschreibt die Parameter, die das Paygate als Antwort zurückgibt:

(info) es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden

(info) die Parameter (z.B. mid, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...

Key

Format

CND

Description

MessageTypean2M

Message type transmitted in the request

KeyFormatCNDDescription

mid

ans..30

M

MerchantID, assigned by Computop

KeyFormatCNDDescription
PayID

an32

M

ID assigned by Paygate for the payment, e.g. for referencing in batch files as well as for capture or credit request.

KeyFormatCNDDescription
XID

an32

M

ID for all single transactions (authorisation, capture, credit note) for one payment assigned by Paygate

KeyFormatCNDDescription
TransID

ans..64

MTransactionID provided by you which should be unique for each payment

KeyFormatCNDDescription
refnr

ans..30

O

Merchant’s unique reference number

KeyFormatCNDDescription
Status

a..50

M

OK (URLSuccess) or FAILED (URLFailure)

KeyFormatCNDDescription
Description

ans..1024

M
Further details in the event that payment is rejected. Please do not use the Description but the Code parameter for the transaction status analysis!

KeyFormatCNDDescription
Code

an8

M

Error code according to Paygate Response Codes (A4 Error codes)

Key

Format

CND

Description

POSTerminalIDan...20MTerminalID of the card reader
CodeExtn..10OThe status of the DCC request if the merchant is activated and inquiry fails
ErrorTextan..256OError text when registered at the merchant fails
dccRateIDans..20OFiserv IPG-Rate. Only present in case of a DCC service via Fiserv.



Following parameters are returned only if there is a successful query
dccRateValueans..13CExchange rate with decimal separator
dccForeignCurrencyCodea3CForeign currency, three characters DIN / ISO 4217
expirationTimeans..19C

Time stamp indicating how long exchange rate is valid. Specification in UTC.

Format: YYYY-MM-ddTHH:mm:ss

dccForeignAmountn..10CForeign currency amount in the smallest currency unit
dccMarginans..5C

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

dccCommissionans7CReserved, Fixed "00.0000" - dd.dddd
dccSourceans...32C

Exchange rate provider: "REUTERS WHOLESALE INTERBANK"

dccTimestampans19C

Time stamp when the shift course was requested. Specification in UTC.

Format: YYYY-MM-ddTHH:mm:ss

Antwortparameter für DCC-Anfragen


Terminalkonfiguration

Rufen Sie die Terminalkonfigurationsdaten vom Paygate ab. 

Um die POS-Terminalkonfigurationsdaten abzurufen, verwenden Sie bitte folgende URL:

Für das Integrationstestsystem verwenden Sie bittehttps://dev.computop.de/Paygate/posConfig.aspx.


Hinweis: Aus Sicherheitsgründen lehnt das Paygate alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp.

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...

Key

Format

CND

Description

MessageTypean2M

Message type of request. Returned in response. Here always:
F2
(Explanations in the appendix under Message Types)

KeyFormatCNDDescription

MerchantID

ans..30

M

MerchantID, assigned by Computop. Additionally this parameter has to be passed in plain language too.

Key

Format

CND

Description

POSTerminalIDan..20MTerminalID of the card reader

Device

an16MSerial number of the card reader
Manufactureran..30M

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

TerminalModel..60OModel or type of card reader
DMACKSNan..20M

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

DMACan16M

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

Parameter zum Abrufen von POS-Terminalkonfigurationsdaten


Die folgende Tabelle beschreibt die Parameter, die das Paygate als Antwort zurückgibt:

(info) es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden

(info) die Parameter (z.B. mid, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...

Key

Format

CND

Description

MessageTypean2M

Message type transmitted in the request

KeyFormatCNDDescription

mid

ans..30

M

MerchantID, assigned by Computop

KeyFormatCNDDescription
Status

a..50

M

OK (URLSuccess) or FAILED (URLFailure)

KeyFormatCNDDescription
Description

ans..1024

M
Further details in the event that payment is rejected. Please do not use the Description but the Code parameter for the transaction status analysis!

KeyFormatCNDDescription
Code

an8

M

Error code according to Paygate Response Codes (A4 Error codes)

Key

Format

CND

Description

ConfigDataans..8192MConfiguration data in the agreed format
POSTerminalIDan...20MTerminalID of the card reader
DMACKSNan..20M

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

DMACan16M

DUKPT Message Authentication Code for the entire response

Antwortparameter zum Abrufen von POS-Terminalkonfigurationsdaten


Terminalkonfiguration v2 (Spezielle Schnittstelle ohne Merchant ID in der Anfrage)

Rufen Sie die Terminalkonfigurationsdaten vom Paygate ab. 

Um die POS-Terminalkonfigurationsdaten abzurufen, verwenden Sie bitte folgende URL:

Für das Integrationstestsystem verwenden Sie bitte: https://dev.computop.de/Paygate/posConfigExt.aspx.


Hinweis: Aus Sicherheitsgründen lehnt das Paygate alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp.

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...

Key

Format

CND

Description

MessageTypean2MMessage type of request. Returned in response. Here always:
F2
(Explanations in the appendix under Message Types)

Key

Format

CND

Description

POSTerminalIDan..20MTerminalID of the card reader

Device

an16MSerial number of the card reader
Manufactureran..30M

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

TerminalModel..60OModel or type of card reader
DMACKSNan..20M

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

DMACan16M

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

Parameter zum Abrufen von POS-Terminalkonfigurationsdaten


Die folgende Tabelle beschreibt die Parameter, die das Paygate als Antwort zurückgibt:

(info) es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden

(info) die Parameter (z.B. mid, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...

Key

Format

CND

Description

MessageTypean2M

Message type transmitted in the request

KeyFormatCNDDescription

mid

ans..30

M

MerchantID, assigned by Computop

KeyFormatCNDDescription
Status

a..50

M

OK (URLSuccess) or FAILED (URLFailure)

KeyFormatCNDDescription
Description

ans..1024

M
Further details in the event that payment is rejected. Please do not use the Description but the Code parameter for the transaction status analysis!

KeyFormatCNDDescription
Code

an8

M

Error code according to Paygate Response Codes (A4 Error codes)

Key

Format

CND

Description

ConfigDataans..8192MConfiguration data in the agreed format
POSTerminalIDan...20MTerminalID of the card reader
DMACKSNan..20M

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

DMACan16M

DUKPT Message Authentication Code for the entire response

Antwortparameter zum Abrufen von POS-Terminalkonfigurationsdaten


Zahlungsvermittler

Um die Funktionalität des Zahlungsvermittlers zu nutzen, müssen Sie Ihrer Anfrage die folgenden Parameter hinzufügen.

Die folgende Tabelle beschreibt die Anfrageparameter:

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...

Key

Format

CND

Description

subMID

ans..15

C

SubMerchantID, which is assigned by the Payment Facilitator and transmitted in the call to identify submerchants in the transaction process.

subMIDName

ans..22

C

Name of the SubMerchantID

subMIDAddrCity

ans..13

C

City of SubMerchantID

subMIDAddrCountryCode

a2

C

Country code of the SubMerchantID in the format ISO-3166-1, alphanumerical 2-digit

subMIDAddrStreet

ans..38

C

Road of SubMerchantID

subMIDAddrZip

ans..10

C

Postal code of SubMerchantID

subMIDAddrState

ans3

C

Federal state of SubMerchantID

Zusätzliche Parameter für die Nutzung des Zahlungsvermittlers


CUT-OFF


Hinweis: Aus Sicherheitsgründen lehnt das Paygate alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp.

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...

Key

Format

CND

Description

MessageTypean2M

Message type of request. Returned in response. Allowed value: 
CF 
(Explanations in the appendix under Message Types)

KeyFormatCNDDescription

MerchantID

ans..30

M

MerchantID, assigned by Computop. Additionally this parameter has to be passed in plain language too.

KeyFormatCNDDescription
TransID

ans..64

MTransactionID provided by you which should be unique for each payment

Key

Format

CND

Description

POSTerminalIDan..20MTerminalID of the card reader

Device

an16MSerial number of the card reader

cutoff

JSONOBase64 encoded JSON object
DMACKSNan..20M

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

DMACan16M

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

Parameter für Cut-Off


Beispielwert des Parameters: cutoff

{
    "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>
        }
    ]
}



Die folgende Tabelle beschreibt die Parameter, die das Paygate als Antwort zurückgibt:

(info) es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden

(info) die Parameter (z.B. mid, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...

Key

Format

CND

Description

MessageTypean2M

Message type transmitted in the request

KeyFormatCNDDescription

mid

ans..30

M

MerchantID, assigned by Computop

KeyFormatCNDDescription
PayID

an32

M

ID assigned by Paygate for the payment, e.g. for referencing in batch files as well as for capture or credit request.

Key

Format

CND

Description

TransIDans..64COnly on success: Merchant's transaction number.
POSTerminalIDan..20MTerminalID of the card reader
Statusa..50MOK (URLSuccess) or FAILED (URLFailure). Refers to the inquire request itself.

KeyFormatCNDDescription
Description

ans..1024

M
Further details in the event that payment is rejected. Please do not use the Description but the Code parameter for the transaction status analysis!

KeyFormatCNDDescription
Code

an8

M

Error code according to Paygate Response Codes (A4 Error codes)

Key

Format

CND

Description

DMACKSNan..20M

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

DMACan16M

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

Antwortparameter für Cut-Off


EMV-Datenelemente

Der EMV-Datenblock wird als Hex-String gesendet. Die Daten sind TLV-kodiert. Eine ausführlicher Beschreibung von TLV und den EMV-Tags finden Sie in der EMV-Spezifikation „EMV v4.3 Book 3 Application Specification“, die hier heruntergeladen werden kann: https://www.emvco.com/specifications.aspx?id=223
Eine Tag-Liste finden Sie in Anhang A.


Die folgenden Tags sind für eine Kreditkartenzahlung erforderlich, sofern sie vom Terminal oder der Karte bereitgestellt werde:

Tag

Beschreibung

9F06

Anwendungskennung (AID)

9F26

Anwendungskryptogramm

9F27

Kryptogramm-Informationsdaten

9F10

Issuer-Anwendungsdaten (IAD)

9F37

Unvorhersehbare Zahl

9F36

Anwendung Trx.-Zähler (ATC)

95

Terminal-Verifizierungsergebnisse

9A

Transaktionsdatum

9C

Transaktionsart

9F02

Transaktionsbetrag

5F2A

Transaktions-Währungscode

82

Anwendungsaustauschprofil

9F1A

Terminal-Ländercode

9F03

Betrag, Sonstiges (ggf. Cashback-Betrag)

9F33

Terminalfähigkeiten
Muss für SEPAELV-Transaktionen gesendet werden.

9F34

CVM-Ergebnisse
Muss für SEPAELV-Transaktionen gesendet werden.

9F35

Terminalart

9F1E

Schnittstellengerät (IFD) Seriennummer

9F53

Transaktionskategoriecode

84

Dedizierter Dateiname

9F09

Terminal-Anwendung Versionsnummer

9F41

Transaktionssequenzzähler

DF01

Ergebnisse des Issuer-Skripts

DF02

Fehlererkennung

9F7C

Kundenexklusive Daten

9F6E

Formfaktorindikator


Die folgenden Tags sind für eine Kreditkartenzahlung optional:

Tag

Beschreibung

57

Track2-Äquivalentdaten

5F20

Name des Karteninhabers


Das folgende Tag ist für eine CLV+-Zahlung:

Tag

Beschreibung

DF64

Mandate ID: Diese wird zurückgegeben, wenn die Unterschrift des Kunden zum ersten Mal eingeholt wird und die Mandats-ID für zukünftige reibungslose Zahlungen erstellt wird


Antwort-Tags bei SEPA-ELV

Bei SEPA-ELV kann die Antwort optional folgende Tags enthalten:

  • 5F53 (IBAN)
  • DF65 (Gläubiger-ID)


Hinweis: Sofern diese Felder vorhanden sind, müssen sie auch auf dem Dokument ausgedruckt werden
5F53 (IBAN)
Länge: 34 Byte, Format: on 
Die IBAN kann optional im BMP55 der Antwortnachricht (210,1410) enthalten sein. Sie ist maximal 34 Ziffern lang und darf keine Sonderzeichen und Kleinbuchstaben enthalten. In Deutschland wird eine 22-stellige IBAN verwendet.
Ist die IBAN im BMP55 enthalten, wird sie vollständig ausgedruckt oder vom Terminal aus dem BMP55, der auf dem Händler- und Kundenbeleg unter den Kartendaten erfasst wurde, mithilfe der Maskierungsregel (Tag DF25) maskiert
Beispiel für eine Maskierung:
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 (Gläubiger-ID)
Länge: 8 - 35 Byte, Format: ans 
Bei Online-Transaktionen kann der Bedienercomputer optional eine Gläubiger-ID in die Antwortnachricht (BMP55, Tag DF65-) einfügen. Wenn die BMP55 der Antwortnachricht eine Gläubiger-ID (DF65) enthält, wird diese im Händlerdokument oder anstelle des konfigurierten Kundendokuments (mit dem Konkretisierungszeichen „Gl“) ausgedruckt.
Beispiel:
DF65 12 444539385A5A5A3039393939393939393939393939393939393939


Bildung des DUKPTMAC

Zur Nachrichtenauthentifizierung fügt der Absender der Nachricht einen MAC (Message Authentication Code) hinzu, der vom Empfänger verifiziert wird.

  • Der Eingabeblock zur Berechnung des MAC ist wie folgt aufgebaut: Berechnung eines SHA-256-Codes über die Nachricht; einschließlich des Felds MessageType, des Felds MerchantID bis zum Feld DUKPTMAC (DMAC ausgeschlossen).
  • Das Ergebnis ist ein 32 Byte großer Eingabeblock, der zur Berechnung des MAC verwendet wird.


Der MAC wird mithilfe eines Arbeitsschlüssels generiert, der aus dem 3-DES-DUKPT-Sicherheitsschema abgeleitet wurde. Das Ergebnis der MAC-Berechnung ist ein 8-Byte-Nachrichtenauthentifizierungsblock (MAB), bestehend aus einem MAC (höchste 4 Byte) und einem verbleibenden MAC (niedrigste 4 Byte). Das MAC-Feld der Nachricht wird auf den MAB gesetzt. Die MAC-Generierung und -Verifizierung erfolgt gemäß ANSI X9.19.


Nachrichtentypen

Übersicht der Typen

01 Kauf (Verkauf)
02 Stornierung
03 Rückerstattung
05 Autorisierung (Reservierung)
 
06 Inkrementelle Autorisierung
0B Buchung

CF Cut Off
E0 HSM as a Service
F0 Automatische Stornierung
F1 Abfrage
F2 Terminalkonfiguration

Erläuterungen

Tag

Beschreibung

01 Kauf (CT: Verkauf)

Autorisierung und Buchung in einer Transaktion werden Verkauf genannt

02 Stornierung

Stornierung der Autorisierung;
Stornierung des Verkaufs (nur möglich, wenn die Abrechnung beim Acquirer noch nicht erfolgt ist. Andernfalls ist nur eine Gutschrift möglich.)

03 Rückerstattung (CT: Gutschrift)

Rückerstattung am POS ohne vorherigen Verkauf

05 (Vor-)Autorisierung

Erhöhung möglich (CT: Reservierung)

06 Vor-Autorisierung

Erhöhung möglich (CT: Reservierung)

0B Buchung

Buchung einer Autorisierung





  • No labels