Überblick
Eine Stille Auftragserteilung oder Direkte Erteilung ist eine Übertragungsmethode, bei der Formulardaten von einer Händler-Webseite direkt an einen Server eines Dritten abgeschickt werden. Das wird üblicherweise durch das Attribut form action erreicht, welches die URL angibt, wohin die Daten zu senden sind.
Sensible Daten wie Kartendetails können innerhalb der Händler-Webseite erfasst werden, ohne dass diese vom Server des Händlers verarbeitet werden, da der POST still übermittelt wird. Die URL im Computop Paygate für den Empfang von Anfragen der Stillen Auftragserteilung wird als PayNow bezeichnet.
<form action="../payNow.aspx" method="post">
Dieser Ansatz ist sehr ähnlich zu den bei Computop gehosteteten Zahlungsformularen und lässt dem Händler die volle Kontrolle über den Bezahlvorgang, da alle Elemente der Webseite vom Server des Händlers bereitgestellt werden.
PCI-DSS Betrachtungen
Händler, die Kartentransaktionen mit dem Modell der Stillen Erteilung verarbeiten, müssen den Fragebogen PCI DSS Self-Assessment Questionnaire (SAQ) A-EP einreichen. Dieser SAQ ist umfangreicher und kann daher mehr Zeit und Ressourcen erfordern als der SAQ A für Händler, die gehostete Zahlungsseiten verwenden. Händler sollten sich jedoch immer mit ihrem Acquirer beraten, um das Maß der erforderlichen Compliance zu beurteilen und dabei die PCI DSS Richtlinien beachten. Das wirkt sich nicht auf die Verwendung von Pseudokartennummern aus, was ohne Einreichung des SAQ-Fragebogens möglich ist.
Hinweis zum Cookie-/Session Handling
Bitte beachten Sie, dass einige Browser beim Rücksprung zu Ihrem Shop erforderliche Cookies blockieren könnten. Hier finden Sie weitere Informationen und verschiedene Lösungsansätze.
Sequenzdiagramm
Zahlungsanfrage
Bitte übermitteln Sie die Formulardaten per POST wie in der nachstehenden Tabelle dargestellt an https://www.computop-paygate.com/payNow.aspx
Formularelemente
Data Element | Legacy Element | Beschreibung |
MerchantID | -- | HändlerID, die von Computop vergeben wird |
Len | -- | Die Länge des Originals verschlüsselt mit Blowfish |
Data | -- | Per Blowfish verschlüsselte Daten |
number | CCNr | Kartennummer |
securityCode | CCCVC | Kartenprüfnummer |
expiryDate | CCExpiry | Kartenablaufdatum im Format JJJJMM |
brand | CCBrand | Kartensystem |
cardholder | CreditCardHolder | Name des Karteninhabers, wie er auf der Karte gedruckt ist. Hinweis: Alphanumerische Sonderzeichen gemäß EMV Book 4, „Anhang B“. Sonderzeichen wurden mit EMV 3DS Version 2.3 hinzugefügt, aber nicht alle Teilnehmer (Banken) unterstützen diesen Standard bereits. |
(- Computop wird weiterhin die alten Formulardatenfelder unterstützen, die derzeit verwendet werden. -)
Daten
| 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ässige Werte:
| ||||||||
RefNr | 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. Informationen zum unterstützten Format finden Sie weiter unten in der zahlartspezifischen Beschreibung. Es sind ausschließlich ASCII-Zeichen erlaubt. Sonderzeichen wie ("Umlaute", ...) sind nicht erlaubt und müssen ggf. durch ASCII-Zeichen ersetzt werden (z.B. ü → ue, é → e, ...). | |||||||||
n..10 | M | 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. | |||||||||
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).
| |||||||||
ans..22 | O | Ein auf dem Kontoauszug des Karteninhabers zu druckender Beschreiber. Beachten Sie bitte auch die andernorts gemachten zusätzlichen Hinweise für weitere Informationen über Regeln und Vorschriften. | |||||||||
OrderDesc | ans..768 | O | Beschreibung der Bestellung | ||||||||
a3 | O | Indikator zur Anforderung einer Konto-Verifizierung (alias Nullwert-Autorisierung). Wenn eine Konto-Verifizierung angefordert wird, ist der übermittelte Betrag optional und wird für die tatsächliche Zahlungstransaktion (d.h. Autorisierung) ignoriert. Zulässige Werte:
| |||||||||
JSON | O | Objekt, dass die Authentisierungs-Richtlinien und Strategien zur Behandlung von Ausnahmen angibt | |||||||||
JSON | O | Das Objekt Prior Transaction Authentication Information enthält optionale Informationen über eine 3DS-Authentisierung eines Karteninhabers, die vor der aktuellen Transaktion erfolgt ist. | |||||||||
JSON | M | Exakte Browserinformationen sind nötig, um eine optimierte Nutzererfahrung zu liefern. Erforderlich für 3DS 2.0 Transaktionen. | |||||||||
JSON | O | Die Kontoinformationen enthalten optionale Informationen über das Kundenkonto beim Händler. | |||||||||
JSON | C | Der Kunde, dem die Waren und / oder Dienstleistungen in Rechnung gestellt werden. Erforderlich, sofern nicht Markt- oder regionale Mandate das Senden 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. Erforderlich (falls verfügbar), sofern nicht Markt- oder regionale Mandate das Senden dieser Informationen beschränken. | |||||||||
JSON | C | Lieferadresse. Falls abweichend von billingAddress, erforderlich (falls verfügbar), sofern nicht Markt- oder regionale Mandate das Senden dieser Informationen beschränken. | |||||||||
JSON | C | Objekt, dass Art und Reihe der Transaktionen angibt, die unter Verwendung von beim Händler hinterlegten Zahlungsdaten (z.B. Kontonummer oder Zahlungs-Token) zur Verarbeitung künftiger Käufe eines Kunden erfolgen. Erforderlich, falls zutreffend. | |||||||||
JSON | O | Der Händler-Risikoindikator enthält optionale Informationen über den bestimmten Einkauf des Kunden. Falls keine shippingAddress vorhanden ist, ist es dringend empfohlen, die Eigenschaft 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:
| |||||||||
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:
| |||||||||
an64 | M | Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier: | |||||||||
ans..1024 | O | Wenn beim Aufruf angegeben, übergibt das Paygate die Parameter mit dem Zahlungsergebnis an den Shop. |
Beispiel HTML-Formular
BASEURL= https://www.computop-paygate.com/schemas
1<!DOCTYPE html>2<html>3 <head>4 <title>Merchant Checkout</title>5 </head>6 <body>7 <form name="card form" action="BASEURLpayNow.aspx" method="post">8 <input type="hidden" name="MerchantID" value="MerchantID">9 <input type="hidden" name="Len" value="Length of the Blowfish encrypted data">10 <input type="hidden" name="Data" value="Blowfish encrypted data">11 Cardholder:12 <input type="text" name="cardholder"><br> 13 Card number:14 <input type="text" name="number"><br>15 Expiry date:16 <input type="text" name="expiryDate"><br>17 CVV2:18 <input type="text" name="securityCode"><br>19 Card brand:20 <input type="text" name="brand"><br>21 <input type="submit" value="Submit">22 </form>23 </body>24</html>Wenn die Zahlung abgeschlossen ist, sendet das Computop Paygate eine Benachrichtigung an den Händler-Server (d.h. URLNotify) und leitet den Browser dementsprechend an URLSuccess oder URLFailure weiter.
Die in der folgenden Tabelle genannten per Blowfish evrschlüsselten Datenelemente werden per HTTP POST Anfragemethode an URLNotify und URLSuccess/URLFailure übertragen.
Hinweis: 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.
HTTP POST an URLSuccess / URLFailure / URLNotify
| Key | Format | CND | Description | ||||
|---|---|---|---|---|---|---|---|
ans..30 | M | HändlerID, die von Computop vergeben wird | |||||
ans..5 | M | Computop Paygate Message-Version. Zulässige Werte:
| |||||
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 | |||||
ans..64 | C | Spezifische Transaktions-ID des Kartenschemas, die für nachfolgende Zahlungen mit gespeicherten Zugangsdaten, verzögerte Autorisierungen und Wiedereinreichungen erforderlich ist. Pflicht: CredentialOnFile – initial false – unschedule MIT / recurring schemeReferenceID wird bei 3DS2-Zahlungsvorgängen zurückgegeben. Bei einem Fallback auf 3DS1 prüfen Sie bitte zusätzlich auf TransactionId. Die SchemeReferenceID ist eine eindeutige Kennung, die von den Kartenmarken generiert wird. In der Regel können Computop-Händler die SchemeReferenceIDs für Abonnements übergreifend verwenden, welche unter Verwendung eines anderen PSP / separater Paygate-MerchantID / separater Acquirer ContractID / Acquirer erstellt wurden. | |||||
RefNr | O | Referenznummer vom Request | |||||
Status | a..20 | M | Status der Transaktion. Zulässige Werte:
Im Falle von nur Authentisierung ist der Status entweder OK oder FAILED. | ||||
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! | |||||
an8 | M | Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes) | |||||
JSON | M | Kartenantwortdaten | |||||
JSON | C | Objekt mit IP-Informationen. Das Vorhandensein hängt von der Konfiguration des Händlers ab. | |||||
JSON | M | Authentisierungsdaten | |||||
JSON | C | Falls der Authentisierungsprozess eine Challenge des Karteninhabers enthalten hat, werden zusätzliche Informationen über das Ergebnis der Challenge bereitgestellt | |||||
JSON | O | Optionale Daten des Acquirers/Issuers/externen Dienstleisters für eine Autorisierung | |||||
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: |