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.
Paygate-Schnittstelle
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) CND Bedingung (condition) M Pflicht (mandatory) O optional C bedingt (conditional) Hinweis: Bitte beachten Sie, dass die Bezeichnungen der Parameter in Groß- oder Kleinbuchstaben zurückgegeben werden können.Definitionen
Datenformate
Format Beschreibung Abkürzungen
Abkürzung Beschreibung Kommentar Wenn ein Parameter Pflicht ist, dann muss er vorhanden sein Wenn ein Parameter optional ist, dann kann er vorhanden sein, ist aber nicht erforderlich Wenn ein Parameter bedingt ist, dann gibt es eine Bedingungsregel, die angibt, ob er Pflicht oder optional ist
POS-initiierte Transaktionstypen (aggregierte / verzögerte Autorisierungen)
Nachfolgend die Schnittstellenbeschreibung, die zur Übermittlung von Mass Transportation Transaktionstypen relevant ist.
Integrations-System: https://dev.computop.de/Paygate/posPayment.aspx
Produktiv-System: …/posPayment.aspx
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:
Key | Format | CND | Beschreibung |
|---|---|---|---|
MessageType | an2 | M | Nachrichtentyp für die Anfrage. Zulässige Werte: 01 Verkauf (zweistufige Transaktion) 05 Vorautorisierung, Autorisierung |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
ans..30 | M | HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben. |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| TransID | ans..64 | M | Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss |
Key | Format | CND | Beschreibung |
|---|---|---|---|
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. |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
an64 | M | Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier: |
Key | Format | CND | Beschreibung |
|---|---|---|---|
| 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. mid, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden
Key | Format | CND | Beschreibung |
|---|---|---|---|
MessageType | an2 | M | Nachrichtentyp für die Anfrage |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
ans..30 | M | HändlerID, die von Computop vergeben wird |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| PayID | an32 | M | Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request. |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| XID | an32 | M | Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| TransID | ans..64 | M | Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| Status | a..50 | M | OK (URLSuccess) oder FAILED (URLFailure) |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| 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! |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| Code | an8 | M | Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes) |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| refnr | ans..30 | O | Eindeutige Referenznummer des Händlers |
Key | Format | CND | Beschreibung |
|---|---|---|---|
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 | Bei Kreditkarte: Acquirer-Antwort (Hex-Darstellung). Besteht aus ‚Issuer Authorization Response Code‘ (Tag 8A), Issuer Scripts (Tag 71, 72), Issuer Authentication Data (Tag 91) usw. Bei ELV: IBAN (Tag 5F53) und Gläubiger-ID (Tag DF65), Format siehe Anhang EMV-Datenelemente |
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 zwischen 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 |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| 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 von Computop Paygate und kann ebenfalls als CCNr im Request oder als Teil von card-JSON verwendet werden. |
Key | Format | CND | Beschreibung |
|---|---|---|---|
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)
Integrations-System: https://dev.computop.de/Paygate/posPayment.aspx
Produktiv-System: …/posPayment.aspx
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:
Key | Format | CND | Beschreibung |
|---|---|---|---|
MessageType | an2 | M | Nachrichtentyp für die Anfrage. Wird in der Antwort zurückgegeben. Zulässiger Wert: 06 |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
ans..30 | M | HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben. |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| PayID | an32 | M | Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request. |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| TransID | ans..64 | M | Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
an64 | M | Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier: |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| refnr | ans..30 | O | Eindeutige Referenznummer des Händlers |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| 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. |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| Currency | a3 | M | Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle |
Key | Format | CND | Beschreibung |
|---|---|---|---|
| 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. mid, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden
Key | Format | CND | Beschreibung |
|---|---|---|---|
MessageType | an2 | M | Nachrichtentyp aus der Anfrage |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
ans..30 | M | HändlerID, die von Computop vergeben wird |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| PayID | an32 | M | Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request. |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| XID | an32 | M | Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| TransID | ans..64 | M | Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| 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. |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| Currency | a3 | M | Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| Status | a..50 | M | OK (URLSuccess) oder FAILED (URLFailure) |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| 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! |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| Code | an8 | M | Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes) |
Key | Format | CND | Beschreibung |
|---|---|---|---|
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 zwischen 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)
Integrations-System: https://dev.computop.de/Paygate/posPayment.aspx
Produktiv-System: …/posPayment.aspx
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:
Key | Format | CND | Beschreibung |
|---|---|---|---|
MessageType | an2 | M | Nachrichtentyp für die Anfrage. Wird in der Antwort zurückgegeben. Zulässiger Wert: 02 |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
ans..30 | M | HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben. |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| PayID | an32 | M | Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request. |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| TransID | ans..64 | M | Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
an64 | M | Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier: |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| refnr | ans..30 | O | Eindeutige Referenznummer des Händlers |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| 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. |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| Currency | a3 | M | Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle |
Key | Format | CND | Beschreibung |
|---|---|---|---|
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. mid, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden
Key | Format | CND | Beschreibung |
|---|---|---|---|
MessageType | an2 | M | Nachrichtentyp aus der Anfrage |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
ans..30 | M | HändlerID, die von Computop vergeben wird |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| PayID | an32 | M | Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request. |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| XID | an32 | M | Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| TransID | ans..64 | M | Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| 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. |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| Currency | a3 | M | Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| Status | a..50 | M | OK (URLSuccess) oder FAILED (URLFailure) |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| 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! |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| Code | an8 | M | Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes) |
Key | Format | CND | Beschreibung |
|---|---|---|---|
CodeExt | an2 | M | Antwortcode des Acquirers |
POSTerminalID | an..20 | M | Terminal-ID des PIN-Eingabegeräts |
VUNr | ans..20 | O | Nur bei Kreditkarte: Vertragspartnernummer |
TerminalID | ans..20 | O | Nur bei Kreditkarte: ID für den Datenaustausch zwischen 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:
| Key | Format | CND | Beschreibung |
|---|---|---|---|
ans..30 | M | HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben. |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| TransID | ans..64 | M | Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| 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. |
Key | Format | CND | Beschreibung |
|---|---|---|---|
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. |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| Currency | a3 | M | Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle |
Key | Format | CND | Beschreibung |
|---|---|---|---|
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! |
| Key | Format | CND | Beschreibung | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Capture | an..6 | OM | Bestimmt Art und Zeitpunkt der Buchung (engl. Capture).
|
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| 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. |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
an64 | M | Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier: |
Key | Format | CND | Beschreibung |
|---|---|---|---|
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. mid, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden
| Key | Format | CND | Beschreibung |
|---|---|---|---|
ans..30 | M | HändlerID, die von Computop vergeben wird |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| PayID | an32 | M | Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request. |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| XID | an32 | M | Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| TransID | ans..64 | M | Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| Status | a..50 | M | OK oder AUTHORIZED (URLSuccess) sowie FAILED (URLFailure) |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| 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! |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| Code | an8 | M | Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes) |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| 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 von Computop Paygate und kann ebenfalls als CCNr im Request oder als Teil von card-JSON verwendet werden. |
Key | Format | CND | Beschreibung |
|---|---|---|---|
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.