• DeutschEnglish

MTT Mass Transit Transactions

Systemdiagramm

Nachfolgend finden Sie ein detailliertes Systemdiagramm, das die Verbindung zwischen verschiedenen Beteiligten und die von jeder Entität im MTT Echo-System bereitgestellten Funktionalitäten beschreibt.

COO 6505 1000 11 7161175

Paygate-Schnittstelle

Definitionen

Datenformate

Format

Beschreibung

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ürzung

Beschreibung

Kommentar

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.

POS-initiierte Transaktionstypen (aggregierte / verzögerte Autorisierungen)

Nachfolgend die Schnittstellenbeschreibung, die zur Übermittlung von Mass Transportation Transaktionstypen relevant ist.

https://www.computop-paygate.com/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:

KeyFormatCNDDescription

MessageType

an2

M

Nachrichtentyp für die Anfrage. Zulässige Werte:

01 Verkauf (zweistufige Transaktion)

05 Vorautorisierung, Autorisierung

MerchantID

ans..30

M

HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.

TransID

ans..64

M

Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

RefNr

ans..30

O

Eindeutige Referenznummer des Händlers

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

Amount

n..10

M

Betrag in der kleinsten Währungseinheit (z. B. EUR Cent).

Für DCC: Betrag in Fremdwährung

Currency

a3

M

Währung, drei Zeichen DIN / ISO 4217

Für DCC: Fremdwährung

LocalDate

n4

M

Lokales Datum der Transaktion. Format: MMTT

LocalTime

n6

M

Ortszeit der Transaktion. Format: hhmmss

POSTerminalID

an..20

M

Terminal-ID des POS-Geräts

Device

an16

M

Seriennummer des POS-Geräts

CCNr

n8..19

C

PAN der Karte. Bei Kreditkarten nur die Nummer. Bei ELV die PAN bestehend aus Länder-Präfix, Bankleitzahl, Kontonummer und Prüfziffer

CCBrand

an..22

M

Marke: VISA, MasterCard, Maestro, AMEX, DINERS, JCB, CUP. Bitte beachten Sie die richtige Schreibweise!

Für ELV verwenden Sie immer SEPAELV!

CCCVC

n..4

O

Kartenprüfnummer: Die letzten 3 Ziffern neben dem Unterschriftsfeld auf der Karte, bei AMEX 4 Ziffern

CCExpiry

n6

M

Pflicht für Kreditkarten. Ablaufdatum der Karte (JJJJMM), z.B. 202207

CCSeqNr

n3

O

Kartenfolgenummer

Track2

an..224

C

Pflicht für Magnetstreifenlesung (MSR). Daten von Track2 für MSR oder Track2Equivalent (Tag 57) (Hex-Darstellung)

EMVData

an..2048

C

EMV-Daten, die an den Acquirer weitergeleitet werden (BER-TLV-Hex-Darstellung). Lassen Sie diesen Parameter weg, wenn keine EMV-Daten vorhanden sind, z.B. MSR

EntryMode

n3

C

Pflicht für Kreditkarten. POS-Eingabemodus (Tag 9F39)

OrderDesc

ans..200

O

Beschreibung der verkauften Waren, Einzelpreis usw.

AccVerify

a..3

O

Zulässiger Wert: YES

Wird verwendet, um eine Kontoüberprüfung zu initiieren (Nullwert-Authentifizierung). Der Betrag kann Null sein.

MAC

an64

M

Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

ChDesc

ans..25

O

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

Hinweis: Für MasterCard ist die Länge auf 22 Zeichen begrenzt, bei VISA hingegen auf 25.

subMIDAddrCity

ans..13

O

Dieses Feld wird verwendet, um die Standard-Händlerstadt in der Autorisierungsanfrage zu überschreiben. (Eine PTO-Aggregator-ID kann durchgereicht werden)

subMIDName

ans..25

O

Dieses Feld wird verwendet, um den standardmäßigen Händlernamen in der Autorisierungsanfrage zu überschreiben. (Eine PTO-Aggregator-ID kann durchgereicht werden)

DataEncrypted

an..2048

O

Der Händler kann den verschlüsselten Wert von (PAN + Track 2 Equivalent Data im TLV-Format) übermitteln. Wenn dieses Feld übermittelt wird, ist die CCNr nicht erforderlich.

DataKSN

an..20

C

Vom Terminal generierter KSN-Wert, der zum Entschlüsseln der im Parameter „DataEncrypted“ vorhandenen Daten erforderlich ist.

Aufrufparameter für POS-Zahlungen

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

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

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

KeyFormatCNDDescription

MessageType

an2

M

Nachrichtentyp für die Anfrage

mid

ans..30

M

HändlerID, die von Computop vergeben wird

PayID

an32

M

Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

XID

an32

M

Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

TransID

ans..64

M

Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

Status

a..50

M

OK (URLSuccess) oder FAILED (URLFailure)

Description

ans..1024

M

Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description, sondern Code für die Auswertung des Transaktionsstatus!

Code

an8

M

Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)

refnr

ans..30

O

Eindeutige Referenznummer des Händlers

POSTerminalID

an..20

M

Terminal-ID des PIN-Eingabegeräts

CodeExt

an2

M

Antwortcode des Acquirers

Approvalcode

n..6

C

Nur für Kreditkarte, nur wenn konfiguriert: Autorisierungscode aus der Autorisierungsantwort

EMVData

an..2048

C

EMV-Daten, die an den Acquirer weitergeleitet werden (BER-TLV-Hex-Darstellung). Lassen Sie diesen Parameter weg, wenn keine EMV-Daten vorhanden sind, z.B. MSR

VUNr

ans..20

O

Nur bei Kreditkarte: Vertragspartnernummer. In den Händlereinstellungen konfiguriert.

TerminalID

ans..20

O

Nur bei Kreditkarte: ID für den Datenaustausch zwichen Computop und dem Acquirer. In den Händlereinstellungen konfiguriert.

AQ

ans..30

O

Nur wenn konfiguriert: Acquirer Shortcut

TrxTime

ans21

O

Zeitstempel der Transaktion im Format dd.MM.yyyy HH:mm:ssff

additionalresponsedata

an..128

O

Nur für Kreditkarte, nur wenn konfiguriert: Zusätzliche Antwortdaten aus der Acquirer-Antwort

PCNr

n16

O

Pseudo Card Number: Vom Computop Paygate generierte Zufallszahl, die eine reale Kreditkartennummer repräsentiert. Die Pseudokartennummer (PKN) beginnt mit 0, und die letzten 3 Stellen entsprechen denen der realen Kartennummer. Die PKN kann wie eine Kreditkartennummer für Autorisierung, Buchung und Gutschriften verwendet werden.

PCNr ist ein Antwortwert vom Computop Paygate und kann ebenfalls als CCNr im Request oder als Teil von card-JSON verwendet werden.

Last4CardholderPAN

n..4

O

VISA die letzten 4 Ziffern der eingeprägten PAN, wenn in der Anfrage eine tokenisierte DPAN verwendet wurde

PAR

ans…999

O

Von VISA/MC bereitgestellte Zahlungskonto-Referenzdaten, die hauptsächlich von MTT-Händlern verwendet werden, um einen Kunden in ihrem Backoffice-System zu identifizieren

EmbossedPANPCNr

n..19

O

(Nur MC/Maestro) Wird nur für Mass-Transit-Transaktionstypen bereitgestellt und ist eine zweite CT-PKN, die sich auf die geprägte PAN der physischen Karte bezieht. Wird in der Acquirer-Antwort empfangen, wenn in der Anfrage eine tokenisierte PAN gesendet wurde.

EmbossedPANExpiryDate

n..4 (YYMM)

O

(Nur MC/Maestro) Wird nur für Mass-Transit-Transaktionstypen bereitgestellt und ist das Ablaufdatum der eingeprägten PAN, die vom Acquirer in der Antwort erhalten wurde.

OriginalCode

ans..3

O

Enthält den ursprünglichen Antwortcode (BM 60.68 Scheme Response Code) von Autorisierungsplattformen für Zahlungssysteme.

schemeReferenceID

ans..64

O

Spezifische Transaktions-ID des Kartensystems, die für nachfolgende Zahlungen mit hinterlegten Anmeldeinformationen, verzögerte Autorisierungen und erneute Übermittlungen erforderlich ist.

Antwortparameter für POS-Zahlungen

POS Incremental (Maestro-Szenario)

https://www.computop-paygate.com/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:

KeyFormatCNDDescription

MessageType

an2

M

Nachrichtentyp für die Anfrage. Wird in der Antwort zurückgegeben. Zulässiger Wert: 06

MerchantID

ans..30

M

HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.

PayID

an32

M

Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

TransID

ans..64

M

Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

MAC

an64

M

Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

refnr

ans..30

O

Eindeutige Referenznummer des Händlers

Amount

n..10

M

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Currency

a3

M

Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle

LocalDate

n4

M

Lokales Datum der Transaktion. Format: MMTT

LocalTime

n6

M

Ortszeit der Transaktion. Format: hhmmss

POSTerminalID

an..20

M

Terminal-ID des PIN-Eingabegeräts

Device

an16

M

Seriennummer des PIN-Eingabegeräts

EntryMode

n3

M

Pflicht für Kreditkarten. POS-Eingabemodus.

CCSeqNr

n3

C

Bei allen Transaktionen erforderlich, bei denen eine Chipkarte vorhanden ist und die Chipkarte eine Kartenfolgenummer enthält, ansonsten bei Anfragen optional.

Track2

an..224

C

Pflicht für Magnetstreifenlesung (MSR). Daten von Track2 für MSR oder Track2Equivalent (Tag 57) (Hex-Darstellung)

EMVData

an..2048

C

EMV-Daten, wie sie zur Weitergabe an den Acquirer benötigt werden (im Hex-Format). Der genaue Aufbau wird durch das verwendete Protokoll bestimmt, das in den Stammdaten des Terminals hinterlegt ist. Wenn keine EMV-Daten verfügbar sind, z.B. für MSR, dann lassen Sie diesen Parameter komplett weg.

DataEncrypted

an..2048

O

Der Händler kann den verschlüsselten Wert von (PAN + Track 2 Equivalent Data im TLV-Format) übermitteln. Dies nur für den Fall, dass der Händler als Nicht-PCI-DSS keine Klartextdaten verarbeiten kann.

DataKSN

an..20

C

Vom Terminal generierter KSN-Wert, der zum Entschlüsseln der im Parameter „DataEncrypted“ vorhandenen Daten erforderlich ist.

Parameter für Incremental

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

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

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

KeyFormatCNDDescription

MessageType

an2

M

Nachrichtentyp für die Anfrage

mid

ans..30

M

HändlerID, die von Computop vergeben wird

PayID

an32

M

Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

XID

an32

M

Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

TransID

ans..64

M

Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

Amount

n..10

M

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Currency

a3

M

Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle

Status

a..50

M

OK (URLSuccess) oder FAILED (URLFailure)

Description

ans..1024

M

Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description, sondern Code für die Auswertung des Transaktionsstatus!

Code

an8

M

Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)

CodeExt

an2

M

Antwortcode des Acquirers

POSTerminalID

an..20

M

Terminal-ID des PIN-Eingabegeräts

VUNr

ans..20

O

Nur bei Kreditkarte: Vertragspartnernummer. In den Händlereinstellungen konfiguriert.

TerminalID

ans..20

O

Nur bei Kreditkarte: ID für den Datenaustausch zwichen Computop und dem Acquirer. In den Händlereinstellungen konfiguriert.

AQ

ans..30

O

Nur wenn konfiguriert: Acquirer Shortcut

TrxTime

ans21

O

Zeitstempel der Transaktion im Format dd.MM.yyyy HH:mm:ssff

OriginalCode

ans3

O

Originaler Antwortcode des Kartensystems

Antwortparameter für Incremental

Manuelle Stornierung (POS)

https://www.computop-paygate.com/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:

KeyFormatCNDDescription

MessageType

an2

M

Nachrichtentyp für die Anfrage. Wird in der Antwort zurückgegeben. Zulässiger Wert: 02

MerchantID

ans..30

M

HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.

PayID

an32

M

Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

TransID

ans..64

M

Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

MAC

an64

M

Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

refnr

ans..30

O

Eindeutige Referenznummer des Händlers

Amount

n..10

M

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Currency

a3

M

Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle

POSTerminalID

an..20

M

Terminal-ID des PIN-Eingabegeräts

Device

an16

M

Seriennummer des PIN-Eingabegeräts

Parameter für Stornierung

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

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

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

KeyFormatCNDDescription

MessageType

an2

M

Nachrichtentyp für die Anfrage

mid

ans..30

M

HändlerID, die von Computop vergeben wird

PayID

an32

M

Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

XID

an32

M

Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

TransID

ans..64

M

Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

Amount

n..10

M

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Currency

a3

M

Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle

Status

a..50

M

OK (URLSuccess) oder FAILED (URLFailure)

Description

ans..1024

M

Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description, sondern Code für die Auswertung des Transaktionsstatus!

Code

an8

M

Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)

CodeExt

an2

M

Antwortcode des Acquirers

POSTerminalID

an..20

M

Terminal-ID des PIN-Eingabegeräts

VUNr

ans..20

O

Nur bei Kreditkarte: Vertragspartnernummer. In den Händlereinstellungen konfiguriert.

TerminalID

ans..20

O

Nur bei Kreditkarte: ID für den Datenaustausch zwichen Computop und dem Acquirer. In den Händlereinstellungen konfiguriert.

AQ

ans..30

O

Nur wenn konfiguriert: Acquirer Shortcut

TrxTime

ans21

O

Zeitstempel der Transaktion im Format dd.MM.yyyy HH:mm:ssff

OriginalCode

ans3

O

Originaler Antwortcode des Kartensystems

Antwortparameter für Stornierung

Automatisches Inkasso (MIT & VISA Resubmission)

Diagramm des Prozessablaufs über Server-zu-Server

Für die Server-zu-Server-Zahlungsvorgänge beachten Sie bitte das Handbuch Programmiergrundlagen.

Prozessablauf einer Zahlung über Server-zu-Server-Schnittstelle

Aufruf der Schnittstelle: allgemeine Parameter

Um einen TLS-Notify über eine Server-zu-Server-Verbindung durchzuführen, verwenden Sie bitte folgende URL:

https://www.computop-paygate.com/direct.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:

KeyFormatCNDDescription

MerchantID

ans..30

M

HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.

TransID

ans..64

M

Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

Amount

n..10

M

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Amount3D

n..12

C

Nur für 3DSecure: Betrag für die Authentifizierung mit Verified, SecureCode und SafeKey, falls der Amount abweicht. Z.B. Kunde bestätigt Flugkosten von 120 Euro mit „Verified“, aber das Reisebüro bucht nur die Buchungsgebühr von 20 Euro: Amount3D=12000; Amount=2000. Betrag in kleinster Währungseinheit (z. B. EUR Cent).

Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Currency

a3

M

Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle

CCNr

n..19

M

Kreditkartennummer mindestens 12-stellig, numerisch ohne Leerzeichen. Optional können Sie auch eine Pseudokartennummer (PKN) übermitteln.

CCCVC

n..4

O

Optional, nicht bei ATOS: Kartenprüfnummer: Die letzten 3 Ziffern auf dem Unterschriftsfeld der Kreditkarte, bei American Express 4 Ziffern.

Pflicht für Clearhaus

CCExpiry

n6

M

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

CCBrand

a..22

M

Kreditkartenmarke.

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

Capture

an..6

OM

Bestimmt Art und Zeitpunkt der Buchung (engl. Capture).

Buchungsart

Beschreibung

AUTO

Buchung sofort nach Autorisierung (Standardwert).

MANUAL

Buchung erfolgt durch den Händler – in der Regel erfolgt die Buchung zum Zeitpunkt der Warenauslieferung bzw. Leistungserbringung.

<Zahl>

Verzögerung in Stunden bis zur Buchung (ganze Zahl; 1 bis 696).

ReqId

ans..32

O

Um Doppelzahlungen (z.B. durch ETM) zu vermeiden, übergeben Sie einen alphanumerischen Wert, der Ihre Transaktion oder Aktion identifiziert und nur einmal vergeben werden darf. Falls die Transaktion oder Aktion mit derselben ReqID erneut eingereicht wird, führt das Computop Paygate keine Zahlung oder weitere Aktion aus, sondern gibt nur den Status der ursprünglichen Transaktion oder Aktion zurück.

Bitte beachten Sie, dass das Computop Paygate für die erste initiale Aktion (Authentifizierung/Autorisierung) einen abgeschlossenen Transaktionsstatus haben muss. Dies gilt nicht für 3-D Secure Authentifizierungen, die durch einem Timeout beendet werden. Der Status 3-D Secure Timeout gilt nicht als abgeschlossener Status, bei dem ReqID-Funktionalität am Paygate nicht greift. Einreichungen mit identischer ReqID auf einen offenen Status werden regulär verarbeitet.

Hinweis: Bitte beachten Sie, dass eine ReqID nur 12 Monate gültig ist, danach wird sie vom Paygate gelöscht.

MAC

an64

M

Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

TermURL

ans..256

C

Nur bei 3DSecure: URL des Shops, der vom Access Control Server (ACS) der Bank ausgewählt wurde, um das Ergebnis der Authentifizierung zu übermitteln. Die Bank übermittelt die Parameter PayID, TransID und MerchantID per GET und den Parameter PAResponse per POST an die TermURL.

UserAgent

ans..128

C

Nur bei 3DSecure: Browsertyp des Käufers, der die Seite anfordert. Zum Beispiel: IE Mozilla/4. 0 (compatible; MSIE 6.0; Windows NT 5.0; NET CLR 1.0.3705)

HTTPAccept

ans..128

C

Nur bei 3DSecure: MIME-Typen, die der Client des Kunden akzeptiert. Z.B. image/gif, image/x-xbitmap, image/jpeg, image/pjpeg, application/vnd. ms-powerpoint, ap-plication/vnd. ms-excel, application/msword, */*

RefNr

ns..15

O

Eindeutige Referenznummer des Händlers

OrderDesc

ans..768

O

Beschreibung der gekauften Waren, Einzelpreise usw.

ChDesc

ans..25

O

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

subMIDAddrCity

ans..13

O

Dieses Feld wird verwendet, um die Standard-Händlerstadt in der Autorisierungsanfrage zu überschreiben. (Eine PTO-Aggregator-ID kann durchgereicht werden)

subMIDName

ans..25

O

Dieses Feld wird verwendet, um den standardmäßigen Händlernamen in der Autorisierungsanfrage zu überschreiben. (Eine PTO-Aggregator-ID kann durchgereicht werden)

AccVerify

a3

O

Bei AccVerify=YES wird die Karte beim Acquirer gemäß der Schnittstellenbeschreibung des Acquirers geprüft. Der Händler muss nur diesen Parameter übermitteln, der Parameter „Amount“ ist optional. Wenn „Amount“ verwendet wird, ersetzen wir den Betrag gemäß der Schnittstellenbeschreibung des Acquirers. Bei Zahlung wird immer Amount=0 gespeichert.

Zulässiger Wert: yes

schemeReferenceID

ans..64

C

Kartensystem-spezifische Transaktions-ID, die für nachfolgende Zahlungen mit hinterlegten Anmeldeinformationen, verzögerte Autorisierungen und erneute VISA-Einreichungen erforderlich ist.

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

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

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

KeyFormatCNDDescription

mid

ans..30

M

HändlerID, die von Computop vergeben wird

PayID

an32

M

Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

XID

an32

M

Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

TransID

ans..64

M

Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

Status

a..50

M

OK oder AUTHORIZED (URLSuccess) sowie FAILED (URLFailure)

Description

ans..1024

M

Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description, sondern Code für die Auswertung des Transaktionsstatus!

Code

an8

M

Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)

PCNr

n16

O

Pseudo Card Number: Vom Computop Paygate generierte Zufallszahl, die eine reale Kreditkartennummer repräsentiert. Die Pseudokartennummer (PKN) beginnt mit 0, und die letzten 3 Stellen entsprechen denen der realen Kartennummer. Die PKN kann wie eine Kreditkartennummer für Autorisierung, Buchung und Gutschriften verwendet werden.

PCNr ist ein Antwortwert vom Computop Paygate und kann ebenfalls als CCNr im Request oder als Teil von card-JSON verwendet werden.

CCExpiry

n6

OC

Optional in Kombination mit PCNr: Ablaufdatum der Kreditkarte im Format JJJJMM (202706)

CCBrand

a..22

OC

Optional in Kombination mit PCNr: Bezeichnung der Kreditkartenmarke.

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

MaskedPan

an..19

OC

Maskierte Kartennummer 6X4

AboID

ans..32

O

Für Abonnements: Eindeutige ID, die dem Abonnement vom Paygate zugewiesen wurde.

CAVV

ans..40

O

Bei Authentication Hosting: Cardholder Authentication Validation Value: Enthält die digitale Signatur zur Authentifizierung beim ACS der kartenausgebenden Bank.

ECI

n2

O

Für 3D Secure: ACS E-Commerce Indicator: Definiert die Sicherheitsstufe einer Kreditkartenzahlung über verschiedene Kommunikationswege: MOTO, SSL, Verified by Visa usw.

DDD

a1

C

for 3D Secure Authentication Hosting:

Y – vollständig authentifiziert (vollständige Authentifizierung erfolgt)

N – nicht angemeldet (geprüft, aber Issuer nimmt nicht teil)

U – nicht berechtigt (technischer Fehler)

A – Versuch (Karte nimmt nicht teil)

B – Bypass (Bypass, nur für Cardinal Commerce)

ACSXID

ans..40

O

Nur bei 2 / 3, mit Authentication Hosting: ID zur Transaktionsidentifikation. Die ACSXID wird mit der Autorisierung an die Acquiring Bank übertragen.

Last4CardholderPAN

n..4

O

VISA die letzten 4 Ziffern der eingeprägten PAN, wenn in der Anfrage eine tokenisierte DPAN verwendet wurde

PAR

ans…999

O

Von VISA/MC bereitgestellte Zahlungskonto-Referenzdaten, die hauptsächlich von MTT-Händlern verwendet werden, um einen Kunden in ihrem Backoffice-System zu identifizieren

OriginalCode

ans3

O

Originaler Antwortcode des Kartensystems

ECOM Inkasso (ATB-Webportal) per Formular

Diagramm des Prozessablaufs über die Formularschnittstelle

Prozessablauf der Kreditkartenzahlung über Formula-Schnittstelle

Für ECOM Inkasso sind die Aufruf- und Antwortparameter die gleichen wie bei der Übermittlung einer normalen E-Commerce-Transaktion.

Hinweis: Als Anforderung in MTT von VISA und MasterCard sollte diese Art von Transaktionen immer über den 3DS-Authentifizierungsprozess durchgeführt werden.

Es besteht die Möglichkeit, solche Transaktionen als 3DS 1.0 über unsere Legacy-API: Kreditkarten einzureichen.

Oder über den neuen Authentifizierungsablauf EMV 3DS 2.0 mit der folgenden Online-API: Kreditkartenformular (paySSL).

Integrationshandbuch und Tools

Nachfolgende Dokumente beschreiben ausführlicher, wie Nachrichten richtig programmiert und an die Computop API-Endpunkte gesendet werden.

Um Programmierern die Integration des Paygate zu erleichtern, gibt es einen hilfreichen ZIP-Ordner mit Code-Beispielen und Funktionen in verschiedenen Programmiersprachen.

Paygate

Documentation (EN)

Dokumentation (DE)

Paygate Status