Produktüberblick

Grundprinzip

Wenn der Endbetrag den Betrag der Vorab-Autorisierung übersteigt oder wahrscheinlich übersteigen wird (einschließlich aller Schemes, die eine prozentuale Abweichung erlaube), kann eine weitere inkrementelle Autorisierung erhalten werden. Die inkrementelle Autorisierung gilt für den Differenzbetrag zwischen der originalen Vorab-Autorisierung und dem tatsächlichen oder erwarteten Endbetrag. Die Summe aller verbundenen erwarteten und inkrementellen Autorisierungen stellt den reservierten Gesamtbetrag für eine gegebene Transaktion im Konto des Karteninhabers dar.

Durch Nutzung inkrementeller Autorisierungen können Händler sicherstellen, dass der gesamte offene Betrag des Karteninhabers die Transaktionsaktivität genau wiedergibt.


Schemes

Marke

Inkrementelle Autorisierung

VISA

Ja

MasterCardJa
AMEX (nur WorldPayCC)Ja

Acquirer

Marke

Inkrementelle Autorisierung

Elavon Europe

Ja

ConCardisJa
FiServAUJa
FiServEUJa
WorldPayCCJa


Gültigkeit der Autorisierung

Der Zeitrahmen für den 30-tägigen Rückbuchungsschutz berechnet sich ab dem Datum der letzten genehmigten Autorisierung. Daher kann eine inkrementelle Autorisierung eingereicht werden, um den Zeitruam des Rückbuchungsschutzes für dieselbe Transaktion zu verlängern. 


Nachrichtenfluss

Eine reguläre Sequenz für eine inkrementelle Autorisierung besteht aus drei Teilen:

  • Der originalen Vorab-Autorisierung selbst
  • Einer inkrementellen Transaktion mit einer Betragsaktualisierung, die dem Betrag der originalen Vorab-Autorisierung hinzugefügt wird
  • Zu einem späteren Zeitpunkt einer Buchung, die sich auf die inkrementelle Transaktion bezieht


Stornierungen

Wenn eine inkrementelle Autorisierung storniert wird, ist der stornierte Betrag lediglich der Betrag der Erhöhung. Eine Vorab-Autorisierung für den ursprünglichen Betrag besteht bei dem Host (sofern nicht abgelaufen). Beachten Sie bitte, dass es bisher nicht möglich ist, eine Vorab-Autorisierung und alle zugehörigen Erhöhungen in einer Nachricht zu stornieren. Jede Erhöhung muss einzeln storniert werden beginnend mit der letzten inkrementellen Transaktion, bevor die ursprüngliche Vorab-Autorisierung storniert werden kann.


Karten-Authentisierung und Karteninhaber-Verifizierung

Alle Vorab-Autorisierungen und inkrementellen Autorisierungen müssen online erfolgen und wenn es eine EMV-Transaktion ist, muss sie die vollständigen EMV-Daten für die Transaktion bereitstellen. Die inkrementelle Transaktion kann eine ‘Karte präsent’ oder eine ‘Karte nicht präsent’ Transaktion sein. Deshalb ist es möglich oder sogar wahrscheinlich, dass die anfängliche Vorab-Autorisierung eine EMV-Transaktion ist, aber nicht das Inkrement. Das ist zulässig, da angenommen werden kann, dass Karten-Authentisierung und Karteninhaber-Verifizierung in der anfänglichen Vorab-Autorisierung geprüft worden sind.


Nachrichten-Verknüpfung

Bei einer gegebenen Transaktion sind die ursprüngliche Autorisierungsanfrage, die inkrementellen Autorisierungsanfragen und die Stornoanfrage durch eindeutige Werte miteinander verknüpft, die als Nachverfolgungsdaten bezeichnet werden. Für Händler wird diese Verknüpfung im Paygate in Richtung des Acquirers automatisch durch die PayID realisiert.


Diagramm zum Prozessablauf


Prozessablauf Inkrementelle Autorisierung


Paygate-Schnittstelle

Definitionen

Datenformate:

FormatBeschreibung

a

alphabetisch

as

alphabetisch mit Sonderzeichen

n

numerisch

an

alphanumerisch

ans

alphanumerisch mit Sonderzeichen

ns

numerisch mit Sonderzeichen

bool

Bool’scher Ausdruck (true oder false)

3

feste Länge mit 3 Stellen/Zeichen

..3

variable Länge mit maximal 3 Stellen/Zeichen

enum

Aufzählung erlaubter Werte

dttm

ISODateTime (JJJJ-MM-TTThh:mm:ss)


Abkürzungen:

AbkürzungBeschreibungKommentar

CND

Bedingung (condition)


M

Pflicht (mandatory)

Wenn ein Parameter Pflicht ist, dann muss er vorhanden sein

O

optional

Wenn ein Parameter optional ist, dann kann er vorhanden sein, ist aber nicht erforderlich

C

bedingt (conditional)

Wenn ein Parameter bedingt ist, dann gibt es eine Bedingungsregel, die angibt, ob er Pflicht oder optional ist


Hinweis: Bitte beachten Sie, dass die Bezeichnungen der Parameter in Groß- oder Kleinbuchstaben zurückgegeben werden können.


Aufruf der Schnittstelle für inkrementelle Autorisierung

Um eine inkrementelle Autorisierung ü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:

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung

MerchantID

ans..30

M

MerchantID, assigned by Computop. Additionally this parameter has to be passed in plain language too.

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

KeyFormatCNDDescriptionBeschreibung
PayID

an32

M

ID assigned by Paygate for the payment, e.g. for referencing in batch files as well as for capture or credit request.

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

KeyFormatCNDDescriptionBeschreibung
TransID

ans..64

MTransactionID provided by you which should be unique for each paymentIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDDescriptionBeschreibung
Amount

n..10

M

Amount in the smallest currency unit (e.g. EUR Cent). Please contact the Computop Helpdesk, if you want to capture amounts <100 (smallest currency unit).

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

KeyFormatCNDDescriptionBeschreibung
Currency

a3

M

Currency, three digits DIN / ISO 4217, e.g. EUR, USD, GBP. Please find an overview here: A1 Currency table

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

KeyFormatCNDDescriptionBeschreibung

MAC

an64

M
Hash Message Authentication Code (HMAC) with SHA-256 algorithm. Details can be found here:
Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

Key

Format

CND

Description

Beschreibung
Durationn2C

Indicates the additional number of days to be added to the stay or rental. Valid only for merchants operating in specific industries like Hotel/Car rental.

Gibt die Anzahl zusätzlicher Tage an, die für den Aufenthalt oder die Miete hinzugefügt werden sollen. Nur für Händler in bestimmten Branchen wie Hotel/Autovermietung gültig.

Parameter für inkrementelle Autorisierung


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

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

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

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung

mid

ans..30

M

MerchantID, assigned by Computop

HändlerID, die von Computop vergeben wird

KeyFormatCNDDescriptionBeschreibung
PayID

an32

M

ID assigned by Paygate for the payment, e.g. for referencing in batch files as well as for capture or credit request.

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

KeyFormatCNDDescriptionBeschreibung
XID

an32

M

ID for all single transactions (authorisation, capture, credit note) for one payment assigned by Paygate

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

KeyFormatCNDDescriptionBeschreibung
TransID

ans..64

MTransactionID provided by you which should be unique for each paymentIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDDescriptionBeschreibung
Status

a..50

M

OK (URLSuccess) or FAILED (URLFailure)

OK (URLSuccess) oder FAILED (URLFailure)

KeyFormatCNDDescriptionBeschreibung
Description

ans..1024

M
Further details in the event that payment is rejected. Please do not use the Description but the Code parameter for the transaction status analysis!
Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description, sondern Code für die Auswertung des Transaktionsstatus!

KeyFormatCNDDescriptionBeschreibung
Code

n8

M

Error code according to Paygate Response Codes (A4 Error codes)

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

KeyFormatCNDDescriptionBeschreibung

MAC

an64

M
Hash Message Authentication Code (HMAC) with SHA-256 algorithm. Details can be found here:
Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

Key

Format

CND

Description

Beschreibung
additionalresponsedataan..128O

Additional text which the operator’s processing system can send optionally in replies to payment/cutover requests.

Zusätzlicher Text, den das Verarbeitungssystem des Betreibers optional als Antwort auf Zahlungs-/Umstellungsanforderungen senden kann.

Ergebnis-Parameter für inkrementelle Autorisierung