Computop Paygate bietet Marktplätzen die Möglichkeit, im Namen ihrer Kunden Split-Payments zu erstellen.Diese Funktion verbessert das Einkaufserlebnis des Benutzers erheblich, da mehrere Zahlungen für mehrere Subhändlerkonten über ein einziges Einkaufserlebnis des Kunden abgewickelt werden können.
Split Payments können ganz einfach über vorhandene Paygate API-Schnittstellen ausgelöst werden, indem der Zahlungsanforderung über das zusätzliche JSON-Objekt splitPayment Informationen für das Split Payment hinzugefügt werden.
Split Payments werden derzeit nur für Kartenzahlungen unterstützt.
Dieses Dokument beschreibt die Split-Payment-Funktionalität für Kartenzahlungen über gehostete Kartenformulare.
Bei der Anforderung einer geteilten Zahlung über von Computop gehostete Formulare wird die Komplexität der Erstellung mehrerer separater Zahlungsanforderungen und der Handhabung von 3-D Secure aus der Händlerimplementierung vollständig entfernt.
Aus Sicht des Händlers unterscheidet sich der Ablauf selbst nicht vom standardmäßigen Weiterleitungs-Einzelzahlungsablauf.
Hinweis zum Cookie-/Session-Handling
Bitte beachten Sie, dass einige Browser möglicherweise erforderliche Cookies blockieren, wenn Sie zu Ihrem Shop zurückkehren. Hier finden Sie weitere Informationen und verschiedene Lösungsansätze.
Vereinfachtes Diagramm zum Prozessablauf
Zahlungsanfrage
Um ein Computop-Kartfenformular abzurufen, senden Sie bitte die folgenden Datenelemente per HTTP-POST-Anforderung anComputoppayssl.aspx.
| Key | Format | CND | Description | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
ans..30 | M | HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben. | |||||||||
ans..64 | M | Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss | |||||||||
MsgVer | ans..5 | M | Message-Version. Zulässiger Wert:
| ||||||||
RefNr | ans..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. | ||||||||
Amount | n..10 | M | Betrag in der kleinsten Währungseinheit der gewählten Währung (z.B. EUR Cent) | ||||||||
a3 | M | Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle | |||||||||
an..6 | OM | Bestimmt Art und Zeitpunkt der Buchung (engl. Capture).
| |||||||||
JSON | M | Objekt, das angibt, wie die Zahlung zwischen den untergeordneten Händler-IDs aufgeteilt wird. | |||||||||
a3 | O | Indikator für Anforderung einer Kontoverifizierung (alias Nullwert-Authorisierung). Bei einer angeforderten Kontoverifizierung ist der übermittelte Betrag optional und wird für die tatsächliche Zahlungstransaktion ignoriert (z.B. Autorisierung). Zulässiger Wert:
| |||||||||
JSON | O | Objekt, das Authentisierungs-Richtlinien und Vorgaben für die Ausnahmenbehandlung festlegt | |||||||||
JSON | O | Das Objekt Prior Transaction Authentication Information enthält optionale Informationen über eine Authentisierung eines 3DS-Karteninhabers, die vor der aktuellen Transaktion erfolgt ist | |||||||||
JSON | O | Das Objekt Kontoinformationen enthält optionale Informationen über das Kundenkonto beim Händler | |||||||||
JSON | C | Der Kunde, dem die Waren und / oder Dienstleistungen in Rechnung gestellt werden. Für EMV 3DS erforderlich, sofern nicht Markt- oder Regionalmandate die Übermittlung dieser Informationen beschränken. | |||||||||
JSON | C | Der Kunde, an den die Waren und / oder Dienstleistungen gesendet werden. Erforderlich, falls von billToCustomer abweichend. | |||||||||
JSON | C | Rechnungsadresse. For EMV 3DS erforderlich (falls verfügbar), sofern nicht Markt- oder Regionalmandate die Übermittlung dieser Informationen beschränken. | |||||||||
JSON | C | Lieferadresse. Falls von billingAddress abweichend; für EMV 3DS erforderlich (falls verfügbar), sofern nicht Markt- oder Regionalmandate die Übermittlung dieser Informationen beschränken. | |||||||||
JSON | C | Objekt, das Art und Reihe von Transaktionen mittels Zahlungskonto-Zugangsdaten festlegt (z.B. Kontonummer oder Zahlungs-Token), die bei einem Händler für die Verarbeitung zukünftiger Einkäufe für einen Kunden gespeichert sind. Erforderlich, falls zutreffend. | |||||||||
JSON | O | Der Händler-Risikoindikator enthält optionale Informationen über den bestimmten Einkauf des Kunden. Falls shippingAddress nicht vorhanden ist, ist es dringend empfohlen, das Merkmal shippingAddressIndicator mit einem entsprechenden Wert wie shipToBillingAddress , digitalGoods oder noShipment auszufüllen. | |||||||||
ans..256 | M | Vollständige URL, die das Paygate aufruft, wenn die Zahlung erfolgreich war. Die URL darf nur über Port 443 aufgerufen werden. Diese URL darf keine Parameter enthalten: Um Parameter durchzureichen, nutzen Sie stattdessen den Parameter UserData. Allgemeine Hinweise:
| |||||||||
ans..256 | M | Vollständige URL, die das Paygate aufruft, wenn die Zahlung gescheitert ist. Die URL darf nur über Port 443 aufgerufen werden. Diese URL darf keine Parameter enthalten: Um Parameter durchzureichen, nutzen Sie stattdessen den Parameter UserData. Allgemeine Hinweise:
| |||||||||
a7 | O | Die Status-Rückmeldung, die das Paygate an URLSuccess und URLFailure sendet, sollte verschlüsselt werden. Dazu übergeben Sie den Parameter Response=encrypt. | |||||||||
ans..256 | M | Vollständige URL, die das Paygate aufruft, um den Shop zu benachrichtigen. Die URL darf nur über Port 443 aufgerufen werden. Diese URL darf keine Parameter enthalten: Um Parameter durchzureichen, nutzen Sie stattdessen den Parameter UserData. Allgemeine Hinweise:
| |||||||||
ans..1024 | O | Wenn beim Aufruf angegeben, übergibt das Paygate die Parameter mit dem Zahlungsergebnis an den Shop. | |||||||||
an64 | M | Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier: |
Computop Paygate gibt im Antworttext ein HTML-Dokument zurück, das das angeforderte Kartenformular darstellt. Das Formular kann in die Checkout-Seite des Händlers integriert oder als eigenständige Seite verwendet werden, auf die der Karteninhaber weitergeleitet wird.
Die Authentifizierung des Karteninhabers und die Zahlungsautorisierung erfolgen, sobald der Karteninhaber alle erforderlichen Kartendetails eingegeben und die Formulardaten an Computop Paygate übermittelt hat.
Hinweis: Falls Sie Ihre eigenen Vorlagen verwenden (Corporate Payment Page), achten Sie darauf, dass Sie den Namen des Karteninhabers in Ihre benutzerdefinierte Vorlage aufnehmen. Der Name des Karteninhabers wird dem Paygate API-Parameter „CreditCardHolder“ zugeordnet. Das Feld „Cardholder name“ darf keine Sonderzeichen enthalten und muss mindestens 2 und höchstens 45 Zeichen lang sein.
Wenn die Zahlung abgeschlossen ist, sendet das Computop Paygate eine Benachrichtigung an den Händlerserver (z.B. URLNotify) und leitet den Browser zur URLSuccess beziehungsweise zur URLFailure weiter.
Die in der folgenden Tabelle aufgeführten Blowfish-verschlüsselten Datenelemente werden per HTTP POST Anfrage an URLNotify und URLSuccess/URLFailure übertragen.
Hinweis: Bitte beachten Sie, dass der Aufruf von URLSuccess bzw. URLFailure beim Fallback auf 3-D Secure 1.0 mit einem GET erfolgt. Ihre Systeme sollten daher in der Lage sein, Parameter sowohl per GET als auch per POST entgegenzunehmen.
HTTP POST to URLSuccess / URLFailure / URLNotify
| Key | Format | CND | Description |
|---|---|---|---|
ans..30 | M | HändlerID, die von Computop vergeben wird | |
MsgVer | ans..5 | M | Message-Version. Zulässiger Wert:
|
an32 | M | Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request. | |
an32 | M | Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden | |
ans..64 | M | Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss | |
Status | a..20 | M | Status der Transaktion. Zulässige Werte:
|
ans..1024 | M | Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description, sondernCode für die Auswertung des Transaktionsstatus! | |
n8 | M | Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes) | |
JSON | M | Detaillierte Informationen zu geteilten Zahlungen. Dieses Feld ist nur in der Benachrichtigung (URLNotify) vorhanden, nicht in der Weiterleitung (URLSuccess / URLFailure). | |
card | JSON | C | Objekt der Kartendaten |
ipinfo | JSON | C | Objekt mit IP-Informationen. Das Vorhandensein hängt von der Konfiguration des Händlers ab. |
ipinfo | JSON | C | Objekt mit IP-Informationen. Das Vorhandensein hängt von der Konfiguration des Händlers ab. |
threeDSData | JSON | C | Objekt der Authentisierungsdaten |
resultsResponse | JSON | C | Falls der Authentisierungsprozess eine Aufforderung für den Karteninhaber enthalten hat, werden zusätzliche Informationen über das Ergebnis der Aufforderung bereitgestellt |
ans..1024 | O | Wenn beim Aufruf angegeben, übergibt das Paygate die Parameter mit dem Zahlungsergebnis an den Shop. | |
an64 | M | Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier: |