-Schnittstelle

Allgemeine Terminalanfragen

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

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 bitte: https://dev.computop.de/Paygate/posPayment.aspx.

Allgemeine Parameter für Terminalzahlungen mit POS Payment

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 bitte: https://dev.computop.de/Paygate/posPayment.aspx.

Parameter für POS-Zahlungen mit Kreditkarte

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 bitte: https://dev.computop.de/Paygate/posPayment.aspx.

Parameter für Buchungen von POS-Zahlungen

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 bitte: https://dev.computop.de/Paygate/posPayment.aspx.

Parameter für POS-Zahlungen mit Girocard

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 bitte: https://dev.computop.de/Paygate/posPayment.aspx.

Parameter für POS-Zahlungen mit Alipay oder Wechat

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 bitte: https://dev.computop.de/Paygate/posPayment.aspx.

Parameter für POS-Zahlungen mit easyCredit

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 bitte: https://dev.computop.de/Paygate/posPayment.aspx.

Parameter zur Abfrage von Informationen zu POS-Zahlungen

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 bitte: https://dev.computop.de/Paygate/posPayment.aspx.

Parameter für die Stornierung von POS-Zahlungen

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 bitte: https://dev.computop.de/Paygate/posPayment.aspx.

Parameter für manuelle Stornierung von POS-Zahlungen

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 bitte: https://dev.computop.de/Paygate/posPayment.aspx.

Parameter für Gutschriften von POS-Zahlungen

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 bitte: https://dev.computop.de/Paygate/posPayment.aspx.

Parameter für Erhöhung von POS-Zahlungen

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.

Parameter für DCC-Anfragen

Antwortparameter für DCC-Anfragen

Terminalkonfiguration

Rufen Sie die Terminalkonfigurationsdaten vom  ab. 

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

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

Parameter zum Abrufen von POS-Terminalkonfigurationsdaten

Antwortparameter zum Abrufen von POS-Terminalkonfigurationsdaten

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

Rufen Sie die Terminalkonfigurationsdaten vom  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.

Parameter zum Abrufen von POS-Terminalkonfigurationsdaten

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:

Zusätzliche Parameter für die Nutzung des Zahlungsvermittlers

CUT-OFF

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

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:

Die folgenden Tags sind für eine Kreditkartenzahlung optional:

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

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