Über Hosted Payment Page
Allgemeines zur Hosted Payment Page
Die Hosted Payment Page ist ein Checkout, der nur den Schritt der Zahlarten-Auswahl enthält. Sie ist ein im responsiven Design gestaltetes HTML-Formular, welches auf allen Geräten korrekt dargestellt wird.
Bei Zahlungen über die Hosted Payment Page verbindet der Shop den Kunden mit dem HTML-Formular des
| Multiexcerpt include | ||||||
|---|---|---|---|---|---|---|
|
| Multiexcerpt include | ||||||
|---|---|---|---|---|---|---|
|
| Multiexcerpt include | ||||||
|---|---|---|---|---|---|---|
|
Folgende Tabelle enthält die Zahlarten, die Sie über die Hosted Payment Page nutzen können:
Zahlart | PayType |
|---|---|
Kreditkarte | CC |
Lastschrift | EDD |
PayPal | PayPal |
iDEAL | iDEAL |
Sofort | Sofort |
giropay | giropay |
paydirekt | paydirekt |
Alipay | Alipay |
Bancontact | BanconPP |
Bank Transfer | BankTranPP |
BitPay | BitPayPP |
Dragonpay | DragonPP |
eNETS | ENETSPP |
Finland Online Bank Transfer | FinOBTPP |
Indonesia ATM | IndoATMPP |
Multibanco | MultibanPP |
My Bank | MyBankPP |
MyClear FPX | MyClearPP |
Przelewy 24 | P24PP |
POLi | POLiPP |
PostFinance | POSTFINPP |
paysafecard | PSCPP |
QIWI | QIWIPP |
RHB Bank | RHBBankPP |
SafetyPay | SafetyPPP |
7-Eleven | SevenElePP |
Skrill | SkrillPP |
TrustPay | TrustPayPP |
| Apple Pay | ApplePay |
| B4Payment | B4Payment |
| Boleto | BoletoPP |
| CUP | CUPPP |
| EPS | EPS |
| WechatPP |
Folgende Tabelle enthält die Kartenmarken, die Sie über die Hosted Payment Page nutzen können. Bei Übergabe des Wertes CC im Parameter PayTypes werden alle für einen Händler konfigurierten Marken angezeigt. Die Auswahl bestimmter Marken ist durch die Übergabe einer Zeichenfolge der gewünschten Marken jeweils durch Pipe-Zeichen getrennt möglich.
Kreditkartenmarke, korrekte Schreibweise für CCBrand |
|---|
AirPlus |
AMEX |
ARGENCARD |
Aura |
Bancontact |
CABAL |
Cartes Bancaires |
Maestro |
CBN |
CENCOSUD |
ComfortCard |
CUP |
Dankort |
DINERS |
Discover |
Elo |
Hipercard |
JCB |
Laser |
Maestro |
MasterCard |
NARANJA |
RuPay |
SHOPPING |
TOTAL |
VISA |
Ablauf der Zahlung
Um Zahlungen über die Hosted Payment Page auszuführen, rufen Sie folgende URL mit HTTPS GET oder HTTPS POST auf:
|
Alle Daten, die für eine Zahlungsabwicklung notwendig sind, werden als Parameter übergeben. Damit weder der Kunde noch ein Dritter die Daten manipulieren kann, werden die Parameter mit Blowfish verschlüsselt.
Beim Aufruf des Formulars entschlüsselt das
| Multiexcerpt include | ||||||
|---|---|---|---|---|---|---|
|
Nach Durchführung der Zahlung leitet das
| Multiexcerpt include | ||||||
|---|---|---|---|---|---|---|
|
| Multiexcerpt include | ||||||
|---|---|---|---|---|---|---|
|
Aufruf der Hosted Payment Page
Der Aufruf der Hosted Payment Page beginnt mit der korrekten Zusammenstellung der Parameter, die aus einem Schlüssel und einem Wert bestehen und durch ein Gleichheitszeichen (=) getrennt sind:
MerchantID=Test |
Alle Parameter werden in einer Zeichenkette aneinandergereiht und durch das Zeichen & getrennt:
Amount=100&Currency=EUR&TransID=12345 |
Hinweis: Da die Zeichen "=" und "&" als Trennzeichen verwendet werden, können diese Zeichen nicht als Wert übergeben werden. Alle Werte, die Sie ohne Blowfish-Verschlüsselung übergeben, müssen URL-encoded sein.
Eine korrekte Parameter-Zeichenkette für das
| Multiexcerpt include | ||||||
|---|---|---|---|---|---|---|
|
MerchantID=Test&Len=67&Data=0A67FE96a65d384350F50FF1 |
Der Parameter Data enthält die sensiblen Zahlungsdaten wie Betrag und Währung. Die verschlüsselten Bytes sind Hex-codiert und auf zwei Zeichen von links mit einer Null aufgefüllt. Die Verschlüsselung erfolgt über Blowfish ECB und steht Ihnen als Source-Code und Komponente zur Verfügung.
Für die Entschlüsselung ist der Parameter Len sehr wichtig, der die Länge der unverschlüsselten(!) Zeichenkette im Parameter Data enthält. Da bei der Verschlüsselung mit Blowfish die zu verschlüsselnde Datenmenge auf ein Vielfaches von 8 vergrößert wird, muss bei der Entschlüsselung die korrekte Länge der Zeichenkette bekannt sein. Andernfalls tauchen am Ende der Zeichenkette zufällige Zeichen auf.
Die Übergabe der Parameter erfolgt per HTTPS POST oder HTTPS GET. Die empfohlene Übertragungsmethode ist HTTPS POST, weil die Parameterzeichenkette bei GET an die URL angehängt wird, die je nach Browser auf 2048 Bytes begrenzt ist.
Hinweis: Bitte beachten Sie, dass die maximale Länge einer Zahlungsanfrage auf 5120 Zeichen begrenzt ist. Wenn Sie längere Zeichenketten benötigen, melden Sie sich bitte beim Computop Support
| Multiexcerpt include | ||||||
|---|---|---|---|---|---|---|
|
Die folgenden Listings zeigen die Entwicklung eines Zahlungsaufrufs. Das erste Listing ist die unverschlüsselte Parameterzeichenkette:
MerchantID=Test&TransID=100000001&Amount=11&Currency=EUR&URLSuccess=https://www.shop.de/ok.html&URLFailure=https://www.shop.de/failed.html&URLNotify=https://www.shop.com/notify.cgi&OrderDesc=Mein Einkauf |
Hinweis: Bitte beachten Sie, dass jedem Parameter ein Wert zugewiesen wird. Leere Parameter dürfen nicht übergeben werden, da andernfalls die Zahlung scheitern kann.
Diese Zeichenkette wird verschlüsselt und als Parameter Data übergeben, so dass der HTTPS GET Aufruf der Hosted Payment Page so aussieht:
<a href=
|
Hinweis: Bitte beachten Sie, dass Parameter wie Language oder URLBack unverschlüsselt übergeben werden. Eine Tabelle mit allen möglichen unverschlüsselten Parametern finden Sie ebenfalls in diesem Dokument.
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Platform-Kurz PageWithExcerpt Wording
-Schnittstelle
| SpaceWithExcerpt | DE |
|---|---|
| MultiExcerptName | Platform-Kurz |
| PageWithExcerpt | Wording |
| Multiexcerpt include | ||||||
|---|---|---|---|---|---|---|
|
Parameter der Hosted Payment Page
Diese Parameter sind für alle Zahlarten Pflicht und müssen Blowfisch-verschlüsselt im Parameter Data an die Hosted Payment Page gesendet werden.
Hinweis: Alle weiteren, zahlartspezifischen Parameter entnehmen Sie bitte dem Handbuch der jeweiligen Zahlart.
Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:
Parameter | Format | CND | Beschreibung | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
MerchantID | ans..30 | M | HändlerID, die von | |||||||||
TransID | ans..64 | M | TransaktionsID, die für jede Zahlung eindeutig sein muss | |||||||||
RefNr | ns..30 | O | eindeutige Referenznummer | |||||||||
Amount | n..10 | M | Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den
| |||||||||
Currency | a3 | M | Währung, drei Zeichen DIN / ISO 4217 | |||||||||
OrderDesc | ans..384 | M | Beschreibung der gekauften Waren, Einzelpreise etc. Bitte beachten Sie: Die ersten 27 Zeichen erscheinen auf dem Kontoauszug des Kunden. In
| |||||||||
MAC | an64 | M | Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus | |||||||||
UserData | ans..1024 | O | Wenn beim Aufruf angegeben, übergibt das
| |||||||||
URLSuccess | ans..256 | M | Vollständige URL, die das
| |||||||||
URLFailure | ans..256 | M | Vollständige URL, die das
| |||||||||
Response | a7 | O | Die Status-Rückmeldung, die das
| |||||||||
URLNotify | ans..256 | M | Vollständige URL, die das
| |||||||||
Parameter für Hosted Payment Page
Folgende Parameter sind optional und können unverschlüsselt an die Hosted Payment Page übergeben werden:
Parameter | Format | CND | Beschreibung | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Template | ans..20 | O | Name der XSLT-Datei mit Ihrem individuellen Layout für die Hosted Payment Page. Wenn Sie keinen Wert übergeben wird das responsive
| ||||||||||||||||||||||||
CCTemplate | CCTemplate | ans..20 | O | Name der XSLT-Datei mit Ihrem individuellen Layout für das Kreditkartenformular. Dies greift nur, wenn der Kunde eine Kreditkartenmarke auswählt und auf die Schaltfläche „Weiter“ klickt. Wenn Sie keinen Wert übergeben, wird das responsive
| |||||||||||||||||||||||
SDDTemplate | ans..20 | O | Name der XSLT-Datei mit Ihrem individuellen Layout für das Lastschriftenformular. Dies greift nur, wenn der Kunde Lastschrift als Zahlart auswählt und auf die Schaltfläche „Weiter“ klickt. Wenn Sie keinen Wert übergeben, wird das responsive
| ||||||||||||||||||||||||
Language | a2 (enum) | O | Sprachcode: <de> deutsch, <al> albanisch, <at> österreichisch, <cz/cs> tsche-chisch, <dk> dänisch, <en> englisch, <fi> finnisch, <fr> französisch, <gr> grie-chisch, <hu> ungarisch, <it> italienisch, <jp> japanisch, <nl> holländisch, <no> norwegisch, <pl> polnisch, <pt> portugiesisch, <ro> rumänisch, <ru> russisch, <es> spanisch, <se> schwedisch, <sk> slowakisch, <sl> slowenisch, <tr> tür-kisch, <zh> Simplified Chinese Ohne Angabe ist die Sprache Deutsch. | ||||||||||||||||||||||||
|
|
|
| ||||||||||||||||||||||||
PayTypes | ans..256 | O | Mit diesem Parameter können Sie die anzuzeigenden Zahlarten übersteuern, d.h. sie können in diesem Parameter Pipe-getrennt entscheiden, welche der zur Verfügung stehenden Zahlarten angezeigt werden. De möglichen Werte entnehmen Sie aus der Spalte PayType in der obigen Tabelle der Zahlarten. Beispiel: …&PayTypes=CC|EDD|Alipay |
Optionale Parameter für Hosted Payment Page
Corporate PaymentPage: XSLT-Layout für Formulare
Sie können mit dem Parameter Template ein individuelles Layout für das Formular der Hosted Payment Page nutzen, das 100%ig zu Ihrem Shop-Layout passt. Zu diesem Zweck entwirft Ihr Grafiker ein HTML-Template im Shop-Design auf Basis der XSLT-Technologie (Extensible Stylesheet Language Transformation). Der Computop Support Der
| Multiexcerpt include | ||||||
|---|---|---|---|---|---|---|
|
| Multiexcerpt include | ||||||
|---|---|---|---|---|---|---|
|
| Multiexcerpt include | ||||||
|---|---|---|---|---|---|---|
|
Die XSLT-Templates für das Formular der Hosted Payment Page haben gleich mehrere Vorteile:
- Sie können die aufwendige PCI-Sicherheitszertifizierung umgehen
- Die Hosted Payment Page ist responsiv, d.h. sie funktioniert auf Smartphones, Tablets oder auf dem Laptop
Allgemeine Informationen zu XSLT finden Sie unter www.w3.org.
Für die Nutzung der Corporate Paypage mit XSLT gelten die nachfolgenden Konventionen:
Dateinamen
Eine von Ihnen gestaltete XSL-Datei definiert Ihr individuelles Layout. Die zugehörige XML-Datei enthält die Texte, die auf dem Formular angezeigt werden sollen. So lässt sich problemlos eine Mehrsprachigkeit realisieren. In den Bezeichnungen der Dateien verwenden Sie stets Ihre MerchantID.
XSL-Template: MerchantID_PaymentPage.xsl
XML-Textdatei: MerchantID_PaymentPage.xml
Unterordner für Bilder, CSS- und JS-Dateien: Templates/imagesMerchantID_PaymentPage
Um keine Sicherheitshinweise zu erhalten, stellen Sie bitte bei externen Bildquellen sicher, dass diese über SSL aufgerufen werden.
Zum Aufruf des individuellen Layouts verwenden Sie den Parameter „Template“ mit Ihrer MerchantID und hängen ihn unverschlüsselt an den Aufruf des Formulars der Hosted Payment Page an, zum Beispiel:
| Multiexcerpt include | ||||||
|---|---|---|---|---|---|---|
|
Hidden Fields
Folgende Hidden Fields müssen implementiert werden, damit die Werte beim Abschicken des Formulars weitergereicht werden können:
MerchantID: „MerchantID“
Request-Länge: „Len“
Request-Daten: „Data“
Template: „Template“
Sprache: „Language“
Zurück-Button-URL: „URLBack“
Zahlart: „PaymentMethod“
Kreditkartenmarke: „CreditCardBrand“
Sprachauswahl
Die Sprachauswahl auf dem Formular der Hosted Payment Page erfolgt automatisch anhand des Parameters Language. Die anderen Sprachbereiche werden herausgefiltert. Wenn Sie z.B. mit JavaScript auf das Feld eines anderen Sprachbereichs zugreifen wollen, ist das über den folgenden Pfad möglich: paygate/language/@name.
XML-Struktur
Mit dem Parameter „Language“ wird gesteuert, welcher Abschnitt der XML-Textdatei ausgelesen wird. Standardmäßig wird immer deutsch „de“ verwendet.
Die XML-Datei sollte folgendes Grundgerüst haben:
<?xml version="1.0" encoding="utf-16"?> </languages> <language name="de"> <title>Zahlung</title> ... </language> <language name="en"> <title<Payment</title> ... </language> </languages> |
Die Codierung ist auch „UTF-8“ möglich.
Mit <xsl:variable name=““ select=“paygate/language/@name“/> können Sie direkt von der XSL-Datei einen XML-Sprachenabschnitt ansprechen.
Zum Überblick, welche Parameter zusätzlich von der Hosted Payment Page gerendert werden, sehen Sie sich bitte folgende Struktur an (XSL-Datei wird gegen folgenden XML-String gerendert):
strXML = "<?xml version='1.0' encoding='windows-1252'?>" & _ <paygate> <merchantID>...</merchantID> <len>257</len> <data>E98D4...F7065</data> <template> <urlBack><![CDATA[http://www.google.de]]></urlBack> <paymentMethods> <VISA type="CC" displayName="Visa"/> <MasterCard type="CC" displayName="MasterCard"/> <AMEX type="CC" displayName="American Express"/> <DINERS type="CC" displayName="Diners Club International"/> <Discover type="CC" displayName="Discover"/> <JCB type="CC" displayName="JCB"/> <EDD lowercase="edd"> <PayPal lowercase=="paypal"> <iDEAL lowercase=="ideal"> </paymentMethods> <language name="de"> <title>Zahlung</title> ... </language> </paygate> |
Auf jeden einzelnen Wert dieser XML-Struktur, welche im Backend aus der XML-Sprachdatei und zusätzlichen Werten gerendert wird, können Sie in Ihrer XSL-Datei zugreifen.
JavaScript
Sie können individuelle JavaScript-Methoden entweder direkt im HEAD-Bereich Ihrer XSL-Datei oder in der main.js-Datei welche Sie in Ihrem Images-Ordner unter Templates/imagesMerchantID_PaymentPage/js finden.
Hinweis: Bitte verwenden Sie keine externen Links auf Ihr JavaScript!