QENTA paymentsolutions Installationsleitfaden für QPAY Standard QPAY Premium Sicherer können Kreditkartenzahlungen nicht sein! QENTA paymentsolutions paymentsolutions Beratungs und Informations GmbH Primoschgasse 3, 9020 Klagenfurt Tel.: +43 / 316 / 81 36 81 0 Fax: +43 / 316 / 81 36 81 20 office@qenta.com http://www.qenta.com
SEHR GEEHRTER KUNDE! Dieses Dokument zeigt Ihnen Schritt für Schritt, wie Sie einfach und schnell Ihren Online-Shop an unser SET-Hosting-Service QPAY anbinden können. Alle weiterführenden Erläuterungen finden Sie in der QPAY Produktbeschreibung. Die Anbindung Ihres Online-Shops an QPAY vollzieht sich nun in sieben kleinen Schritten: 1.) REGISTRIERUNG: Sollten Sie unser Zahlungsservice in Anspruch nehmen, so bestellen Sie dieses doch einfach unter der Telefonnummer +43 (316) 81-36-81 oder über unsere Website http://www.qenta.com. 2.) ABSCHLUSS DES KREDITKARTENVERTRAGES: Der nächste Schritt ist der Abschluß eines Kreditkartenvertrages (inkl. Zusatzvertrag für SET-Transaktionen) mit Mastercard und/oder mit Visa in einem Land Ihrer Wahl. Dieser Abschluß ist für Sie kostenlos, sofern dieser Vertrag in Österreich abgeschlossen wird. In manchen anderen Ländern verrechnen Ihnen die Kreditkartengesellschaften derzeit noch eine geringe Bearbeitungsgebühr. Bei Bedarf kümmern wir uns gerne unentgeltlich um Ihren Vertragsabschluß. 3.) ANPASSUNG IHRES ONLINE-SHOPS: Das QPAY Payment Service wird via Hyperlink oder Formular aufgerufen. Dazu müssen lediglich einige zusätzliche Parameter übergeben werden, beispielsweise der Zahlungsbetrag, die Währung und die vom Online-Shop verwendete Sprache. Folgende Aktivitäten sind zu setzen: a) Fügen Sie auf der Checkout-Seite Ihres Online-Shops ein alle benötigten Parameter sowie die entsprechende Zahlungsoptionen ein, beispielsweise Sicheres Bezahlen mit Kreditkarte (ohne SET-Wallet) oder Sicheres Bezahlen mit Kreditkarte (mit SET-Wallet). Anhang A beschreibt die Bedeutung der einzelnen Parameter. b) Ebenfalls auf Ihrer Checkout-Seite anzuführen ist ein Hinweis auf das gesicherte, verschlüsselte Online-Zahlungssystem. Dies erfolgt durch Darstellung eines von QENTA bereitgestellten Logos im für den Konsumenten sichtbaren Bereich im proportionalen Mindestformat 110x30 Pixel. Aufgrund des positiven Images der SET-Technologie wird empfohlen, diesbezüglich ebenfalls einen entsprechenden Hinweis inklusive Logo anzubringen (siehe Beispiel in Anhang C). Dokument: Installationsleitfaden QPAY Version: 2.3 Datum: 7.12.2001 Seite 2 von 6
4.) ABSPEICHERN DER RÜCKGABEPARAMETER: Verwenden Sie QPAY, so müssen Sie jedenfalls eine Möglichkeit zur Abspeicherung der Rückgabeparameter einsetzen, damit Sie später auch jede einzelne Transaktion eindeutig identifizieren, abbuchen und nachvollziehen können. Bei QPAY-Donation bieten wir Ihnen die zusätzliche Möglichkeit (natürlich nur, sofern Sie dies auch benötigen), daß QENTA für Sie die Rückgabeparameter in einem paßwortgeschützten CSV-Datenfile (= Textfile, bei dem die einzelnen Datenfelder durch ein spezielles Zeichen getrennt werden) zusammen mit den Kundendaten abspeichert. 5.) FREISCHALTUNG SEITENS DER KREDITKARTENGESELLSCHAFT: Sobald Sie mit Mastercard und/oder Visa die entsprechenden Verträge unterzeichnet haben werden Sie dort als SET-Händler registriert. In Folge übermittelt Ihnen die Kreditkartengesellschaft ein gültiges Händlerzertifikat und eine Liste mit diversen Einstellungsparametern. Visa Austria übermittelt Ihnen zusätzlich noch einen sogenannten SET-Code, den Sie auf dem Postweg zugeschickt bekommen. All diese Daten müssen an QENTA übermittelt werden, da ohne diese Informationen keine Freischaltung des Zahlungsservices erfolgen kann. 6.) FREISCHALTUNG SEITENS QENTA PAYMENTSOLUTIONS: Unter Einbindung der Einstellungsparameter der Kreditkartengesellschaften erzeugt Ihnen QENTA einen Händlerschlüssel (merchantkey) zu Ihrer Identifikation am System, der in Folge an Sie weitergegeben wird. Sobald Sie diesen auf Ihrer Website eingefügt haben (siehe auch Musterbeispiel in Anhang C), ist die Implementierung unseres Zahlungsservices abgeschlossen. Nun können auch Sie mit sofortiger Wirkung Kreditkartenzahlungen via Internet online und in Echtzeit mit Hilfe hochsicherer, verschlüsselter Verfahren durchführen! 7.) NUTZUNG DES PAYMENT CENTERS (STANDARD EDITION): Sie erhalten Zugang zu einer speziellen Händleroberfläche, über die Einblick in sämtliche durchgeführte Transaktionen genommen werden kann und über die alle weiteren Zahlungsmodi (Abbuchen autorisierter Zahlungen, Erstellen von Gutschriften etc.) abgewickelt werden. Nähere Informationen entnehmen Sie bitte dem entsprechenden Benutzerhandbuch. WICHTIG: Bitte beachten Sie, dass QPAY die Aufträge Ihrer Kunden nur genehmigt. Diese Genehmigung verfällt bei MasterCard innerhalb von einer Woche, bei VISA nach 10 Tage. Abbuchen können Sie diese Genehmigungen im Payment Center. Dokument: Installationsleitfaden QPAY Version: 2.3 Datum: 7.12.2001 Seite 3 von 6
Wir wünschen Ihnen gutes Gelingen und hoffen, Sie als langfristigen und zufriedenen Kunden für uns gewinnen zu können. Für allfällige Fragen stehen wir Ihnen natürlich gerne jederzeit unter der Telefonnummer +43 (316) 81-36-81 oder via email unter merchant@qenta.com zur Verfügung. Dokument: Installationsleitfaden QPAY Version: 2.3 Datum: 7.12.2001 Seite 4 von 6
ANHANG A: VON IHRER CHECKOUT-SEITE ZU ÜBERGEBENDE PARAMETER Folgende Parameter müssen an die Seite https://www.qenta.com/qpay/checkin.php (via POST-Request) weitergeleitet werden. Parameter 1 Format zulässige Werte Beschreibung merchantkey individueller Key Spezieller, individueller Händlerschlüssel: wird von QENTA paymentsolutions zur Verfügung gestellt amount 10,00 oder 10.00 Zulässig sind alle Zahlen und die Zeichen, oder. für die Trennung zwischen Schilling und Groschen, etc. 978 2... für Euro... Zahlungsbetrag: Es werden nur die ersten beiden Nachkommastellen berücksichtigt. Die Verwendung z.b. von 10,-- ist NICHT zulässig. currency 3-stelliger ISO- Währungscode Gibt die Währung an, in der gecleart werden soll. Sollten Sie QPAY nicht für die von Ihnen festgelegte Währung bestellt haben, verursacht dies in Folge eine Fehlermeldung paymenttype yes no Wallet-Identifier: Legt fest, ob der Konsument ein SET-Wallet verwenden möchte ("yes") oder nicht ("no"). Sprache, in der alle Meldungen (inklusive Zwischenund Fehlermeldungen) ausgegeben werden. Weitere Sprachen werden auf Anfrage gerne integriert. language 2-stelliger Ländercode de en... successurl failureurl cancelurl serviceurl http://mein.shop.at/erfolgreich.cgi http://mein.shop.at/fehlerhaft.cgi http://mein.shop.at/abgebrochen.cgi http://mein.shop.at/kontaktinfo.html Auf diese Seite wird verwiesen, falls die Transaktion erfolgreich durchgeführt wurde. Der Konsument wird auf dieser Seite informiert, daß die Zahlung erfolgreich durchgeführt worden ist! Auf diese Seite wird verwiesen, falls die Transaktion fehlgeschlagen ist. Der Konsument wird auf dieser Seite informiert, daß die Zahlung fehlgeschlagen ist! Auf diese Seite wird verwiesen, falls die Transaktion vom Konsumenten abgebrochen wurde. Der Konsument wird auf dieser Seite informiert, daß die Zahlung erfolgreich abgebrochen worden ist! Diese Seite kann vom Konsumenten aus dem SET- Wallet heraus aufgerufen werden, um Kontaktinformationen zu Ihrem Online-Shop zu erhalten. imageurl (optional) Absoluter Link zu Ihrem Logo, das maximal 200 Pixel breit und maximal 50 Pixel hoch sein darf. Es darf sich dabei keinesfalls um ein SSL-verchlüsseltes Bild handeln, der URL muß also immer mit http:// beginnen, also z.b. http://mein.shop.at/firmenlogo.gif Verweis zu einem beliebigen Bild mit Ihrem Logo, welches auf den meisten Internetseiten des QPAY Zahlungssystems angezeigt wird. Dieser Parameter kann auch weggelassen werden. Etwaige andere Parameter (beispielsweise eine Session-ID), die zusätzlich übergeben werden, werden vom QENTA-Zahlungsservice unverändert retourniert. Sämtliche Parameter werden an Ihren Online-Shop genau an jene Internetseite zurückgegeben, die entsprechend des Zahlungsausganges anzusteuern ist, also entweder an die "successurl", an die "failureurl" oder an die "cancelurl". 1 Die Groß- und Kleinschreibung der Variablen ist strikt einzuhalten! Dokument: Installationsleitfaden QPAY Version: 2.3 Datum: 7.12.2001 Seite 5 von 6
ANHANG B: PARAMETER, DIE VOM QPAY PAYMENT SERVICE AN IHREN ONLINE-SHOP ZURÜCKGEGEBEN WERDEN Nach Abschluß des Zahlungsvorganges oder wenn der Konsument die Zahlung abbricht oder wenn die Zahlung aufgrund eines Fehlers nicht durchgeführt werden konnte, werden von QENTA unter anderem alle im Anhang A beschriebenen Parameter zurückgegeben. Dies sind somit: Parameter amount currency paymenttype language Beschreibung Zahlungsbetrag der übergeben wurde. Währungscode der übergeben wurde. Zahlungsart in der gecleart wurde. SET oder MOSET Sprache die übergeben wurde. Darüber hinaus werden auch folgende Parameter zurückgegeben: ordernumber Zahlungsnummer, die die Transaktion eindeutig identifiziert! Es ist essentiell, daß diese Ordernummer zusammen mit den dazugehörigen Bestelldaten abgespeichert wird, um eine eindeutige Zuordnung gewährleisten zu können (siehe Punkt 4, vorne). Zusätzliche Parameter Etwaige andere Parameter (beispielsweise eine Session-ID), die zusätzlich übergeben wurden, werden vom QENTA-Zahlungsservice unverändert retourniert. Dokument: Installationsleitfaden QPAY Version: 2.3 Datum: 7.12.2001 Seite 6 von 6
ANHANG C: MUSTERBEISPIEL EINER HTML-SEITE Dieser HTML-Code demonstriert den Aufruf des QPAY-Zahlungssystems und die Übergabe der nötigen Parameter. Die HTML-Seite, die im Parameter successurl angegeben ist, kann leider aufgrund der Unterschiedlichkeit der Shopsysteme nicht demonstriert werden. Unsere Entwicklungsabteilung hilft Ihnen aber gerne jederzeit weiter. <HTML> <BODY BGCOLOR="#ffffff"> <FORM ACTION="https://www.qenta.com/qpay/checkin.php" METHOD="POST"> <H2> Musterbeispiel für eine Integration von QPAY SET</H2> <BR> Ich melde mich hiermit zum Forum Alpbach an und leiste eine Anzahlung in der Höhe von 1500,-- Schilling <BR> <BR><BR> <INPUT TYPE=RADIO NAME="paymentType" VALUE="MOSET" checked> Sicheres Bezahlen mit Kreditkarte (ohne SET-Wallet) <BR><BR> <INPUT TYPE=RADIO NAME="paymentType" VALUE="SET"> Sicheres Bezahlen mit Kreditkarte (mit SET-Wallet) [Anmerkung: Hierfür muss ein <a href="http://www.europay.at/htdocs/set/masterwallet.htm" target="_blank">set-wallet</a> auf Ihrem Rechner installiert sein!] <BR> <BR><BR> <INPUT TYPE=HIDDEN NAME="language" VALUE="de"> <INPUT TYPE=HIDDEN NAME="orderDescription" VALUE="Anzahlung Forum Alpbach"> <INPUT TYPE=HIDDEN NAME="amount" VALUE="1500,00"> <INPUT TYPE=HIDDEN NAME="currency" VALUE="978"> <INPUT TYPE=HIDDEN NAME="merchantKey" VALUE=" [HIER MÜSSEN SIE IHREN MERCHANTKEY EINTRAGEN] "> <INPUT TYPE=HIDDEN NAME="successURL" VALUE="http://mein..shop.at/Erfolgreich.html"> <INPUT TYPE=HIDDEN NAME="failureURL" VALUE="http://mein.shop.at/Fehlerhaft.html"> <INPUT TYPE=HIDDEN NAME="cancelURL" VALUE="http://mein.shop.at/Abgebrochen.html"> <INPUT TYPE=HIDDEN NAME="serviceURL" VALUE="http://mein.shop.at/Kontaktinfos.html"> <INPUT TYPE=HIDDEN NAME="imageURL" VALUE="http://mein.shop.at/FirmenLogo.gif"> <INPUT TYPE=SUBMIT NAME="submit" <BR> <BR> <BR> VALUE="Zahlung durchführen"> <a href="http://www.qenta.at" target="_blank"> <img src="http://www.qenta.com/de/payment/img/logo_qenta_payment.gif" border="0" width="110" height="30" alt="ein Zahlungsmodul der QENTA paymentsolutions" ></a> <a href="http://www.setco.org" target="_blank"> <img src="http://www.qenta.at/de/payment/img/logo_set.gif" border="0" width="66" height="45" alt="set(tm),set Secure Electronic Transaction(tm), and the SET Logo are trademarks owned by SET Secure Electronic Transaction LLC."></a> </FORM> </BODY> </HTML> Dokument: Installationsleitfaden QPAY Version: 2.3 Datum: 7.12.2001 Seite 7 von 6