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:
https://www.computop-paygate.com/
capture.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:
Bitte beachten Sie die Reservierungs- / Autorisierungsfristen Ihres Acquirers (siehe AGBs), damit Sie als Händler sicherstellen, dass die Abbuchungen in der korrekten Frist an unserem
EN Multiexcerpt include SpaceWithExcerpt
capture_requestDE MultiExcerptName Platform-Kurz PageWithExcerpt
----
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 zu buchende Transaktion
TransID
ans..64
M
Vom Händler initial vergebene ID für den zu buchenden Zahlungsvorgang.
Bitte beachten Sie bei einigen Anbindungen die abweichenden Formate, die bei den spezifischen Parametern angegeben sind.
MAC
an64
M
Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus
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
RefNr
ns..30
C
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.
(nicht bei EVO Payments, bei CardComplete im Format an..25, bei Cofidis im Format n..15, bei Omnipay im Format ns..15, bei RBI im Format ns..20)
FinishAuth
a1
C
Nur bei ETM: Übergeben Sie den Wert <Y>, um bei Teilbuchungen die Autorisierungserneuerung oder die Reservierung des Restbetrages zu stoppen. Bitte nutzen Sie den Parameter nur, wenn Sie die Zusatzfunktion ETM (Erweitertes Transaktions-Managament) nutzen. (Nicht bei Clearhaus)
Textfeld1
ans..30
O
Karteninhaber-Information: Name (Nicht bei Clearhaus)
Textfeld2
ans..30
O
Karteninhaber-Information: Ort (Nicht bei Clearhaus)
CHDesc
ans..22
OC
Nur bei Clearhaus: Text, der auf der Kreditkartenabrechnung angezeigt wird. Nur ASCII druckbare Zeichen von 0x20 bis 0x7E
Parameter für Buchungen von Kreditkartenzahlungen
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.
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
ns..30
C
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.
(nicht bei EVO Payments, bei Card Complete im Format an..25, bei Omnipay im Format ns..15, bei RBI im Format ns..20)
AID
n6
OC
Nur bei Card Complete: von Card Complete zurückgegebene Autorisierungs-ID
Amount
n..10
OC
Nur bei Clearhaus: Betrag in der kleinsten Währungseinheit (z.B. EUR Cent)
Sollte der tatsächliche Betrag vom angefragten Betrag abweichen, wird dieser zurückgegeben.
Nur bei MasaPay: Betrag muss gleich dem ursprünglich autorisierten Betrag sein.
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
GuWID
ans..22
O
Nur bei Wirecard: TransaktionsID des Acquirers
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:
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 gutzuschreibende Transaktion
TransID
ans..64
M
Vom Händler initial vergebene ID für den gutzuschreibenden Zahlungsvorgang.
Bitte beachten Sie bei einigen Anbindungen die abweichenden Formate, die bei den spezifischen Parametern angegeben sind.
RefNr
an..25
C
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 CardComplete, bei Clearhaus (ns..30, optional, nur ASCII druckbare Zeichen von 0x20 bis 0x7E), bei RBI (ns..20, optional), bei MasaPay (ns..30, optional), bei Cofidis (n..15, optional)
MAC
an64
M
Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus
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
OrderDesc
ans..768
O
Beschreibung der gutgeschriebenen Artikel, Einzelpreise, Händlerkommentar etc. (Nicht bei Clearhaus)
Textfeld1
ans..30
O
Karteninhaber-Information: Name (Nicht bei Clearhaus)
Textfeld2
ans..30
O
Karteninhaber-Information: Ort (Nicht bei Clearhaus)
CHDesc
ans..22
OC
Nur bei Clearhaus: Text, der auf der Kreditkartenabrechnung angezeigt wird. Nur ASCII druckbare Zeichen von 0x20 bis 0x7E
TID
ans..30
OC
Nur bei SafeCharge: TransaktionsID der gutzuschreibenden Buchung, falls der Händler eine bestimmte Buchung gutschreiben möchte. Wenn der Parameter nicht angegeben ist, wird die letzte Buchung gutgeschrieben.
Kontonnummer des Senders.
Mastercard: Pflicht. Visa: Pflicht, wenn die RefNr leer ist.
Vorname des Senders.
Mastercard: Pflicht. Visa: Pflicht für US-Inlandstransaktionen und grenzüberschreitende Zahlungen.
Nachname des Senders.
Mastercard: Pflicht. Visa: Optional.
Straßenname des Senders.
Mastercard: Optional. Visa: Pflicht für US-Inlandstransaktionen und grenzüberschreitende Zahlungen.
Haunsummer des Senders.
Mastercard: Optional. Visa: Pflicht für US-Inlandstransaktionen und grenzüberschreitende Zahlungen.
Ort des Senders.
Mastercard: Optional. Visa: Pflicht für US-Inlandstransaktionen und grenzüberschreitende Zahlungen.
Bundesland des Senders.
Mastercard: Pflicht, wenn senderAddrCountry=US oder Canada. Visa: Pflicht für US-Inlandstransaktionen und grenzüberschreitende Zahlungen.
Land des Senders.
Mastercard: Optional. Visa: Pflicht, wenn das Land US ist, und bei grenzüberschreitende Zahlungen.
Parameter für Gutschrift von Kreditkartenzahlungen
eingereicht werden.Wording
Multiexcerpt include | ||||||
---|---|---|---|---|---|---|
|
Table Filter | ||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||
|
Parameter für Buchungen von Kreditkartenzahlungen
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
erlaubt einerseits Gutschriften, die sich auf eine vorher über das Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Platform-Kurz PageWithExcerpt Wording
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. Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Platform-Kurz PageWithExcerpt Wording
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
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 Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Platform-Kurz PageWithExcerpt Wording
übergeben werden. Um die beschriebene Zusatzfunktion nutzen zu können, nehmen Sie bitte mit dem Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Platform-Kurz PageWithExcerpt Wording
Kontakt auf. Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Helpdesk-Name PageWithExcerpt Wording
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 | ||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||
|
Ergebnis-Parameter für Gutschrift von Kreditkartenzahlungen ohne Bezug
Storno
Eine Kreditkartenautorisierung senkt das Kartenlimit des Kunden. Um das Limit wieder freizugeben, kann das
Multiexcerpt include | ||||||
---|---|---|---|---|---|---|
|
|
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.
Multiexcerpt include | ||||||
---|---|---|---|---|---|---|
|
Table Filter | ||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
|
|
|
----
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.
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)
AID
n6
OC
Nur bei Card Complete: von Card Complete zurückgegebene Autorisierungs-ID
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 RBI (ns..20, optional), bei MasaPay (ns..30, optional), bei Cofidis (n..15, optional).
Amount
n..10
OC
Nur bei Clearhaus: Betrag in der kleinsten Währungseinheit (z.B. EUR Cent)
Sollte der tatsächliche Betrag vom angefragten Betrag abweichen, wird dieser zurückgegeben.
Nur bei MasaPay: Betrag muss gleich dem ursprünglich autorisierten Betrag sein.
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 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:
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.
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.
Bei CardComplete Format an..25
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!
MAC
an64
M
Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus
OrderDesc
ans..768
MC
Nicht bei Clearhaus: Beschreibung der gutgeschriebenen Artikel, Einzelpreise, Händlerkommentar etc.
UserData
ans..1024
OC
Nur bei Clearhaus: Wenn beim Aufruf angegeben, übergibt das Paygate die Parameter mit dem Zahlungsergebnis an den Shop
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.
Textfeld1
ans..30
O
Nicht bei Clearhaus: Karteninhaber-Information: Name
Textfeld2
ans..30
O
Nicht bei Clearhaus: Karteninhaber-Information: Ort
CHDesc
ans..34
OC
Nur bei Clearhaus, Format ans..22: Text, der auf der Kreditkartenabrechnung angezeigt wird. Nur ASCII druckbare Zeichen von 0x20 bis 0x7E
Nur bei Credorax: Text, der auf der Kreditkartenabrechnung angezeigt wird.
Diese Funktion muss von Credorax freigeschalten werden und folgenden Aufbau haben.
1) merchant DBA Name (bis zu 20 Zeichen)
2) Stern
3) zusätzlicher Text (bis zu 13 Zeichen).
z.B. Computop*Test
Dieser Wert kann alternativ vom Computop Support fest hinterlegt werden.
CreditCardHolder
an..255
MC
Nur bei Credorax, ECPCC: Name des Karteninhabers
ans..64
MC
Nur bei Credorax, ECPCC: E-Mail-Adresse des Kunden
IPAddr
ans..15
OC
Nur bei Credorax, ECPCC: IP-Adresse des Kunden
PaymentOfWinnings
ans..4
OC
Beim Acquirer EMS (Omnipay) kann der Händler hiermit CFT-Gutschriften steuern.
Übergeben Sie PaymentOfWinnings=True, um einen Gewinn gutzuschreiben, anstatt nur einen eingezahlten Betrag zurückzuerstatten.
TransactionID
an..150
M
Zusätzliche Referenznummer
Weitere Adressparameter bei der Anbindung ECPCC
DateOfBirth
n8
O
Geburtsdatum des Kunden im Format YYYYYMMDD
Phone
n..32
O
Telefonnummer des Kunden
FirstName
ans..255
M
Vorname des Kunden
LastName
ans..255
M
Nachname des Kunden
AddrStreet
ans..255
O
Straßenname
AddressAddition
ans..255
O
Adresszusatz
AddrZip
an..9
O
Postleitzahl
AddrCity
ans..255
O
Ort
AddrState
a2
O
Code des Bundeslandes des Kunden
AddrCountryCode
a2
M
Ländercode im Format ISO-3166-1, alphanumerisch 2-stellig
sdFirstName
ans..255
O
Vorname in der Lieferanschrift
sdLastName
ans..255
O
Nachname in der Lieferanschrift
sdStreet
ans..255
O
Straßenname der Lieferanschrift
sdAddressAddition
ans..255
O
Adresszusatz der Lieferanschrift
sdZIPCode
an..9
O
Postleitzahl der Lieferanschrift
sdCity
ans..255
O
Ort der Lieferanschrift
sdState
a2
O
Code des Bundeslandes der Lieferanschrift
sdCountryCode
a2
O
Ländercode der Lieferanschrift im Format ISO-3166-1, alphanumerisch 2-stellig
Weitere Adressparameter bei der Anbindung Kalixa
IPAddr
ans..15
M
IP-Adresse des Kunden
BrowserSessionID
ans..64
M
SessionID des Kunden
CreditCardHolder
ans..100
M
Name des Karteninhabers
CustomerID
an..20
M
Kundennummer: Nummer zur Identifizierung des Kunden
Name
ans..100
C
Benutzername des Kunden
FirstName
ans..100
C
Vorname des Kunden
LastName
ans..100
C
Nachname des Kunden
ans..64
C
E-Mail-Adresse des Kunden
Language
a2
C
Sprache des Kunden gemäß ISO, alphanumerisch 2-stellig
sdFirstName
ans..100
C
Vorname in der Lieferanschrift
sdLastName
ans..100
C
Nachname in der Lieferanschrift
sdStreet
ans..200
C
Straßenname der Lieferanschrift
sdStreetNr
ans..5
C
Hausnummer der Lieferanschrift
sdZIPCode
an..20
C
Postleitzahl der Lieferanschrift
sdCity
ans..40
C
Ort der Lieferanschrift
sdState
a2
C
Code des Bundeslandes der Lieferanschrift
sdCountryCode
a2
C
Ländercode der Lieferanschrift im Format ISO-3166-1, alphanumerisch 2-stellig
Weitere Adressparameter bei der Anbindung Vantiv
bdFirstName
ans..25
O
Vorname in der Rechnungsadresse
bdLastName
ans..25
O
Nachname in der Rechnungsadresse
bdStreet
ans..35
O
Straßenname in der Rechnungsadresse
Bitte beachten Sie, dass bdStreet und bdStreetNr zusammen maximal 34 Zeichen haben dürfen.
bdStreet und bdStreetNr werden mit einem Leerzeichen getrennt zusammengefügt und gemeinsam weitergeleitet. Der Gesamtinhalt wird nach 35 Zeichen abgeschnitten.
bdStreetNr
ans..35
O
Hausnummer in der Rechnungsadresse
Bitte beachten Sie, dass bdStreet und bdStreetNr zusammen maximal 34 Zeichen haben dürfen.
bdStreet und bdStreetNr werden mit einem Leerzeichen getrennt zusammengefügt und gemeinsam weitergeleitet. Der Gesamtinhalt wird nach 35 Zeichen abgeschnitten.
bdStreet2
ans..35
O
Adresszusatz in der Rechnungsadresse
bdZIPCode
ans..20
O
Postleitzahl in der Rechnungsadresse
bdCity
ans..35
O
Ort in der Rechnungsadresse
bdState
ans..30
O
Staat/Land in der Rechnungsadresse
bdCountryCode
a2
O
Ländercode der Rechnungsadresse im Format ISO-3166-1, alphanumerisch 2-stellig
bdMail
ans..100
O
E-Mail in der Rechnungsadresse
bdPhone
ans..20
O
Telefonnummer in der Rechnungsanschrift
Parameter für Gutschrift von Kreditkartenzahlungen ohne Bezug
Die folgende Tabelle beschreibt die Ergebnis-Parameter, die das Paygate als Antwort zurückgibt:
Multiexcerpt include | ||||||
---|---|---|---|---|---|---|
|
----
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)
AID
n6
OC
Nur bei Card Complete: von Card Complete zurückgegebene Autorisierungs-ID
RefNr
an..25
OC
Nur bei Card Complete: Falls eine RefNr übermittelt wurde, wird sie wieder zurückgegeben.
Amount
n..10
OC
Nur bei Clearhaus: Betrag in der kleinsten Währungseinheit (z.B. EUR Cent)
Sollte der tatsächliche Betrag vom angefragten Betrag abweichen, wird dieser zurückgegeben.
CodeExt
n5
OC
Nur bei Clearhaus: Nur wenn konfiguriert: externer Fehlercode (nachgelagertes System)
ErrorText
ans.128
OC
Nur bei Clearhaus: Detaillierte Clearhaus Fehlermeldung.
Wird nur bei Status=FAILED zurückgegeben. Nutzung nur in Abstimmung mit dem Computop Support möglich.
UserData
ans..1024
OC
Nur bei Clearhaus: Wenn beim Aufruf angegeben, übergibt das Paygate die Parameter mit dem Zahlungsergebnis an den Shop
TransactionID
ans36
OC
Nur bei Clearhaus: Transaktionsnummer von Clearhaus
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.
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:
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:
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
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:
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
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 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
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:
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.
Parameter für Kreditkartenzahlungen über stationäre Terminals
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
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:
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:
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. |
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:
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:
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>
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
Multiexcerpt include | ||||||
---|---|---|---|---|---|---|
|
Wenn Sie die Autorisierungsverlängerung nutzen, verlängert das
Multiexcerpt include | ||||||
---|---|---|---|---|---|---|
|
|
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 zur Stornierung einer Autorisierungsverlängerung
Multiexcerpt include | ||||||
---|---|---|---|---|---|---|
|
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, verwenden Sie bitte folgende URL:
|
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 | ||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||
|
Parameter zur Stornierung 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 3-D Secure-Verfahren
PayNow verbindet die Vorteile von
-Formularen und Server-zu-Server-Verbindungen: Im Unterschied zum Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Platform-Kurz PageWithExcerpt Wording
-Formular, wo durch den Aufruf von payssl.aspx das Formular vom Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Platform-Kurz PageWithExcerpt Wording
-Server geladen wird, muss bei PayNow das Formular vom Händlersystem bereitgestellt werden. Das Formular verwendet dieselben Parameter, wie hier nachfolgend beschrieben. Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Platform-Kurz PageWithExcerpt Wording
Im Unterschied zum
-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. Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Platform-Kurz PageWithExcerpt Wording
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. |
| PayNow | ||||||||
---|---|---|---|---|---|---|---|---|---|
payssl.aspx?MerchantID=[mid]&Len=[len]&Data=[data] |
|
Die Kreditkartendaten müssen mit folgenden Parametern an paynow.aspx übermittelt werden:
Table Filter | ||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||
|
PayNow-Parameter für 3-D Secure-Verfahren
Nachdem der Kunde seine Kreditkartendaten eingegeben hat, werden die Zahlungsdaten an die PayNow-Seite übertragen, wo die weitere Zahlungsabwicklung inkl. 3- D 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
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Batch_Intro PageWithExcerpt Reuse API
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: Bitte beachten Sie die Reservierungs- / Autorisierungsfristen Ihres Acquirers (siehe AGBs), damit Sie als Händler sicherstellen, dass die Abbuchungen in der korrekten Frist an unserem
eingereicht werden. Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Platform-Kurz PageWithExcerpt Wording
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:
Multiexcerpt include | ||||||
---|---|---|---|---|---|---|
|
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Batch_Request_Intro PageWithExcerpt Reuse API
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 | ||||||
---|---|---|---|---|---|---|
|
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Batch_Response_Intro PageWithExcerpt Reuse API
Table Filter | ||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||
|
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
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
Multiexcerpt include | ||||||
---|---|---|---|---|---|---|
|
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 weil das
Multiexcerpt include | ||||||
---|---|---|---|---|---|---|
|
Im Normalfall stoppt das Paygate
Multiexcerpt include | ||||||
---|---|---|---|---|---|---|
|
Multiexcerpt include | ||||||
---|---|---|---|---|---|---|
|
Multiexcerpt include | ||||||
---|---|---|---|---|---|---|
|
|
Da der Betrag von 5 Cent unter dem Mindestbetrag von 1,00 Euro liegt, lehnt das Paygate
Multiexcerpt include | ||||||
---|---|---|---|---|---|---|
|