Buchung / Gutschrift / Storno
Buchung
Buchungen sind über eine Server-zu-Server-Kommunikation möglich. Um eine Buchung (Capture) über eine Server-zu-Server-Verbindung auszuführen, verwenden Sie bitte folgende URL:
Multiexcerpt include | ||||||
---|---|---|---|---|---|---|
|
Table Filter | ||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||
|
Multiexcerpt include | ||||||
---|---|---|---|---|---|---|
|
Table Filter | |||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||
|
Ergebnis-Parameter für Buchungen von Kreditkartenzahlungen
Gutschrift mit Referenz
Gutschriften sind über eine Server-zu-Server-Kommunikation möglich. Das Paygate erlaubt einerseits Gutschriften, die sich auf eine vorher über das Paygate getätigte Buchung beziehen, andererseits können Sie Gutschriften ohne Bezugstransaktion ausführen. Dieses Kapitel beschreibt die Abwicklung von Gutschriften mit Bezugstransaktion. Wenn Sie sich bei einer Gutschrift auf eine Buchung beziehen, dann ist die Höhe der Gutschrift auf die Höhe der vorangegangen Buchung beschränkt.
Um eine Gutschrift (Credit) mit Referenztransaktion auszuführen, verwenden Sie bitte folgende URL:
Multiexcerpt include | ||||||
---|---|---|---|---|---|---|
|
Table Filter | |||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||
|
Parameter für Gutschrift von Kreditkartenzahlungen
Multiexcerpt include | ||||||
---|---|---|---|---|---|---|
|
Table Filter | |||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||
|
Ergebnis-Parameter für Gutschrift von Kreditkartenzahlungen
Gutschrift ohne Referenz
Das Paygate kann für Sie Gutschriften ausführen, die sich nicht auf eine vorherige Buchung beziehen. In diesem Fall muss die Gutschrift als komplett neue Zahlungstransaktion an das Paygate übergeben werden. Um die beschriebene Zusatzfunktion nutzen zu können, nehmen Sie bitte mit dem Computop Helpdesk Kontakt auf.
Hinweis: Bitte beachten Sie, dass Gutschriften ohne Bezug auf eine vorherige Buchung bei Ihrem Acquirer höhere Kosten verursachen. Wenn Sie häufig keinen Bezug auf die Buchung nehmen können, sollten Sie dies mit Ihrem Acquirer abstimmen.
Um eine Gutschrift (Credit) ohne Referenztransaktion über eine Server-zu-Server-Verbindung auszuführen, verwenden Sie bitte folgende URL:
Multiexcerpt include | ||||||
---|---|---|---|---|---|---|
|
Table Filter | ||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||
|
Parameter für Gutschrift von Kreditkartenzahlungen ohne Bezug
Multiexcerpt include | ||||||
---|---|---|---|---|---|---|
|
Table Filter |
---|
Die folgende Tabelle beschreibt die Ergebnis-Parameter, die das Paygate als Antwort zurückgibt:
Table Filter | inverse | ||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
sparkName | Sparkline | ||||||||||||||||||||||
hidePane | true | limitHeight | |||||||||||||||||||||
separator | Point (.) | ||||||||||||||||||||||
| |||||||||||||||||||||||
|
Ergebnis-Parameter für Gutschrift von Kreditkartenzahlungen ohne Bezug
Storno
Eine Kreditkartenautorisierung senkt das Kartenlimit des Kunden. Um das Limit wieder freizugeben, kann das Paygate eine Autorisierung stornieren. Verwenden Sie dazu die folgende URL:
Hinweis: Aus Sicherheitsgründen lehnt das Paygate alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp.
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Request_Intro PageWithExcerpt Reuse API
Hinweis: Die Reverse.aspx macht nicht Hinweis: Die Reverse.aspx macht nicht nur Autorisierungen, sondern IMMER DEN LETZTEN TRANSAKTIONSSCHRITT rückgängig! Falls die letzte Transaktion eine Buchung war, löst die Reverse.aspx z.B. eine Gutschrift aus. Es ist daher größte Vorsicht geboten, und die Nutzung erfolgt auf eigene Gefahr. Wir empfehlen, vor Nutzung der Reverse.aspx den Transaktionsstatus mit der Inquire.aspx prüfen.
Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:
Table Filter | ||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||
|
-----------
Parameter für Storno von Kreditkartenzahlungen
Multiexcerpt include | ||||||
---|---|---|---|---|---|---|
|
Table Filter | ||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||
|
Ergebnis-Parameter für Storno von Kreditkartenzahlungen
Storno einer Autorisierungsverlängerung
Eine Kreditkartenautorisierung ist nur 7 bis 30 Tage gültig. Um Ihren Zahlungsanspruch bei längeren Lieferzeiten zu erhalten, erlaubt das Paygate die automatische Wiederholung der Autorisierung. Auch bei Ratenzahlung oder Teillieferungen ist die Wiederholung der Autorisierung wichtig, weil bei Teilbuchungen der Restbetrag ungültig wird.
Wenn Sie die Autorisierungsverlängerung nutzen, verlängert das Paygate Ihre Autorisierungen, bis die Zahlung komplett gebucht wurde. Unterdessen bleibt das Kartenlimit des Kunden um den autorisierten Betrag reduziert. Um das Kartenlimit freizugeben, zum Beispiel weil der Auftrag nicht vollständig lieferbar ist, müssen Sie die Autorisierungsverlängerung explizit mit folgender URL stoppen:
Hinweis: Mit CancelAuth wird nur die Wiederholung der Autorisierung beendet. Wenn Sie das Kartenlimit des Kunden freigeben wollen, nutzen Sie bitte ein Storno der Autorisierung (siehe oben).
Multiexcerpt include | ||||||
---|---|---|---|---|---|---|
|
Table Filter |
---|
Parameter
Format
CND
Beschreibung
MerchantID
ans..30
M
HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.
PayID
an32
M
ID des Paygate zur Identifizierung einer Zahlung
TransID
ans..64
M
ID des Händlers zur Identifizierung des zu stornierenden Zahlungsvorgangs.
Bitte beachten Sie bei einigen Anbindungen die abweichenden Formate, die bei den spezifischen Parametern angegeben sind.
Amount
n..10
M
Betrag in der kleinsten Währungseinheit (z.B. EUR Cent)
Bitte wenden Sie sich an den Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.
Currency
a3
M
Währungskürzel, drei Zeichen DIN / ISO 4217
MAC
an64
M
Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus
RefNr
ans..30
OC
Eindeutige Referenznummer des Händlers, welche als Auszahlungsreferenz in der entsprechenden Acquirer EPA-Datei angegeben wird. Bitte beachten Sie, ohne die Übergabe einer eigenen Auszahlungsreferenz können Sie die EPA-Transaktionen nicht zuordnen, zusätzlich kann das Computop Settlement File (CTSF) auch nicht zusätzlich angereichert werden.
Nur bei Clearhaus (nur ASCII druckbare Zeichen von 0x20 bis 0x7E), bei MasaPay.
Parameter für Storno von Kreditkartenzahlungen
Die folgende Tabelle beschreibt die Ergebnis-Parameter, die das Paygate als Antwort zurückgibt:
Table Filter | inverse | ||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
sparkName | Sparkline | ||||||||||||||||||||||||
hidePane | true | limitHeight | |||||||||||||||||||||||
separator | Point (.) | ||||||||||||||||||||||||
| |||||||||||||||||||||||||
|
Parameter zur Stornierung einer Autorisierungsverlängerung
Multiexcerpt- |
---|
Parameter
Format
CND
Beschreibung
MID
ans..30
MC
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
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
Transaktionsnummer des Händlers.
Bitte beachten Sie bei einigen Anbindungen die abweichenden Formate, die bei den spezifischen Parametern angegeben sind.
Status
a..50
M
OK oder FAILED
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
n8
M
Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)
RefNr
an..25
OC
Eindeutige Referenznummer des Händlers, welche als Auszahlungsreferenz in der entsprechenden Acquirer EPA-Datei angegeben wird. Bitte beachten Sie, ohne die Übergabe einer eigenen Auszahlungsreferenz können Sie die EPA-Transaktionen nicht zuordnen, zusätzlich kann das Computop Settlement File (CTSF) auch nicht zusätzlich angereichert werden.
Nur bei Card Complete, bei Clearhaus (ans..30, nur ASCII druckbare Zeichen von 0x20 bis 0x7E), bei MasaPay (ns..30)
AID
n6
OC
Nur bei Card Complete: von Card Complete zurückgegebene Autorisierungs-ID
CodeExt
n5
OC
Nur bei Clearhaus: Nur wenn konfiguriert: externer Fehlercode (nachgelagertes System)
Nur bei MasaPay: Format ans..10, Fehlercode von MasaPay
ErrorText
ans.128
OC
Nur bei Clearhaus: Detaillierte Clearhaus Fehlermeldung.
Nur bei MasaPay: Format ans..128, Detaillierte MasaPay Fehlermeldung.
Wird nur bei Status=FAILED zurückgegeben. Nutzung nur in Abstimmung mit dem Computop Support möglich.
TransactionID
ans36
OC
Nur bei Clearhaus: Transaktionsnummer von Clearhaus
Ergebnis-Parameter für Storno von Kreditkartenzahlungen
Include Page | ||||||
---|---|---|---|---|---|---|
|
Table Filter | ||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||
|
Ergebnis-Parameter bei Stornierung einer Autorisierungsverlängerung
Kreditkartenzahlung über stationäre Terminals
Um eine Kreditkartenzahlung über ein stationäres Terminal (POS: Point of Sale) auszuführen, rufen Sie folgende URL auf:
Multiexcerpt include | ||||||
---|---|---|---|---|---|---|
|
Table Filter | ||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||
|
Parameter für Kreditkartenzahlungen über stationäre Terminals
Multiexcerpt include | ||||||
---|---|---|---|---|---|---|
|
Table Filter | ||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||
|
Ergebnis-Parameter für Kreditkartenzahlungen über stationäre Terminals
Storno von stationären Kreditkartenzahlungen
Um die Buchung einer Kreditkartenzahlung über ein stationäres Terminal zu stornieren, verwenden Sie bitte folgende URL:
Multiexcerpt include | ||||||
---|---|---|---|---|---|---|
|
Table Filter |
---|
Storno einer Autorisierungsverlängerung
Eine Kreditkartenautorisierung ist nur 7 bis 30 Tage gültig. Um Ihren Zahlungsanspruch bei längeren Lieferzeiten zu erhalten, erlaubt das Paygate die automatische Wiederholung der Autorisierung. Auch bei Ratenzahlung oder Teillieferungen ist die Wiederholung der Autorisierung wichtig, weil bei Teilbuchungen der Restbetrag ungültig wird.
Wenn Sie die Autorisierungsverlängerung nutzen, verlängert das Paygate Ihre Autorisierungen, bis die Zahlung komplett gebucht wurde. Unterdessen bleibt das Kartenlimit des Kunden um den autorisierten Betrag reduziert. Um das Kartenlimit freizugeben, zum Beispiel weil der Auftrag nicht vollständig lieferbar ist, müssen Sie die Autorisierungsverlängerung explizit mit folgender URL stoppen:
Hinweis: Mit CancelAuth wird nur die Wiederholung der Autorisierung beendet. Wenn Sie das Kartenlimit des Kunden freigeben wollen, nutzen Sie bitte ein Storno der Autorisierung (siehe oben).
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:
Table Filter | inverse | ||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
sparkName | Sparkline | ||||||||||||||||||||||||
hidePane | true | limitHeight | |||||||||||||||||||||||
separator | Point (.) | ||||||||||||||||||||||||
| |||||||||||||||||||||||||
|
Parameter zur Stornierung einer Autorisierungsverlängerung
Die folgende Tabelle beschreibt die Ergebnis-Parameter, die das Paygate als Antwort zurückgibt:
Parameter
Format
CND
Beschreibung
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
TransID
ans..64
M
Transaktionsnummer des Händlers
Status
a..50
M
OK oder FAILED
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
n8
M
Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)
Ergebnis-Parameter bei Stornierung einer Autorisierungsverlängerung
von Kreditkartenzahlungen über stationäre Terminals
Multiexcerpt include | ||||||
---|---|---|---|---|---|---|
|
Table Filter | ||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||
|
Ergebnis-Parameter bei Stornierung von Kreditkartenzahlungen über stationäre Terminals
PayNow
Silent Mode für Kreditkarten mit SSL und 3D-Secure-Verfahren
PayNow verbindet die Vorteile von Paygate-Formularen und Server-zu-Server-Verbindungen: Im Unterschied zum Paygate-Formular, wo durch den Aufruf von payssl.aspx das Formular vom Paygate-Server geladen wird, muss bei PayNow das Formular vom Händlersystem bereitgestellt werden. Das Formular verwendet dieselben Parameter, wie hier nachfolgend beschrieben.
Im Unterschied zum Paygate-Formular werden die Parameter nicht wie beim Aufruf der payssl.aspx als URL-Parameter übergeben, sondern als Formular-Eingabeparameter. Im Übrigen können beim Aufruf der PayNow.aspx die gleichen Parameter wie bei der PaySSL.aspx verwendet werden.
Note |
---|
Bitte beachten Sie, dass der Aufruf der URLSuccess oder URLFailure bei einem Fallback zu 3-D Secure 1.0 mit GET stattfindet. Ihre Systeme sollten daher Parameter sowohl per GET als auch per POST entgegennehmen können. |
Kreditkartenzahlung über stationäre Terminals
Um eine Kreditkartenzahlung über ein stationäres Terminal (POS: Point of Sale) auszuführen, rufen Sie folgende URL auf:
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:
Table Filter | |
---|---|
inverse | |
sparkName | Sparkline |
hidePane | true | limitHeight |
separator | Point (.) | labels |
default | Description |
isFirstTimeEnter | true | cell-width |
hideColumns | true |
datepattern | dd M yy |
id | 1622787983018_-1074105449 |
worklog | 365|5|8|y w d h m|y w d h m |
isOR | AND | order | 0
Multiexcerpt include | |||
---|---|---|---|
|
|
|
----------
Parameter
Format
CND
Beschreibung
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
TransaktionsID, die für jede Zahlung eindeutig sein muss
RefNr
ns..30
O
Eindeutige Referenznummer des Händlers, welche als Auszahlungsreferenz in der entsprechenden Acquirer EPA-Datei angegeben wird. Bitte beachten Sie, ohne die Übergabe einer eigenen Auszahlungsreferenz können Sie die EPA-Transaktionen nicht zuordnen, zusätzlich kann das Computop Settlement File (CTSF) auch nicht zusätzlich angereichert werden.
Das Format muss vorher mit Computop abgestimmt werden!
Amount
n..10
M
Betrag in der kleinsten Währungseinheit (z.B. EUR Cent)
Bitte wenden Sie sich an den Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.
Currency
a3
M
Währungskürzel, drei Zeichen DIN / ISO 4217
CCNr
n..16
M
Kreditkartennummer mind. 12stellig numerisch ohne Leerzeichen
CCCVC
n..4
O
Kartenprüfnummer: Die letzten 3 Ziffern auf dem Unterschriftsfeld der Kreditkarte. Bei American Express 4 Ziffern.
CCExpiry
n6
M
Ablaufdatum der Kreditkarte im Format YYYYMM, z.B. 201707
CCBrand
a..22
M
Kreditkartenmarke.
Bitte beachten Sie die Schreibweise gemäß Tabelle der Kreditkartenmarken!
Track2
ans..80
M
Hexadezimale Daten auf Spur 2 der Kreditkarte
Track3
ans..80
M
Hexadezimale Daten auf Spur 3 der Kreditkarte
Capture
ans..6
O
Bestimmt Art und Zeitpunkt der Buchung (engl. Capture). AUTO: Buchung sofort nach Autorisierung (Standardwert). MANUAL: Buchung erfolgt durch den Händler. <Zahl>: Verzögerung in Stunden bis zur Buchung (ganze Zahl; 1 bis 696).
OrderDesc
ans..768
M
Beschreibung der gekauften Waren, Einzelpreise etc.
MAC
an64
M
Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus
ReqID
ans..32
O
Um Doppelzahlungen zu vermeiden, übergeben Sie einen alphanumerischen Wert, der Ihre Transaktion identifiziert und nur einmal vergeben werden darf. Falls die Transaktion mit derselben ReqID erneut eingereicht wird, führt das Paygate keine Zahlung aus sondern gibt nur den Status der ursprünglichen Transaktion zurück. Bitte beachten Sie, dass das Paygate für die erste initiale Aktion einen abgeschlossenen Transaktionsstatus haben muss. Einreichungen mit identischer ReqID auf einen offenen Status werden regulär verarbeitet.
Die Kreditkartendaten müssen mit folgenden Parametern an paynow.aspx übermittelt werden:
Table Filter | ||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||
|
PayNow-Parameter für 3D-Secure-Verfahren
Nachdem der Kunde seine Kreditkartendaten eingegeben hat, werden die Zahlungsdaten an die PayNow-Seite übertragen, wo die weitere Zahlungsabwicklung inkl. 3D-Secure stattfindet. Die Formulardaten müssen direkt an die PayNow-Seite übertragen werden und dürfen nicht an das Händlersystem übermittelt werden! Auch dürfen keine PCI-relevanten Daten als zusätzliche Eingabeparameter an die PayNow-Seite übermittelt werden!
Batch-Nutzung der Schnittstelle
Grundsätzliche Informationen zur Arbeit mit Batch-Dateien sowie zu deren Aufbau erfahren Sie im separaten Handbuch zum Batchmanager. Im Batch-Verfahren sind nicht alle Funktionen verfügbar, die für die Online-Schnittstelle verfügbar sind.
Batch-Aufrufe und Antworten
Dieses Kapitel beschreibt die Parameter, die Sie im Datensatz (Record) für die Ausführung einer Kreditkartenzahlung übergeben müssen und welche Informationen Sie der Antwort-Datei über den Status des Zahlungsvorgangs entnehmen können.
Hinweis: im Batch-Verfahren sind nicht alle Funktionen der Online-Schnittstelle verfügbar.
Bei den Batch-Aufrufen ist die verwendete Batch-Version zu unterscheiden, wovon die optionalen Parameter abhängen. Alle mit „2.“ beginnen Versionsbezeichnungen betreffen Aufrufe für einen Konzern. Das bedeutet, innerhalb einer Batch-Datei mit einer bestimmten MerchantID können auch Transaktionen anderer Händler mit einer abweichenden Sub-MID übertragen werden.
Für die Anbindungen ECPCC, GMO, Kalixa und SafeCharge beschränken sich die möglichen Actions auf Capture, Credit und Reverse.
Folgende Tabelle gibt eine Übersicht der pro Aktion jeweils möglichen Batch-Versionen und ihrer Besonderheiten:
Table Filter | ||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||
|
Beschreibung der möglichen Batch-Versionen
Der Aufbau für eine Kreditkartenzahlung in einer einzureichenden Batch-Datei sieht folgendermaßen aus:
Multiexcerpt include | ||||||
---|---|---|---|---|---|---|
|
Beispiel für Batch-Versionen:
Multiexcerpt include | ||||||
---|---|---|---|---|---|---|
|
Beispiel für Master MID Funktion:
Parameter für Kreditkartenzahlungen über stationäre Terminals
Die folgende Tabelle beschreibt die Ergebnis-Parameter, die das Paygate als Antwort zurückgibt:
Multiexcerpt include | |||
---|---|---|---|
|
|
|
-----------
Parameter
Format
CND
Beschreibung
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
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
Transaktionsnummer des Händlers
TID
n..20
M
In der Regel neunstellige Terminalnummer
AuthCode
ans..6
M
Autorisierungscode des Acquirers
Status
a..50
M
AUTHORIZED oder FAILED. Nur bei Sale-Transaktionen lautet der Status OK.
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
n8
M
Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)
Ergebnis-Parameter für Kreditkartenzahlungen über stationäre Terminals
Storno von stationären Kreditkartenzahlungen
Um die Buchung einer Kreditkartenzahlung über ein stationäres Terminal zu stornieren, verwenden Sie bitte folgende URL:
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:
Multiexcerpt include | ||||||
---|---|---|---|---|---|---|
|
----
Parameter
Format
CND
Beschreibung
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
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
ID des Händlers zur Identifizierung des zu stornierenden Zahlungsvorgangs
MAC
an64
M
Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus
Parameter zur Stornierung von Kreditkartenzahlungen über stationäre Terminals
Die folgende Tabelle beschreibt die Ergebnis-Parameter, die das Paygate als Antwort zurückgibt:
Multiexcerpt include | ||||||
---|---|---|---|---|---|---|
|
------
Parameter
Format
CND
Beschreibung
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
TransID
ans..64
M
Transaktionsnummer des Händlers
Status
a..50
M
OK oder FAILED
Code
n8
M
Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)
Ergebnis-Parameter bei Stornierung von Kreditkartenzahlungen über stationäre Terminals
PayNow
Silent Mode für Kreditkarten mit SSL und 3D-Secure-Verfahren
PayNow verbindet die Vorteile von Paygate-Formularen und Server-zu-Server-Verbindungen: Im Unterschied zum Paygate-Formular, wo durch den Aufruf von payssl.aspx das Formular vom Paygate-Server geladen wird, muss bei PayNow das Formular vom Händlersystem bereitgestellt werden. Das Formular verwendet dieselben Parameter, wie hier nachfolgend beschrieben.
Im Unterschied zum Paygate-Formular werden die Parameter nicht wie beim Aufruf der payssl.aspx als URL-Parameter übergeben, sondern als Formular-Eingabeparameter. Im Übrigen können beim Aufruf der PayNow.aspx die gleichen Parameter wie bei der PaySSL.aspx verwendet werden.
Note |
---|
Bitte beachten Sie, dass der Aufruf der URLSuccess oder URLFailure bei einem Fallback zu 3-D Secure 1.0 mit GET stattfindet. Ihre Systeme sollten daher Parameter sowohl per GET als auch per POST entgegennehmen können. |
Multiexcerpt include | ||||||
---|---|---|---|---|---|---|
|
----
Paygate-Formular
PayNow
payssl.aspx?MerchantID=[mid]&Len=[len]&Data=[data]
<form action=paynow.aspx>
<input type="hidden" name="MerchantID" value=[mid]>
<input type="hidden" name="Len" value=[len]>
<input type="hidden" name="Data" value=[data]>
:
</form>
Die Kreditkartendaten müssen mit folgenden Parametern an paynow.aspx übermittelt werden:
Multiexcerpt include | ||||||
---|---|---|---|---|---|---|
|
Parameter
Format
CND
Beschreibung
CCNr
n..16
M
Kreditkartennummer: mindestens 12stellig ohne Leerzeichen
CCCVC
n3
O
Kartenprüfnummer: Die letzten 3 Ziffern auf dem Unterschriftsfeld der Kreditkarte
CCExpiry
n6
M
Ablaufdatum der Kreditkarte im Format YYYYMM, z.B. 201807
CCBrand
a..22
M
Kreditkartenmarke.
Bitte beachten Sie die Schreibweise gemäß Tabelle der Kreditkartenmarken!
PayNow-Parameter für 3D-Secure-Verfahren
Nachdem der Kunde seine Kreditkartendaten eingegeben hat, werden die Zahlungsdaten an die PayNow-Seite übertragen, wo die weitere Zahlungsabwicklung inkl. 3D-Secure stattfindet. Die Formulardaten müssen direkt an die PayNow-Seite übertragen werden und dürfen nicht an das Händlersystem übermittelt werden! Auch dürfen keine PCI-relevanten Daten als zusätzliche Eingabeparameter an die PayNow-Seite übermittelt werden!
Batch-Nutzung der Schnittstelle
Grundsätzliche Informationen zur Arbeit mit Batch-Dateien sowie zu deren Aufbau erfahren Sie im separaten Handbuch zum Batchmanager. Im Batch-Verfahren sind nicht alle Funktionen verfügbar, die für die Online-Schnittstelle verfügbar sind.
Batch-Aufrufe und Antworten
Dieses Kapitel beschreibt die Parameter, die Sie im Datensatz (Record) für die Ausführung einer Kreditkartenzahlung übergeben müssen und welche Informationen Sie der Antwort-Datei über den Status des Zahlungsvorgangs entnehmen können.
Hinweis: im Batch-Verfahren sind nicht alle Funktionen der Online-Schnittstelle verfügbar.
Bei den Batch-Aufrufen ist die verwendete Batch-Version zu unterscheiden, wovon die optionalen Parameter abhängen. Alle mit „2.“ beginnen Versionsbezeichnungen betreffen Aufrufe für einen Konzern. Das bedeutet, innerhalb einer Batch-Datei mit einer bestimmten MerchantID können auch Transaktionen anderer Händler mit einer abweichenden Sub-MID übertragen werden.
Für die Anbindungen ECPCC, GMO, Kalixa und SafeCharge beschränken sich die möglichen Actions auf Capture, Credit und Reverse.
Folgende Tabelle gibt eine Übersicht der pro Aktion jeweils möglichen Batch-Versionen und ihrer Besonderheiten:
Aktion
Version
Beschreibung
Authorize
1.2 / 2.2
mit textfeld1, textfeld2, RTF, cardholder, transactionID, schemeReferenceID
1.21 / 2.21
mit textfeld1, textfeld2, RTF, approvalcode, cardholder, transactionID, schemeReferenceID
1.3 / 2.3
mit CVC, transactionID, schemeReferenceID
1.5 / 2.5
mit CVC, Zone
Capture
1.2 / 2.2
mit textfeld1, textfeld2
1.21 / 2.21
mit textfeld1, textfeld2, approvalcode
1.4 / 2.4
mit Stopp der Autorisierungsverlängerung (FinishAuth)
CaptureEx
1.3 / 2.3
mit CVC
Credit
1.2 / 2.2
mit textfeld1, textfeld2
1.21 / 2.21
mit textfeld1, textfeld2
1.4 / 2.4
mit Stopp der Autorisierungsverlängerung (FinishAuth)
CreditEx
1.2 / 2.2
mit textfeld1, textfeld2
1.21 / 2.21
mit textfeld1, textfeld2
1.3 / 2.3
mit textfeld1, textfeld2
Sale
1.2 / 2.2
mit textfeld1, textfeld2, RTF, cardholder, transactionID, schemeReferenceID
1.21 / 2.21
mit textfeld1, textfeld2, RTF, approvalcode, cardholder, transactionID, schemeReferenceID
1.3 / 2.3
mit CVC, textfeld1, textfeld2, transactionID, schemeReferenceID
1.5 / 2.5
mit CVC, Zone
Reverse
1.x / 2.x
Standardversion
Beschreibung der möglichen Batch-Versionen
Der Aufbau für eine Kreditkartenzahlung in einer einzureichenden Batch-Datei sieht folgendermaßen aus:
HEAD,<MerchantID>,<Date>,<Version>
CC,Authorize,<Amount>,<Currency>,<TransID>,(<RefNr>),<CCBrand>,<CCNr|PCNr>, [<CCCVC>,]<CCExpiry>,<OrderDesc>[,<textfeld1>,<textfeld2>,<RTF>,<approvalcode>,<cardholder>,<Zone>,<transactionID>,<schemeReferenceID>]
CC,Capture,<Amount>,<Currency>,<TransID>,(<RefNr>),<PayID>,[<FinishAuth,<textfeld1>,<textfeld2>,<approvalcode>]
CC,Sale,<Amount>,<Currency>,<TransID>,(<RefNr>),<CCBrand>,<CCNr|PCNr>, [<CCCVC>,]<CCExpiry>,<OrderDesc>[,<textfeld1>,<textfeld2>,<RTF>,<approvalcode>,<cardholder>,<Zone>,<transactionID>,<schemeReferenceID>]]
CC,Credit,<Amount>,<Currency>,<TransID>,(<RefNr>),<PayID>[,<FinishAuth>,<textfeld1>,<textfeld2>]
CC,CreditEx,<Amount>,<Currency>,<TransID>,(<RefNr>),<CCBrand>,<CCNr|PCNr>, [<CCCVC>,]<CCExpiry>,<OrderDesc>[,<textfeld1>,<textfeld2>]
CC,Reverse,<Amount>,<Currency>,<TransID>,(<RefNr>),<PayID>
FOOT,<CountRecords>,<SumAmount>
Beispiel für Batch-Versionen:
Version 1.2:
CC,Sale,<Amount>,<Currency>,<TransID>,(<RefNr>),<CCBrand>,<CCNr|PCNr>,<CCExpiry>,<OrderDesc>
CC,Sale,<Amount>,<Currency>,<TransID>,(<RefNr>),<CCBrand>,<CCNr|PCNr>,<CCExpiry>,<OrderDesc>,<textfeld1>,<textfeld2>,<RTF>,<cardholder>,<transactionID>,<schemeReferenceID>
Version 1.21:
CC,Sale,<Amount>,<Currency>,<TransID>,(<RefNr>),<CCBrand>,<CCNr|PCNr>,<CCExpiry>,<OrderDesc>,<textfeld1>,<textfeld2>,<RTF>,<approvalcode>,<cardholder>,,<transactionID>,<schemeReferenceID>
Version 1.3:
CC,Sale,<Amount>,<Currency>,<TransID>,(<RefNr>),<CCBrand>,<CCNr|PCNr>,<CCCVC>,<CCExpiry>,<OrderDesc>,<textfeld1>,<textfeld2>,<transactionID>,<schemeReferenceID>
Version 1.5:
CC,Sale,<Amount>,<Currency>,<TransID>,(<RefNr>),<CCBrand>,<CCNr|PCNr>,<CCCVC>,<CCExpiry>,<OrderDesc>,<Zone>
Beispiel für Master MID Funktion:
HEAD,[Master]MerchantID,Date,2.x
Type,Action,[Slave]MID,Amount,Currency,TransID,Data (depends on Action)
FOOT,CountRecords,SumAmount
Die folgende Tabelle beschreibt die einzelnen Felder und Werte, die im Datensatz (Record) innerhalb der Batch-Datei verwendet werden:
Parameter
Format
CND
Beschreibung
Type
a..11
M
HEAD für Header, FOOT für Footer, CC für Kreditkarte
Action
a..20
M
Der Action-Parameter definiert die Art der Transaktion:
Authorize (Autorisierung)
Capture (Buchung)
Sale (Verkauf)
Credit (Gutschrift)
CreditEx (Gutschrift ohne vorherige Buchung; bitte stimmen sie sich hierzu vorher mit dem Computop Support ab)
Reverse (Storno)
Amount
n..10
M
Betrag in der kleinsten Währungseinheit (z.B. EUR Cent)
Bitte wenden Sie sich an den Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.
Currency
a3
M
Währungskürzel, drei Zeichen DIN / ISO 4217
TransID
ans..64
M
TransaktionsID, die für jede Zahlung eindeutig sein muss.
Bitte beachten Sie bei einigen Anbindungen die abweichenden Formate, die bei den spezifischen Parametern angegeben sind.
RefNr
ns..30
O
Eindeutige Referenznummer des Händlers, welche als Auszahlungsreferenz in der entsprechenden Acquirer EPA-Datei angegeben wird. Bitte beachten Sie, ohne die Übergabe einer eigenen Auszahlungsreferenz können Sie die EPA-Transaktionen nicht zuordnen, zusätzlich kann das Computop Settlement File (CTSF) auch nicht zusätzlich angereichert werden.
PayID
an32
M
Vom Paygate vergebene ID für diese Transaktion
OrderDesc
ans..127
O
Beschreibung der gekauften Waren, Einzelpreise etc.
CCBrand
a..22
C
Kreditkartenmarke.
Bitte beachten Sie die Schreibweise gemäß Tabelle der Kreditkartenmarken!
CCNr
n..16
C
Kreditkartennummer mind. 12stellig numerisch ohne Leerzeichen. Optional können Sie auch eine Pseudokartennummer (PKN) übergeben
PCNr
n..16
O
Optional können Sie auch eine Pseudokartennummer (PKN) anstatt der echten Kreditkartennummer übergeben
CCCVC
n..4
O
Kartenprüfnummer in Version 1.3: Bei Visa und MasterCard die letzten 3 Ziffern auf dem Unterschriftsfeld der Kreditkarte. Bei American Express 4 Ziffern.
CCExpiry
n6
O
Ablaufdatum der Kreditkarte im Format YYYYMM, z.B. 201707
FinishAuth
ans1
O
Version=1.4: Wenn Sie die Autorisierungsverlängerung nutzen, stoppen Sie die Wiederholung mit dem Wert Y im Feld FinishAuth bei Capture oder Credit. Beispiel: Sie buchen eine Teillieferung. Der Rest der Bestellung ist nicht lieferbar. Daher übergeben Sie beim Capture der Teilbuchung im Feld FinishAuth Y, damit das Paygate den Restbetrag nicht wieder au-torisiert. Beachten Sie dazu auch den folgenden Abschnitt zum Stopp von Autorisierungsverlängerungen.
Beschreibung der Felder im Datensatz von Batch-Dateien
Der Record-Bereich in der Antwort-Datei zu Batch-Transaktionen sieht folgendermaßen aus:
|
Die folgende Tabelle beschreibt die einzelnen Felder und Werte, die im Datensatz (Record) innerhalb der Batch-Datei verwendet werden:
Table Filter | ||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||
|
Beschreibung der Felder im Datensatz von Batch-Dateien
Der Record-Bereich in der Antwort-Datei zu Batch-Transaktionen sieht folgendermaßen aus:
Multiexcerpt include | ||||||
---|---|---|---|---|---|---|
|
Beispiel für Batch-Versionen:
Multiexcerpt include | ||||||
---|---|---|---|---|---|---|
|
HEAD,<MerchantID>,<Date>,<Version>
CC,Authorize,<Amount>,<Currency>,<TransID>,(<RefNr>),<PayID>,<CCBrand>,<CCNr|PCNr>,[<CCCVC>,]<CCExpiry>,<OrderDesc>[,<textfeld1>,<textfeld2>,<RTF>,<approvalcode>,<cardholder>,<Zone>,<transactionID>,<schemeReferenceID>],<Status>,<Code>
CC,Capture,<Amount>,<Currency>,<TransID>,(<RefNr>),<PayID>[<textfeld1>,<textfeld2>,<approvalcode>],<Status>,<Code>
CC,AuthSplit,<Amount>,<Currency>,<TransID>,(<RefNr>),<PayID>,FAILED,<Code>,<Description>,[<PCNr>]
CC,Renewal,<Amount>,<Currency>,<TransID>,(<RefNr>),<PayID>,FAILED,<Code>,<Description>,[<PCNr>]
CC,Sale,<Amount>,<Currency>,<TransID>,(<RefNr>),<PayID>,<CCBrand>,<CCNr|PCNr>,[<CCCVC>,]<CCExpiry>,<OrderDesc>[,<textfeld1>,<textfeld2>,<RTF>,<approvalcode>,<cardholder>,<Zone>,<transactionID>,<schemeReferenceID>],<Status>,<Code>
CC,Credit,<Amount>,<Currency>,<TransID>,(<RefNr>),<PayID>[,<FinishAuth>,<textfeld1>,<textfeld2>],<Status>,<Code>
CC,CreditEx,<Amount>,<Currency>,<TransID>,(<RefNr>),<CCBrand>,<CCNr|PCNr>,[<CCCVC>,]<CCExpiry>,<OrderDesc>[,<textfeld1>,<textfeld2>],<Status>,<Code>
CC,Reverse,<Amount>,<Currency>,<TransID>,(<RefNr>),<PayID>,<Status>,<Code>
FOOT,<CountRecords>,<SumAmount>
Beispiel für Batch-Versionen:
Version 1.2:
CC,Sale,<Amount>,<Currency>,<TransID>,(<RefNr>),<CCBrand>,<CCNr|PCNr>,<CCExpiry>,<OrderDesc>,<Status>,<Code>
CC,Sale,<Amount>,<Currency>,<TransID>,(<RefNr>),<CCBrand>,<CCNr|PCNr>,<CCExpiry>,<OrderDesc>,<textfeld1>,<textfeld2>,<RTF>,<cardholder>,<transactionID>,<schemeReferenceID>,<Status>,<Code>
Version 1.21:
CC,Sale,<Amount>,<Currency>,<TransID>,(<RefNr>),<CCBrand>,<CCNr|PCNr>,<CCExpiry>,<OrderDesc>,<textfeld1>,<textfeld2>,<RTF>,<approvalcode>,<cardholder>,<transactionID>,<schemeReferenceID>,<Status>,<Code>
Version 1.3:
CC,Sale,<Amount>,<Currency>,<TransID>,(<RefNr>),<CCBrand>,<CCNr|PCNr>,<CCCVC>,<CCExpiry>,<OrderDesc>,<textfeld1>,<textfeld2>,<transactionID>,<schemeReferenceID>,<Status>,<Code>
Version 1.5:
CC,Sale,<Amount>,<Currency>,<TransID>,(<RefNr>),<CCBrand>,<CCNr|PCNr>,<CCCVC>,<CCExpiry>,<OrderDesc>,<Zone>,<Status>,<Code>
Die folgende Tabelle beschreibt die Antwort-Parameter, die der Batch-Manager im Record-Bereich zu jeder Transaktion speichert (hier nicht erklärte Standardparameter wie etwa <TransID> oder <RefNR> und Aufrufparameter, werden unverändert zum Aufruf wieder zurückgegeben und sind vorstehend beschrieben):
Parameter
Format
CND
Beschreibung
Action
a..20
M
Der Action-Parameter definiert die Art der Transaktion wie Capture (Buchung) oder Credit (Gutschrift) – siehe oben.
PayID
an32
M
Vom Paygate vergebene ID für diese Transaktion
Status
a..50
M
OK oder FAILED
Code
n8
M
Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)
PCNr
n..16
C
Table Filter | ||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||
|
Beschreibung der Ergebnis-Parameter im Datensatz von Batch-Dateien
Stopp von Autorisierungsverlängerungen
Mit einer Kreditkartenautorisierung erwerben Sie einen Zahlungsanspruch. Allerdings verfällt eine Autorisierung nach spätestens 30 Tagen oder auch, wenn Sie einen Teilbetrag buchen, zum Beispiel weil mehrere Teillieferungen nötig sind. Um Ihren Zahlungsanspruch in solchen Fällen wiederherzustellen, kann das Paygate eine verfallene Autorisierung automatisch wiederholen.
Falls eine Bestellung nicht lieferbar ist oder vom Kunden storniert wurde, ist es sehr wichtig, dass Sie die automatischen Autorisierungen stoppen. Andernfalls wird das Kartenlimit Ihres Kunden dauerhaft reduziert, weil das Paygate die Karte Ihres Kunden immer wieder neu belastet.
Im Normalfall stoppt das Paygate die Autorisierungsverlängerung, wenn der autorisierte Betrag komplett gebucht wurde. Sie können die Autorisierungsverlängerung in der Batch-Version 1.4 aber auch manuell stoppen, indem Sie den Zahlungsstatus ändern. Zu diesem Zweck reichen Sie in Ihrer Batch-Datei eine Buchung ein, deren Betrag unter dem zulässigen Limit liegt. Da das Paygate Kreditkartenbuchungen unter 1,00 Euro ablehnt, ändert sich der Zahlungsstatus bei geringeren Beträgen auf FAILED. Das Paygate wird diese Autorisierung deshalb nicht weiter verlängern. Ein entsprechender Capture-Eintrag mit 0,05 EUR sieht beispielsweise so aus:
|
Da der Betrag von 5 Cent unter dem Mindestbetrag von 1,00 Euro liegt, lehnt das Paygate die Buchung mit der Fehlermeldung MinValue ab. Die Zahlung erhält dann den Status FAILED, so dass die Autorisierungsverlängerung gestoppt wird.