Titelseite. payplace.express Anbindung für Händler und Integratoren - Formularservice

Transkript

1 Titelseite payplace.express Anbindung für Händler und Integratoren - Formularservice

2 Anbindung für Händler und Integratoren - Formularservice Dieses Dokument bezieht sich auf payplace.express, Version 1.2. Revision: Ausgabedatum: Cartes Bancaires -Dokumentation in separates Dokument ausgelagert. Veraltete Texte zur SEPA-Umstellung entfernt. Abschnitt Pseudokartennummern, S. 16: Aussage zu Pseudokartennummer und PCI DSS überarbeitet. Revision: Ausgabedatum: Abschnitt Cartes Bancaires ergänzt. Revision: Ausgabedatum: Abschnitt Anfragenachricht - Zahlungen, S. 18: für Feld amount präzisiert, backendretrycount und notifyurl hinzugefügt. Revision: Ausgabedatum: Abschnitt SEPA-Lastschriften, S. 12: internationale Lastschriften sind im gesamten SEPA-Raum erlaubt. Revision: 3.5 Ausgabedatum: Abschnitt SEPA-Lastschriften, S. 12: Hinweise auf SEPA-Basislastschriften, internationale Lastschriften und zur End-To-End-ID bei Rücklastschriften ergänzt. Kapitel Formularservice / 3D-Secure, S. 14 beschreibt Version 1.8 des Formularservice. Abschnitt Anfragenachricht - Zahlungen, S. 18 und Abschnitt HMAC - Keyed-Hashing for Message Authentication, S. 77: Parameter für SEPA-PDF-Mandat und SEPA-Basislastschriften ergänzt. Zahlungsmitteldaten werden bei Formularservice- Zahlungen in der Shopbenachrichtigung zurückgeben: zusätzliche Parameter ergänzt in Abschnitt Benachrichtigung des Shops, S. 38 und Abschnitt HMAC - Keyed-Hashing for Message Authentication, S. 77. Abschnitt Anpassung der Formulare, S. 48: CSS angepasst. Revision: Ausgabedatum: Abschnitt Anfragenachricht - Zahlungen, S. 18: für mandatename korrigiert (keine Umlaute, usw. erlaubt). Revision: Ausgabedatum: Abschnitt Voraussetzungen für die Anbindung, S. 10: Text zu Lastschriften in den Abschnitt SEPA-Lastschriften, S. 12 ausgegliedert. Dort Angaben zu Mandatsänderungen ergänzt. Abschnitt Anfragenachricht - Zahlungen, S. 18: Parameter für Mandatsänderungen ergänzt.

3 Inhaltsverzeichnis 1 Zu diesem Dokument 1.1 Kennzeichnungen und Visualisierung Haftungsausschluss Copyright-Hinweis Einleitung 2.1 Produkt Zielgruppe, Aufgabe des Dokuments Inhaltsübersicht Übersicht 3.1 System- und Schnittstellenübersicht D-Secure Voraussetzungen für die Anbindung Ablauf der Anbindung Support-Kontakt SEPA-Lastschriften Formularservice / 3D-Secure 4.1 Voraussetzungen Funktionsbeschreibung Kreditkartenzahlungen mit 3D-Secure Zahlungen ohne 3D-Secure Maestro-Zahlungen Pseudokartennummern Zugangsdaten Transaktionsarten Reservieren Reservieren/Buchen Version Ausgabedatum:

4 4.6 Transaktionsdetails Anfragenachricht - Zahlungen Anfragenachricht - Pseudokartennummer registrieren Benachrichtigung des Shops Anpassung der Formulare Konfiguration Ihres Zugangs Kartenprüfnummer Warenkorbnummer FAQ Anhang 5.1 Testdaten Testdaten für Zahlungstransaktionen Ergebnismeldungen / Antwort-Nachrichten payplace.express Meldungen Meldungen des VÖB-ZVD-Gateways Formatbeschreibung der Parameter MAC - Message Authentication Code HMAC - Keyed-Hashing for Message Authentication e Codebeispiele Glossar Version Ausgabedatum:

5 1.1 Kennzeichnungen und Visualisierung 1 Zu diesem Dokument 1.1 Kennzeichnungen und Visualisierung Beachten Sie die folgenden Kennzeichnungen im Text: Programmlistings, Quelltext Hier stehen Auszüge aus dem Programmquelltext oder Listings. : Listing 1-1 #!/bin/bash # endless loop while[true] do clear; free; sleep 1; done Parameter Die Bezeichnungen sämtlicher Parameter erscheinen in folgender Schrift: parameter. Hinweis Hinweis Ein kontextbezogener Hinweis oder weiterführende Informationen. Wichtig Wichtig Ein besonders wichtiger Hinweis. Vorsicht Achtung Ein Hinweis auf einen Sachverhalt, der Vorsicht und Aufmerksamkeit erfordert. Aufzählung 1. Ab hier folgen einzeln nummerierte Schritte. 2. Diese werden nacheinander ausgeführt. Hervorhebungen Aus inhaltlichen Gründen hervorzuhebende Wörter und wesentliche Informationen erscheinen kursiv gedruckt. Version Ausgabedatum:

6 1.2 Haftungsausschluss 1.2 Haftungsausschluss Die Informationen in dieser Dokumentation sind mit größter Sorgfalt zusammengestellt worden. Die Dokumentation erhebt jedoch weder Anspruch auf Vollständigkeit noch Fehlerfreiheit. Es kann deshalb keine Haftung für die Verwendbarkeit und Richtigkeit übernommen werden. Für direkte, indirekte, zufällige oder Folgeschäden, die aus der Anwendung der Informationen entstehen können, übernimmt die VÖB-ZVD Processing - soweit gesetzlich zulässig - keine Haftung. 1.3 Copyright-Hinweis Dieses Dokument ist urheberrechtlich geschützt. Kein Teil des Dokuments darf ohne vorherige schriftliche Genehmigung der VÖB-ZVD Processing vervielfältigt oder unter Verwendung elektronischer Systeme verarbeitet oder verbreitet werden. Alle Rechte vorbehalten Version Ausgabedatum:

7 2.1 Produkt 2 Einleitung 2.1 Produkt payplace.express ist ein Managementsystem zur Weiterverarbeitung, Genehmigung und Verwaltung der bei einem Online-Händler eingehenden Kreditkartenund Lastschriftzahlungen. Die am System angeschlossenen Online-Händler und Operatoren erhalten einen eigenen, benutzerspezifischen und vollständig webbasierten Zugriff. Damit können die jeweils relevanten Verwaltungs-, Statistik- und Monitoring- Funktionen genutzt werden. Der Account eines Händlers ist multi-user-fähig. Der Händler kann mehrere Nutzer seines Accounts einrichten lassen. Online-Händler haben über payplace.express differenzierten Zugriff auf die Abwicklung einzelner Transaktionen und differenzierte, minutenaktuelle Umsatzstatistiken. Die Funktion Sammelverarbeitung fasst Transaktionen zusammen und bearbeitet diese en bloc. Die Importfunktion ermöglicht die automatische Generierung mehrerer Zahlungen. Alle Transaktionen können mittels Datenexport archiviert werden. Auf Wunsch können die von Ihnen eingereichten Transaktionen auch tageweise als Export-Datei bereitgestellt werden. Dies ist ein zusätzlicher Dienst, der bei B+S beantragt werden kann. Der webbasierte Zugriff des Online-Händlers ist nicht Teil dieser Anbindungs- Dokumentation. Näheres dazu finden Sie im payplace.express-anwenderhandbuch. Für die Zahlungsabwicklung stehen folgende Modi zur Verfügung: manuell (via Webbrowser) Formularservice / 3D-Secure Bei allen Transaktionen und beim Datenexport werden sämtliche Transaktionsdaten per SSL verschlüsselt übertragen. 2.2 Zielgruppe, Aufgabe des Dokuments Dieses Dokument wendet sich an Online-Händler und Integratoren von payplace.express. Sie sollten über progammiertechnisches Basiswissen, grundlegende Kenntnisse zu HTML und zum elektronischen Zahlungsverkehr verfügen. Version Ausgabedatum:

8 2.3 Inhaltsübersicht Diese Dokumentation beschreibt die Schnittstellen von payplace.express und unterstützt Sie bei der Anbindung Ihres Shops bzw. Ihrer Anwendung. 2.3 Inhaltsübersicht Die Dokumentation beginnt mit einer Übersicht über payplace.express. In dieser Übersicht finden Sie auch Angaben über Voraussetzungen der Anbindung, Angaben zum Support und Hinweise zur Auswahl der geeigneten Schnittstelle für die Integration Ihrer Anwendung. Es folgt eine detaillierte Beschreibung der Anbindung. Im anschließenden Anhang finden Sie Testdaten und eine Beschreibung der Antwort-Codes des Systems. Den Schluss der Dokumentation bildet das Glossar. Version Ausgabedatum:

9 3.1 System- und Schnittstellenübersicht 3 Übersicht 3.1 System- und Schnittstellenübersicht Das folgende Diagramm gibt den prinzipiellen Aufbau wieder. Abbildung 3-1: Übersicht zum Gesamtsystem Zum System gehören: Sie als Online-Händler mit Ihrem Shop/Ihrer Anwendung und einem Zugang zu payplace.express über Webbrowser Ihre Kunden das payplace.express-system, das aus mehreren Komponenten besteht Version Ausgabedatum:

10 3.2 Voraussetzungen für die Anbindung sowie die Systeme von Kreditkartenorganisationen Banken für die Abwicklung von Zahlungstransaktionen. Über Webbrowser können Sie auf payplace.express zugreifen, um Ihre Transaktionen zu kontrollieren, nachzubearbeiten und Statistiken zu erstellen. Außerdem können Sie Transaktionen per Datei-Import in das System einspielen. Diese Funktionalität ist im payplace.express-anwenderhandbuch beschrieben. Die Zahlungstransaktionen Ihres Shops werden von payplace.express auf ihre Plausibilität geprüft. Zur Abwicklung der Zahlungen werden die Transaktionen vom payplace.express Payment-Gateway an die Systeme der Kreditkartenorganisationen und Banken weitergeleitet. Bei Kreditkartentransaktionen erfolgt die Antwort in wenigen Sekunden. Sie wird von payplace.express gespeichert, bearbeitet und sofort an Ihren Shop weitergegeben D-Secure Für die sichere Abwicklung von Kreditkarten-Zahlungen wurde die Credit Card Security Cartridge (CCS) in payplace.express integriert. Die CCS entspricht der von Visa entwickelten 3D-Secure Spezifikation, MPI Distributed Processing. Bei strittigen Transaktionen garantiert 3D-Secure dem Online-Händler in der Regel die Haftungsumkehr (Liability Shift) zu seinen Gunsten. Hinweis Detaillierte Angaben zur Haftungsumkehr erhalten Sie von Ihrem Kreditkarten-Acquirer. Die CCS wurde von Visa zertifiziert. Zahlungen nach dem 3D-Secure-Protokoll werden von Visa unter dem Namen Verified by Visa und von MasterCard als MasterCard SecureCode unterstützt. Zahlungen nach dem 3D-Secure-Protokoll können Sie mit dem payplace.express-formularservice durchführen (s. Kapitel Formularservice / 3D-Secure, S. 14). 3.2 Voraussetzungen für die Anbindung Für die Abrechnung von Kreditkartenzahlungen benötigen Sie einen Kreditkartenakzeptanzvertrag. Außerdem sollten Sie über ein Konto mit der Möglichkeit des Lastschrifteinzuges bei Ihrer Hausbank verfügen. Für 3D-Secure-Zahlungen müssen Sie als Online-Händler zusätzlich für Verified by Visa oder MasterCard SecureCode registriert und freigeschaltet sein. Bitte kontaktieren Sie dazu Ihren Kreditkarten-Acquirer. Wenn Sie Standardsoftware für Ihren Shop oder Ihre Anwendung verwenden, fragen Sie unseren Kunden-Support, ob Ihre Software bereits von Version Ausgabedatum:

11 3.3 Ablauf der Anbindung payplace.express unterstützt wird. In diesem Fall ist nur ein geringer Integrationsaufwand notwendig. Für die Anbindung von nicht Standard-Shops benötigen Sie grundlegende Programmierkenntnisse und Kenntnisse der Funktionsweise Ihres Shops bzw. Ihrer Anwendung. Technische Voraussetzung für die Anbindung ist die Möglichkeit, Skripte ausführen zu können bzw. per HTTPS-Request übergebene Daten verarbeiten zu können. Ein reiner HTML-Shop ist daher nicht für die Anbindung geeignet. Die genauen Anforderungen der gewählten Schnittstelle finden Sie im Kapitel Formularservice / 3D-Secure, S Ablauf der Anbindung 1. Vertragliche Vereinbarung Grundlage für die Nutzung von payplace.express ist eine vertragliche Vereinbarung zwischen Ihnen als Händler und dem Lizenznehmer. 2. Testumgebung und Anbindungs-Dokumentation Eine Testumgebung wird für Sie frei geschaltet. Anhand dieser Dokumentation machen Sie sich mit der Integration von payplace.express vertraut. 3. Anbindung Sie können die Anbindung mit geringem Aufwand selbst vornehmen. Hierbei erhalten Sie telefonisch und/oder per Support (s. Abschnitt Support-Kontakt, S. 12). 4. Tests Um die Funktionsfähigkeit der Anbindung sicherzustellen, führen Sie in der Testumgebung simulierte Zahlungen durch. 5. Freischaltung Der zuständige Lizenznehmer richtet einen personalisierten Händlerzugang für Sie ein. Spätestens jetzt müssen Sie dem Lizenznehmer die Vertragspartnernummer(n) zur Abwicklung von Kreditkarten-Transaktionen und eine Bankverbindung für die Abwicklung von Lastschriften mitteilen. Zur Nutzung Ihres Händler-Zugangs erhalten Sie per Ihre Zugangsdaten (Login und Passwort). 6. Konfiguration Mit diesen Zugangsdaten konfigurieren Sie Ihr System für den Wirkbetrieb. 7. Betrieb Das Zahlungssystem steht jetzt für Sie und Ihre Kunden bereit. Version Ausgabedatum:

12 3.4 Support-Kontakt 3.4 Support-Kontakt Bitte erfragen Sie den Support-Kontakt beim jeweiligen Lizenznehmer/Institut. 3.5 SEPA-Lastschriften Standardmäßig werden SEPA-Lastschriften über payplace.express nach dem Standard SDD COR1 abgewickelt. Die SDD COR1 Lastschriften werden so eingereicht, dass ihr Fälligkeitsdatum drei TARGET2-Geschäftstage (nicht an Wochenenden und an den sog. TARGET2- oder TARGET-Feiertagen) nach dem Datum der Generierung der Buchung bzw. Reservierung/Buchung in payplace.express liegt. Für SDD COR1 Lastschriften akzeptiert payplace.express derzeit deutsche und österreichische Bankverbindungen. Wahlweise können Sie auch SEPA-Basislastschriften nach dem Standard SDD Core durchführen. Dazu geben Sie beim Erfassen der Zahlung den Parameter debitmode=sepacore an. Mit SEPA-Basislastschriften können Sie auf Wunsch internationale Lastschriften im SEPA-Raum durchführen. Die Nutzung internationaler Lastschriften können Sie im Frontoffice in der Stammdatenansicht des Shops freischalten. Hinweis Bei SEPA-Basislastschriften geben Sie selbst ein Fälligkeitsdatum an. Hinsichtlich der Benachrichtigung (Pre-Notification) des Kunden und der Mandatserteilung durch den Kunden gelten die Anforderungen aus den SEPA-Regularien, die durch den Shop-Betreiber beachtet werden müssen. Zur Abwicklung von SEPA-Lastschriften sind Angaben zu Ihren Stammdaten erforderlich (Gläubiger-ID, IBAN, BIC, usw.), die Sie im Frontoffice vornehmen können. Wenn Ihnen ein Kunde ein SEPA-Mandat für wiederkehrende Lastschriften erteilt hat, kann es zu Änderungen gegenüber dem ursprünglichen Mandat kommen, die Sie bei der nächsten Zahlung berücksichtigen müssen, damit die Zahlung nicht wegen ungültiger Mandatsangaben abgewiesen wird. Gehen Sie in diesen Fällen wie folgt vor: Ändert sich Ihre Gläubiger-ID, so tragen Sie Ihre neue Gläubiger-ID im Frontoffice ein. Geben Sie für alle betroffenenen Mandate bei der ersten wiederkehrenden Zahlung nach der Änderung die vorherige Gläubiger-ID in den Transaktionsdaten im Feld creditorid_obsolete an. Bei einer Änderung der Mandatsreferenznummer geben Sie den aktuellen Wert im Feld mandateid an und zusätzlich den vorherigen Wert im Feld mandateid_obsolete. Bei einer Änderung der IBAN des Kunden geben Sie im Formularservice den vorherigen Wert im Feld iban_obsolete an und lassen den Kunden die neue IBAN im Formular eintragen. Im Fall einer Rücklastschrift können Sie diese anhand der SEPA-End-To-End-ID der entsprechenden Transaktion in payplace.express zuordnen. Die End-To-End- ID besteht aus den letzten sechs Zeichen der Transaktionsnummer des Backend- Systems (retrefnr), gefolgt von einem Punkt und der Vorgangsnummer (orde- Version Ausgabedatum:

13 3.5 SEPA-Lastschriften rid). Dabei werden ggf. in der Vorgangsnummer enthaltene Unterstriche, die für die End-To-End-ID nicht erlaubt sind, aus der Vorgangsnummer entfernt. Version Ausgabedatum:

14 4.1 Voraussetzungen 4 Formularservice / 3D-Secure Mit dem Formularservice bietet payplace.express Ihrem Shop die Möglichkeit, ohne eigenes SSL-Zertifikat Ihren Kunden die verschlüsselte Übertragung der Zahlungsdaten anzubieten. Die Abwicklung der Zahlung erfolgt von der Eingabe der Zahlungsdaten bis hin zur Anzeige des Ergebnisses einer Zahlung komplett in payplace.express. Kunde und Onlineshop werden über das Ergebnis einer Zahlung informiert. Sie haben die Wahl zwischen Formularen für Standard-Webbrowser und einer Variante für das Apple iphone und andere Smartphones mit WebKit basiertem Browser. Abbildung 4-1: Formularservice auf dem Apple iphone 4.1 Voraussetzungen Anforderungen an den Shopkunden Für Zahlungen ohne 3D-Secure genügt eine gültige Kreditkarte oder Bankverbindung. Für 3D-Secure-Zahlungen müssen Inhaber einer Kreditkarte bei ihrer Bank für Verified by Visa oder MasterCard SecureCode registriert und freigeschaltet sein. Version Ausgabedatum:

15 4.2 Funktionsbeschreibung Im Browser des Kunden muss die JavaScript-Unterstützung aktiviert sein. Java- Script wird für Weiterleitung des Kunden zwischen Shop, CCS und Access Control Server (ACS) benötigt. 4.2 Funktionsbeschreibung Kreditkartenzahlungen mit 3D-Secure Der Datentransfer einer erfolgreichen Transaktion gestaltet sich beispielhaft wie folgt: 7 5 Customer Browser Shop Access Control Server (ACS) 6 VISA Directory 4 Credit Card Security Cartridge (CCS) Payment Backend 8 Abbildung 4-2: hafte 3D-Secure-Transaktion 1. Der Shopkunde hat im Online-Shop den Warenkorb gefüllt, geht zur Kasse und wählt die Zahlungsart "Verified by Visa" oder "MasterCard Secure- Code". 2. Der Shop leitet den Browser des Shopkunden über einen Redirect zur CCS, die dem Kunden das Formular zur Eingabe der Kreditkartendaten anzeigt. 3. Der Shopkunde gibt seine Kreditkartendaten in das Formular ein und sendet sie ab. Falls der Kunde auf "Abbrechen" klickt, entfallen die folgenden Schritte, und der Shop wird mit einer Fehlermeldung benachrichtigt. 4. Die CCS ermittelt den für die Kreditkartennummer gültigen Access Control Server (ACS). 5. Die CCS leitet den Browser des Shopkunden an den betreffenden ACS weiter. 6. Der Shopkunde autorisiert die Zahlung beim ACS in einem Popup-Fenster (Eingabe eines Passworts, einer PIN oder einer TAN). 7. Der ACS signiert die Zahlungsautorisierung, die CCS speichert die signierte Zahlungsautorisierung. 8. Die CCS leitet den Paymentrequest an das payplace.express Payment- Backend weiter und benachrichtigt den Shop über das Transaktionsergebnis. Version Ausgabedatum:

16 4.3 Pseudokartennummern Zahlungen ohne 3D-Secure Für Lastschriften und Kreditkartenzahlungen ohne 3D-Secure gilt ein vereinfachter Transaktionsablauf bestehend aus den Schritten 1 bis 3 und 8 des im vorigen Abschnitt beschriebenen Ablaufs bei 3D-Secure-Zahlungen Maestro-Zahlungen Maestro-Zahlungen können Sie ebenfalls mit Hilfe des Formularservice verarbeiten. Maestro-Zahlungen werden immer gemäß dem 3D-Secure-Protokoll durchgeführt. Hinweis Für Maestro ist ein separater Vertrag mit B+S Card Service erforderlich. 4.3 Pseudokartennummern Pseudokartennummern stellen eine Möglichkeit dar, wiederkehrende Zahlungen mit einer Kreditkarte durchführen zu können, ohne die Kreditkartendaten in Ihrem System zu speichern. Wenn Sie die erste Transaktion mit einer Kreditkarte bzw. das Anlegen der Pseudokartennummer zu einer Kreditkarte mit dem Formularservice vornehmen, müssen Sie auf diese Weise nicht am "Payment Card Industry Data Security Standard" (PCI DSS) Programm von Visa und MasterCard teilnehmen. Ihr Zugang muss für die Nutzung von Pseudokartennummern entsprechend konfiguriert sein. Pseudokartennummern können Sie auch zu einer Bankverbindung anlegen. Auch dafür muss Ihr Zugang entsprechend konfiguriert sein. Wenn Ihr Zugang für die Nutzung von Pseudokartennummern für Kreditkarten oder Bankverbindungen konfiguriert ist, können Sie durch Angabe des Parameters payment_options=generate_ppan payplace.express mitteilen, dass Sie eine Pseudokartennummer für die Kreditkarte bzw. Bankverbindung des Kunden anlegen wollen. In der Shopbenachrichtigung erhalten Sie dann eine von payplace.express generierte Pseudokartennummer. Sie können im Feld ppan auch selbst eine Pseudokartennummer angeben. Mit der Pseudokartennummer können Sie weitere Transaktionen mit dieser Kreditkarte bzw. Bankverbindung im Formularservice oder im Frontoffice durchführen. Als Alternative können Sie mit dem Formularservice Pseudokartennummern auch unabhängig von einer Zahlung registrieren. Dazu können Sie entweder wie im Abschnitt Anfragenachricht - Pseudokartennummer registrieren, S. 34 beschrieben vorgehen. In diesem Fall wird die Pseudokartennummer lediglich registriert. Es erfolgt keine Online-Prüfung der Kreditkarte bzw. Bankverbindung. Der Transaktionsablauf entspricht in diesem Fall dem für Zahlungen ohne 3D-Secure. Statt dessen können Sie zur Registrierung der Pseudokartennummer auch einen kleinen Betrag (höchstens 1 EUR bzw. höchstens 1 einer anderen Währung) reservieren (s. Abschnitt Anfragenachricht - Zahlungen, S. 18) und durch Angabe des Parameters payment_options=generate_ppan_verify_online payplace.express mitteilen, dass es sich um eine Registrierung handelt. Version Ausgabedatum:

17 4.4 Zugangsdaten payplace.express zeigt dann das Formular zur Eingabe der Kreditkarten- bzw. Kontodaten mit den zu einer Registrierung passenden Texten an. payplace.express gewährleistet eine eindeutige Zuordnung einer Pseudokartennummer zu einer Kreditkarte bzw. Bankverbindung. Eine bereits vergebene Pseudokartennummer darf nicht noch einmal für eine andere Kreditkarte bzw. Bankverbindung verwendet werden. Umgekehrt dürfen für eine Kreditkarte bzw. Bankverbindung nicht mehrere Pseudokartennummern vergeben werden. Pseudokartennummern für Kreditkarten werden zwölf Monate nach Ablauf der Karte automatisch im System gelöscht. 4.4 Zugangsdaten Test- und Produktivsystem stehen Ihnen unter folgenden URLs zur Verfügung: Testzugang: Produktivzugang: Senden Sie Anfragen an payplace.express nur mit den im folgenden Abschnitt beschriebenen CGI-Parametern! 4.5 Transaktionsarten Über den Parameter transactiontype können Sie eine der beiden folgenden Transaktionsarten auswählen Reservieren Führen Sie eine Reservierung durch, wenn die Erfüllung eines Auftrages zu einem späteren Zeitpunkt erfolgt, zum Zeitpunkt der Bestellung aber der Bestellwert für die vom Kunden vorgelegte Karte genehmigt werden soll bzw. die angegebene Bankverbindung geprüft werden soll. Die Reservierungsfrist beträgt ca. sieben Tage bei Kreditkarten und 30 Tage bei Lastschriften. Die Reservierungsfrist für Kreditkartenzahlungen ist in Ihrem Akzeptanzvertrag geregelt. Bitte kontaktieren Sie Ihren Acquirer, falls Unklarheiten hinsichtlich der Reservierungsfrist für Kreditkartenzahlungen bestehen. Nach Ablauf der Reservierungsfrist ist das Buchen dieser Transaktion nicht mehr möglich. payplace.express ermöglicht Ihnen auch, bei der Reservierung zu bestimmen, ob und wann das System die Reservierung automatisch buchen soll. Version Ausgabedatum:

18 4.6 Transaktionsdetails Lastschrift Es wird geprüft, ob die angegebene Bankleitzahl existiert und ob die angegebene Kontonummer für das Prüfziffernverfahren dieser Bank gültig ist. Bei Angabe einer IBAN wird diese entsprechend geprüft. Kreditkarte Es wird geprüft, ob eine vorgelegte Karte existiert, gesperrt ist und mit einem bestimmten Betrag belastet werden kann. Diese Anfrage kann abgelehnt oder durch die Erteilung einer Genehmigungsnummer bejaht werden. Im Falle der Genehmigung wird vom Kreditlimit der vorgelegten Karte der angefragte Betrag reserviert Reservieren/Buchen Reservierung und Buchung erfolgt in einem Zug, es ist keine separate Buchungsnachricht erforderlich, um die Buchung auszulösen. Verwenden Sie die Transaktionsart Reservieren/Buchen, wenn der Geschäftsvorgang abgeschlossen ist, also z. B. ein Warenkorb angeboten, bestellt und an den Kunden ausgeliefert wurde. 4.6 Transaktionsdetails In den folgenden Abschnitten finden Sie Details zur Initialisierung einer Zahlung und zur Benachrichtigung des Shops durch payplace.express Anfragenachricht - Zahlungen Die in den folgenden Tabellen aufgeführten Parameter werden über den Browser des Kunden durch ein Redirect an den payplace.express-server übermittelt. Der Shop reagiert also auf eine Aktion des Browsers mit einer Antwort, die den Kunden an den payplace.express-server weiterleitet. Dies kann durch einen HTTP-Redirect-Header, eine HTML-Seite mit einem entsprechenden Meta-Tag oder per JavaScript-Formular erfolgen. Ein für die Realisierung mittels Meta-Tag finden Sie im Abschnitt, S. 34. en zu den in den folgenden Tabellen angegebenen en der Parameter finden Sie im Abschnitt Formatbeschreibung der Parameter, S. 76. Näheres zum Parameter mac finden Sie im Anhang im Abschnitt MAC - Message Authentication Code, S. 76. Zur Verwendung der Warenkorbnummer (Parameter basketid) lesen Sie bitte auch Abschnitt Warenkorbnummer, S. 61. Die optionalen Parameter acceptcountries, deliverycountry und rejectcountries erfordern die Überprüfung des Ausgabelandes einer Kreditkarte. Diese Überprüfung kann derzeit für Visa und MasterCard durchgeführt werden. Wenn ein Kunde mit einer anderen Kreditkarte bezahlt, findet keine Überprüfung des Version Ausgabedatum:

19 4.6 Transaktionsdetails Ausgabelandes statt, und die Zahlung kann nicht aufgrund des Ausgabelandes der Karte zurückgewiesen werden. Wird eine Kreditkarte aufgrund Ihres Ausgabelandes abgewiesen, wird dem Kunden das Formular zur Eingabe der Kreditkartendaten noch einmal mit einer Fehlermeldung angezeigt. Sie können den Text dieser Fehlermeldung entweder selbst in der Anfragenachricht übergeben (s. Abschnitt Parameterübersicht Anfragenachricht, S. 19) oder von payplace.express die Standard-Fehlermeldung für diesen Fehler anzeigen lassen. Für Lastschriftzahlungen werden die optionalen Parameter customer_... für das Erzeugen eines SEPA-PDF-Mandats verwendet, wenn payment_options den Wert sepa_pdf_mandate enthält. Die übergebenen Werte werden dem Kunden in den Eingabefeldern des Formularservice-Dialogs angezeigt und können vom Kunden geändert werden. Wenn diese Parameter nicht übergeben werden, sind die entsprechenden Eingabefelder leer und müssen vom Kunden ausgefüllt werden. Für Kreditkartenzahlungen dienen die optionalen Parameter customer_addr_... der Adressverifizierung durch American Express. Die Parameter sind nur relevant, wenn die Zahlung mit einer American Express Kreditkarte erfolgt. Andernfalls werden diese Parameter bei der Verarbeitung der Zahlung ignoriert. Die Adressverifizierung hat keinen Einfluss auf das Ergebnis der Zahlung. Das Ergebnis der Adressverifizierung wird im Parameter rc_avsamex und zusätzlich als Ampelwert im Parameter rc_score zurückgegeben. Es kann vorkommen, dass payplace.express auf Grund von Verbindungsproblemen keine Antwort vom Directory Server erhält. Aufgrund der unterschiedlichen Regelungen von Visa und MasterCard geht payplace.express in diesem Fall wie folgt vor: Bei einer MasterCard wird die Transaktion fortgeführt. Bei einer Visa Karte wird die Transaktion abgebrochen, es sei denn, Sie haben in der Anfragenachricht den Parameter payment_options=sslifnotenrolled übermittelt. In diesem Fall wird die Transaktion als SSL-Transaktion ohne Haftungsumkehr durchgeführt. Die Transaktion wird - sowohl für Visa als auch für MasterCard - ebenfalls abgebrochen, wenn payplace.express vom Directory Server die Antwort erhält, dass nicht festgestellt werden konnte, ob die Karte für 3D-Secure freigeschaltet ist. Wenn Sie den Parameter payment_options=sslifnotenrolled in der Anfragenachricht mitgeben, wird die Transaktion auch in diesem Fall als SSL-Transaktion ohne Haftungsumkehr durchgeführt Parameterübersicht Anfragenachricht Die folgenden Tabellen geben eine Übersicht der Pflicht- und optionalen Parameter der Anfragenachricht. Zu jedem Parameter finden Sie Einträge zum erlaubten, ein und eine. Die enthält immer auch die Angabe, ob es sich um einen Pflicht- oder einen optionalen Parameter handelt. Version Ausgabedatum:

20 4.6 Transaktionsdetails Hinweis Wenn Sie den optionalen Parameter transactiontype (s. unten) nicht angeben, wird eine Reservierung durchgeführt. Beachten Sie, dass Sie in diesem Fall die Zahlung in einem zweiten Schritt buchen müssen, um den Zahlungsbetrag zu erhalten und für diese zweite Teiltransaktion zusätzliche Kosten anfallen. acceptcountries A[,]-255 AT,DE,CH Optional; Liste der erlaubten Ausgabeländer bei Kreditkartenzahlung. Zweibuchstabige, durch Komma voneinander getrennte Länderkürzel nach dem aktuell gültigen Standard ISO 3166 (s. /02iso-3166-code-lists/list-en1.html). Tabelle 4-1: Parameter acceptcountries additionalnote ANLS-25 Überschreibt die Händlerbezeichnung auf der Kreditkartenabrechnung des Kunden. Kann z.b. verwendet werden, wenn ein Händler unter mehreren Namen Waren anbietet, um dem Kunden die Zuordnung der Zahlung zu einem Einkauf zu erleichtern. Kann nur bei entsprechender Konfiguration Ihres Zugangs verwendet werden. Tabelle 4-2: Parameter additionalnote amount N[,]-10 22,60 Pflichtfeld. Betrag. Cent-Beträge werden mit Dezimalkomma abgetrennt. "Glatte" Beträge können ohne Dezimalkomma und ohne Nachkommastellen angegeben werden, z.b. 22 für 22,00 EUR. Beträge in Währungen wie JPY, die keine kleinere Währungseinheit haben, müssen ohne Dezimalkomma und ohne Nachkommastellen angegeben werden. Tabelle 4-3: Parameter amount autocapture N-3 72 Optional; nur bei Reservierung: Zeitraum - in Stunden - zwischen Reservierung und automatischer Buchung. Ohne diesen Parameter erfolgt keine automatische Buchung. Erlaubt sind Werte von Stunden für Kreditkartenzahlungen und von Stunden für Lastschriften. Tabelle 4-4: Parameter autocapture Version Ausgabedatum:

21 4.6 Transaktionsdetails Achtung Sollte die Buchung in seltenen Fällen nicht erfolgreich sein (z.b. weil der Acquirer nicht erreichbar war), so wird kein automatischer zweiter Versuch gestartet. In diesem Fall erfolgt eine separate Rückmeldung an die im Frontoffice konfigurierte technische -Adresse des Shops, damit Sie fehlerhafte Buchungen gegebenenfalls manuell nachholen können. Falls für Ihren Shop keine technische -Adresse konfiguriert ist, empfehlen wir, die betroffenen Reservierungen in regelmäßigen Abständen zu kontrollieren. backendretrycount N-2 3 Optional. Gibt an, wie oft der Kunde die Zahlung wiederholen kann, wenn die Zahlung fehlschlägt und - ggf. unter Verwendung einer anderen Kreditkarte bzw. Bankverbindung - eine erfolgreiche Durchführung der Zahlung prinzipiell möglich ist. Ohne diesen Parameter ist in diesem Fall keine Wiederholung möglich. Fehler, die bereits bei einer oberflächlichen Validierung der Daten auffallen, z.b. eine fehlende Kartenprüfnummer oder ein Verfallsdatum in der Vergangenheit, fallen nicht unter diese Regelung. In diesen Fällen ist eine Wiederholung immer beliebig oft möglich. Solange eine Wiederholung möglich ist, wird dem Kunden das Formular zur Eingabe der Zahlungsmitteldaten erneut mit einer entsprechenden Fehlermeldung angezeigt, und es erfolgt noch keine Benachrichtigung des Shops. Tabelle 4-5: Parameter backendretrycount basketid ANLS-50 ba_ Optional; Kennung des bestellten Warenkorbs oder Artikels, kann auf dem Kontoauszug bzw. der Kreditkartenabrechnung von Käufer und Händler angezeigt werden, s. Abschnitt Warenkorbnummer, S. 61 Tabelle 4-6: Parameter basketid bic_obsolete AN-11 BDFEFR2TXXX Vorherige BIC des Kunden bei einer Änderung des SEPA-Lastschriftmandats. Nur bei wiederkehrenden Zahlungen (sequencetype=recurring oder sequencetype=final) bei der ersten Zahlung nach der Änderung des Mandats. Wird bei einer deutschen Vorgänger-IBAN von payplace.express ermittelt. Pflichtfeld bei Angabe einer Vorgänger-IBAN (Feld iban_obsolete) aus einem anderen Land. Tabelle 4-7: Parameter bic_obsolete Version Ausgabedatum:

22 4.6 Transaktionsdetails clientip N[.] Optional; IP-Adresse des Kunden. Wird zur Prüfung der IP-Adresse verwendet, sofern diese durchgeführt wird (s. ipcheckaction). Wird clientip nicht angegeben, ermittelt payplace.express die IP-Adresse, wenn der Kunde das Formular mit den Zahlungsdaten abschickt. Tabelle 4-8: Parameter clientip command FIX sslform Pflichtfeld; Requestdefinition Tabelle 4-9: Parameter command countryrejectmessage ANL-255 Bitte wählen Sie eine andere Kreditkarte Optional, nur zusammen mit acceptcountries oder rejectcountries. Fehlermeldung, falls eine Kreditkarte aufgrund Ihres Ausgabelandes abgewiesen wurde. Fehlt der Parameter, wird die Standard-Fehlermeldung für diesen Fehler verwendet. Tabelle 4-10: Parameter countryrejectmessage creditorid_obsolete AN18 DE98ZZZ Vorherige Gläubiger-ID bei einer Änderung des SEPA-Lastschriftmandats. Nur bei wiederkehrenden Zahlungen (sequencetype=recurring oder sequencetype=final) bei der ersten Zahlung nach der Änderung des Mandats. Tabelle 4-11: Parameter creditorid_obsolete cssurl ANS Optional. URL des Cascading Stylesheet, mit dem das Formular angezeigt wird. Ohne diesen Parameter wird die im Frontoffice konfigurierte URL verwendet. Tabelle 4-12: Parameter cssurl Version Ausgabedatum:

23 4.6 Transaktionsdetails currency A3 EUR Pflichtfeld; Währungscode gemäß ISO Für Lastschriften immer EUR. Tabelle 4-13: Parameter currency customer_addr_city ANLS-80 Bonn Optional; Stadt der Adresse des Kunden. Für Adressverifizierung bei Zahlungen mit American Express Kreditkarte oder für die Erzeugung eines SEPA-PDF-Mandats. Tabelle 4-14: Parameter customer_addr_city customer_addr_country [A-Z]2 DE Optional; Ländercode der Adresse des Kunden nach ISO Für die Erzeugung eines SEPA-PDF-Mandats. Tabelle 4-15: Parameter customer_addr_country customer_addr_number ANLS-32 98a Optional; Hausnummer der Adresse des Kunden. Für Adressverifizierung bei Zahlungen mit American Express Kreditkarte oder für die Erzeugung eines SEPA-PDF- Mandats. Tabelle 4-16: Parameter customer_addr_number customer_addr_street ANLS-80 Wiesenweg Optional; Straße der Adresse des Kunden. Für Adressverifizierung bei Zahlungen mit American Express Kreditkarte oder für die Erzeugung eines SEPA-PDF-Mandats. Tabelle 4-17: Parameter customer_addr_street Version Ausgabedatum:

24 4.6 Transaktionsdetails customer_addr_zip ANL Optional; Postleitzahl der Adresse des Kunden. Für Adressverifizierung bei Zahlungen mit American Express Kreditkarte oder für die Erzeugung eines SEPA-PDF- Mandats. Tabelle 4-18: Parameter customer_addr_zip customer_firstname ANL-24 Max Optional; Vorname des Kunden. Für die Erzeugung eines SEPA-PDF-Mandats. Tabelle 4-19: Parameter customer_firstname customer_lastname ANL-30 Meier Optional; Nachname des Kunden. Für die Erzeugung eines SEPA-PDF-Mandats. Tabelle 4-20: Parameter customer_lastname date N[_:] _12:23:45 Optional; aktuelles Datum und Uhrzeit im Format JJJJMMTT_HH:mm:ss Tabelle 4-21: Parameter date debitmode FIX sepacore Optional. Art der Lastschrift. "sepacore" für SEPA-Basislastschrift (SDD Core). Ohne diesen Parameter wird eine SDD COR1 Lastschrift durchgeführt. Tabelle 4-22: Parameter debitmode Version Ausgabedatum:

25 4.6 Transaktionsdetails deliverycountry A2 DE Optional. Land der Lieferadresse. Zweibuchstabiges Länderkürzel nach ISO Wenn dieses Land nicht mit dem Ausgabeland der Kreditkarte übereinstimmt, wird die Zahlung abgewiesen, oder der Shop wird über die fehlende Übereinstimmung informiert (s. deliverycountryaction). Tabelle 4-23: Parameter deliverycountry deliverycountryaction FIX notify Optional. Gibt an, wie verfahren werden soll, wenn das in deliverycountry angegebene Land nicht mit dem Ausgabeland der Kreditkarte übereinstimmt. Mögliche Werte: "notify": bei der Benachrichtigung des Shops werden Sie über die fehlende Übereinstimmung informiert "reject": die Zahlung mit dieser Kreditkarte wird abgewiesen Falls der Parameter fehlt, wird "reject" angenommen. Tabelle 4-24: Parameter deliverycountryaction deliverycountryrejectmessage ANL-255 Bitte wählen Sie eine andere Kreditkarte Optional. Fehlermeldung, falls das Ausgabeland einer Kreditkarte nicht mit dem in deliverycountry übergebenen Land übereinstimmt und die Kreditkarte deshalb abgewiesen wird. Falls nicht angegeben, wird die Standard-Fehlermeldung des Systems für diesen Fehler verwendet. Tabelle 4-25: Parameter deliverycountryrejectmessage duedate N Fälligkeitsdatum der SEPA-Basis-Lastschrift im Format JJJJMMTT. Das Fälligkeitsdatum muss mindestens sieben (für die Sequenztypen "Folgezahlung" - sequencetype=recurring - und "Letzte Zahlung" - sequencetype=final - mindestens vier) TARGET2-Geschäftstage (nicht an Wochenenden und an den sog. TARGET2- oder TARGET-Feiertagen) nach dem aktuellen Datum liegen. Tabelle 4-26: Parameter duedate Version Ausgabedatum:

26 4.6 Transaktionsdetails form_label_cancel AL-30 Zurück Optional. Text der Abbrechen-Schaltfläche. Falls der Parameter nicht mitgeschickt wird, wird der Standardtext angezeigt. Bitte achten Sie darauf, dass der übergebene Text zur Sprache des Formulars passt (s. Parameter locale). Tabelle 4-27: Parameter form_label_cancel form_label_submit AL-30 Bezahlen Optional. Text der Submit-Schaltfläche. Falls der Parameter nicht mitgeschickt wird, wird der Standardtext angezeigt. Bitte achten Sie darauf, dass der übergebene Text zur Sprache des Formulars passt (s. Parameter locale). Tabelle 4-28: Parameter form_label_submit form_merchantname ANL-32 Schulze und Schrader GmbH Optional. Name des Händlers, der den Kunden im Formular angezeigt wird. Falls leer, wird kein Händlername angezeigt. Falls der Parameter nicht mitgeschickt wird, wird der in payplace.express konfigurierte Name angezeigt. Tabelle 4-29: Parameter form_merchantname iban_obsolete AN-34 DE Vorherige IBAN des Kunden bei einer Änderung des SEPA-Lastschriftmandats. Nur bei wiederkehrenden Zahlungen (sequencetype=recurring oder sequencetype=final) bei der ersten Zahlung nach der Änderung des Mandats. Tabelle 4-30: Parameter iban_obsolete Version Ausgabedatum:

27 4.6 Transaktionsdetails ipcheckacceptcountries A[,]-255 AT,DE,CH Optional; Liste der erlaubten Länder bei der Prüfung der IP-Adresse. Zweibuchstabige, durch Komma voneinander getrennte Länderkürzel nach dem aktuell gültigen Standard ISO 3166 (s. Eine leere Liste bedeutet keine Einschränkung des Landes der IP-Adresse. Die IP-Adresse wird nur geprüft, wenn außerdem der Parameter ipcheckaction übergeben wurde. Tabelle 4-31: Parameter ipcheckacceptcountries ipcheckaction FIX notify Optional. Gibt an, wie verfahren werden soll, wenn das Land der IP-Adresse des Kunden aufgrunde der Angaben in ipcheckacceptcountries und ipcheckrejectcountries nicht erlaubt ist. Mögliche Werte: "notify": bei der Benachrichtigung des Shops werden Sie über die fehlende Übereinstimmung informiert "reject": die Zahlung wird abgewiesen Falls der Parameter fehlt, wird keine Prüfung der IP-Adresse durchgeführt. Tabelle 4-32: Parameter ipcheckaction ipcheckmode FIX sloppy Optional. Manchmal kann nur eine Region, z.b. "EU" oder "Asien/Pazifik" aus der IP-Adresse bestimmt werden. In diesen Fällen wird für den Modus "sloppy" der Vergeich als übereinstimmend gewertet, wenn mindestens ein Land aus ipcheckacceptcountries oder ipcheckrejectcountries in dieser Region liegt. Bei "strict" würde der Vergleich in diesem Fall fehlschlagen. Mögliche Werte: strict sloppy Falls der Parameter fehlt, wird "strict" angenommen. Tabelle 4-33: Parameter ipcheckmode Version Ausgabedatum:

28 4.6 Transaktionsdetails ipcheckrejectcountries A[,]-255 AT,DE,CH Optional; Liste der nicht erlaubten Länder bei der Prüfung der IP-Adresse. Zweibuchstabige, durch Komma voneinander getrennte Länderkürzel nach dem aktuell gültigen Standard ISO 3166 (s. Eine leere Liste bedeutet keine Einschränkung des Landes der IP-Adresse. Die IP-Adresse wird nur geprüft, wenn außerdem der Parameter ipcheckaction übergeben wurde. Tabelle 4-34: Parameter ipcheckrejectcountries ipcheckrejectmessage ANL-255 Zahlung verweigert. Optional, nur zusammen mit ipcheckaction und ipcheckacceptcountries oder ipcheckrejectcountries. Fehlermeldung, falls eine Zahlung aufgrund der IP-Adresse des Kunden abgewiesen wurde. Fehlt der Parameter, wird die Standard-Fehlermeldung für diesen Fehler verwendet. Tabelle 4-35: Parameter ipcheckrejectmessage locale FIX en Optional. Sprache des anzuzeigenden Formulars. "de" - deutsch, "en" - englisch, "es" - spanisch, "fr" - französisch, "it" - italienisch, "pt" - portugiesisch, "nl" - niederländisch, "cs" - tschechisch, "sv" - schwedisch, "da" - dänsich, "pl" - polnisch. Falls nicht angegeben, wird das deutschsprachige Formular angezeigt. Für Spenden existieren zusätzliche "Locales" mit angepassten Texten: "spde" (Spende, deutsch) und "spen" (Spende, englisch). Tabelle 4-36: Parameter locale mac N[abcdef]40 0fab98c2d51992adff4732e2c5ab8599f15723e3 Pflichtfeld; Message Authentication Code, dient der Absicherung gegen Manipulationen der Zahlungsdaten, s. Abschnitt MAC - Message Authentication Code, S. 76 Tabelle 4-37: Parameter mac Version Ausgabedatum:

29 4.6 Transaktionsdetails mandateid AN[+?/-:().,']-35 M /1-AB Pflicht für SEPA-Lastschriften. Mandatsreferenznummer. Eindeutige Kennzeichnung eines SEPA-Lastschriftmandats. Tabelle 4-38: Parameter mandateid mandateid_obsolete AN[+?/-:().,']-35 M /1-AB Vorherige Mandatsreferenznummer bei einer Änderung des SEPA-Lastschriftmandats. Nur bei wiederkehrenden Zahlungen (sequencetype=recurring oder sequencetype=final) bei der ersten Zahlung nach der Änderung des Mandats. Tabelle 4-39: Parameter mandateid_obsolete mandatename ANL[+?/-:().,']-70 Schulze und Schrader GmbH Optional für SEPA-Lastschriften. Name des Empfängers, der im SEPA-Mandat verwendet wurde. Falls nicht angegeben, wird der in den Stammdaten des Shop konfigurierte Namen verwendet. Tabelle 4-40: Parameter mandatename mandatesigned N Pflicht für SEPA-Lastschriften. Datum, wann das SEPA-Lastschriftmandat erteilt wurde im Format JJJJMMTT. Tabelle 4-41: Parameter mandatesigned merchantref ANS-30 RH_6712 Optional, nur für Kreditkartenzahlungen. Transaktionsreferenz, die auf der Kreditkartenabrechnung des Händlers statt der Warenkorbnummer angezeigt wird. Tabelle 4-42: Parameter merchantref Version Ausgabedatum:

30 4.6 Transaktionsdetails notificationfailedurl ANS Optional. Wenn der Shop nicht über den Ausgang der Zahlung informiert werden kann, wird dem Kunden eine Ergebnisseite mit einem Link zu dieser URL angezeigt. Tabelle 4-43: Parameter notificationfailedurl notifyurl ANS Optional. URL, an welche die Shopbenachrichtigung geschickt werden soll. Ohne diesen Parameter wird die im Frontoffice konfigurierte URL verwendet. Tabelle 4-44: Parameter notifyurl orderid AN[-_/]-17 order_ Pflichtfeld; Vorgangsnummer Tabelle 4-45: Parameter orderid Version Ausgabedatum:

31 4.6 Transaktionsdetails payment_options FIX sslifnotenrolled Optional. Wenn Ihr Zugang für die Verwendung von Pseudokartennummern konfiguriert ist: "generate_ppan": gibt an, dass für die Kreditkarte bzw. Bankverbindung, mit der der Kunde bezahlt, eine Pseudokartennummer angelegt werden soll. "generate_ppan_verify_online": gibt an, dass es sich um die Registrierung einer Pseudokartennummer, nicht um eine Zahlung handelt. Die Texte im Formular werden passend zu einer Registrierung angezeigt, der Betrag wird ausgeblendet. Nur zusammen mit transactiontype=preauthorization bzw. ohne Parameter transactiontype und nur mit einem Betrag von höchstens 1 EUR bzw. höchstens 1 einer anderen Währungseinheit. Bei Kreditkartentransaktionen: "cardholder" gibt an, dass das Formular, das dem Kunden angezeigt wird, ein Pflichtfeld zur Eingabe des Karteninhabers enthält. "optionalcardholder" gibt an, dass das Formular ein optional auszufüllendes Feld "Karteninhaber" enthält Ohne diese Angabe enthält das Formular kein Eingabefeld für den Karteninhaber. "sslifnotenrolled" gibt an, dass bei einer Visa Karte, falls payplace.express keine Antwort vom Visa Directory erhält oder falls das Visa oder MasterCard Directory nicht feststellen konnte, ob die Kreditkarte für 3D-Secure freigeschaltet ist, eine SSL-Transaktion ohne Haftungsumkehr durchgeführt wird. Falls nicht angegeben, wird in diesem Fall die Transaktion abgebrochen. "amexavs": wenn der Kunde mit einer American Express Karte bezahlt, wird seine Adresse abgefragt und eine American Express Adressverifizierung durchgeführt. Das Ergebnis der Adressverifizierung erhalten Sie in der Shopbenachrichtigung in den Feldern rc_avsamex und rc_score. Bei Lastschriften: "accountholder" gibt an, dass das Lastschriftformular, das dem Kunden angezeigt wird, ein Pflichtfeld zur Eingabe des Kontoinhabers enthält. "optionalaccountholder" gibt an, dass das Lastschriftformular ein optional auszufüllendes Feld "Kontoinhaber" enthält Ohne diese Angabe enthält das Lastschriftformular lediglich Eingabefelder für Kontonummer und Bankleitzahl "checklist": vor der Lastschrift wird eine Sperrlistenabfrage durchgeführt. Nur verfügbar, wenn diese Option für Ihren Zugang freigeschaltet wurde. Wenn das Formular auf deutsch angezeigt wird, wird ein Text eingeblendet, mit dem der Kunde einwilligt, dass die Zahlungsdaten an InterCard übermittelt werden. "sepa_pdf_mandate" gibt an, dass im Formularservice eine PDF-Datei mit dem SEPA-Lastschriftmandat erzeugt werden soll. Dazu werden zusätzliche Angaben benötigt, die der Kunde im Verlauf des Formularservice-Dialogs ausfüllt. Falls Sie mehr als einen Wert angeben wollen,trennen Sie die einzelnen Werte durch ein Semikolon voneinander, z.b. "amexavs;cardholder" Tabelle 4-46: Parameter payment_options Version Ausgabedatum:

32 4.6 Transaktionsdetails paymentmethod FIX creditcard Pflichtfeld, Zahlungsart: "creditcard" (Kreditkarte), "maestro" oder "directdebit" (Lastschrift). Kreditkarten-Transaktionen werden als 3D-Secure-Zahlungen ausgeführt, wenn Ihr Zugang entsprechend konfiguriert ist, ansonsten erfolgt die Transaktion ohne 3D-Secure. Tabelle 4-47: Parameter paymentmethod ppan ANLS-50 5b6fd81b60f88b52c99ca71df555c831 Optional. Pseudokartennummer für eine Kreditkarte oder Bankverbindung. Zusammen mit payment_options=generate_ppan oder payment_options=generate_ppan_verify_online wird dieser Wert für die neu anzulegende Pseudokartennummer verwendet. Falls ppan nicht mitgegeben wurde, generiert payplace.express in diesem Fall eine Pseudokartennummer und sendet Ihnen diese in der Shopbenachrichtigung. Ansonsten sucht payplace.express die Daten des Zahlungsmittels heraus, zu dem diese Pseudokartennummer angelegt wurde und zeigt diese im Bezahlformular an. Der Kunde hat lediglich noch - bei einer Kreditkartenzahlung - die Kartenprüfnummer auszufüllen. Tabelle 4-48: Parameter ppan rejectcountries A[,]-255 AT,DE,CH Optional; Liste nicht erlaubter Ausgabeländer bei Kreditkartenzahlung. Zweibuchstabige, durch Komma voneinander getrennte Länderkürzel nach ISO Ohne diesen Parameter gilt keine Einschränkung hinsichtlich des Ausgabelandes. Tabelle 4-49: Parameter rejectcountries sequencetype FIX first Optional. Sequenztyp einer SEPA-Lastschrift. Falls nicht angegeben, wird eine Einmalzahlung angenommen. "oneoff": Einmalzahlung, "first": erste Zahlung einer Sequenz, "recurring": Folgezahlung, "final": letzte Zahlung einer Sequenz. Tabelle 4-50: Parameter sequencetype Version Ausgabedatum:

33 4.6 Transaktionsdetails seriesflag FIX recurring Optional. Senden Sie den Parameter seriesflag=recurring, wenn Sie eine Folgetransaktion einer wiederkehrenden Zahlung durchführen wollen. Bei wiederkehrenden Zahlungen handelt es sich z.b. um Abonnements und Mieten, die in diversen Geschäftsfeldern sehr verbreitet sind. Als Händler, der wiederkehrende Zahlungen anbietet, müssen Sie den Karteninhaber ausdrücklich darauf hinweisen, dass es sich um eine wiederkehrende Zahlung handelt und dass Folgetransaktionen von Ihnen initiiert werden. Hierzu ist explizit die Einwilligung des Karteninhabers einzuholen - vergleichbar mit der Anerkennung Ihrer AGB durch das Aktivieren eines Feldes in Ihrem Shop. Hinweis: Wenn Sie nicht sicher sind, ob Sie wiederkehrende Zahlungen generieren dürfen, fragen Sie bitte bei Ihrem Vertragspartner für die Kreditkarten-Akzeptanz nach. Eventuell könnte eine Zusatzvereinbarung erforderlich sein. Tabelle 4-51: Parameter seriesflag sessionid ANL-255 Nhdz747458sNX Optional; Kennung der aktuellen Session im Onlineshop, wird für die Benachrichtigung des Shops verwendet Tabelle 4-52: Parameter sessionid sslmerchant AN[-_.]-16 mycompanyssl Pflichtfeld; Händlerkennung Tabelle 4-53: Parameter sslmerchant transactiontype FIX authorization Optional, wenn nicht gesetzt: "preauthorization"; Transaktionsart. Entweder Reservieren ("preauthorization") oder Reservieren/Buchen ("authorization") Tabelle 4-54: Parameter transactiontype Version Ausgabedatum:

34 4.6 Transaktionsdetails version FIX 1.8 Pflichtfeld. Version des Formularservice. "1.8" für Standard-Webbrowser, "1.8m" um Formulare angezeigt zu bekommen, die für Smartphones und ähnliche mobile Geräte optimiert wurden. Tabelle 4-55: Parameter version Dieses zeigt, wie Ihr Shop den Kunden zum payplace.express-server weiterleiten kannn. Die Anfragenachricht ist hier in einem Meta-Tag enthalten. Listing 4-1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <head> <meta http-equiv="refresh" content="0; URL= amount=1,00&basketid=b &command=sslform&currency=eur&date= _15:40:39&orderid=o &paymentmethod=creditcard&sessioni d=s &sslmerchant=tobechanged&transactiontype=authorization&vers ion=1.8&mac=0fab98c2d51992adff4732e2c5ab8599f15723e3"> </head> <body></body> </html> Hinweis Kopieren Sie die in diesem angegebene URL nicht in die Adressleiste Ihres Browsers, um damit payplace.express aufzurufen. Sie würden lediglich eine Fehlermeldung erhalten Reaktion des payplace.express-servers Als Reaktion auf diesen per Redirect übermittelten Request wird dem Kunden ein Formular angezeigt, in das die Daten des Zahlungsmittels eingegeben werden. Nach dem Absenden der Daten wird die Zahlung abgewickelt (Schritte 4 bis 8 in Abschnitt Kreditkartenzahlungen mit 3D-Secure, S. 15). Falls der Kunde in diesem Formular die "Abbrechen"-Schaltfläche anklickt, wird der Shop sofort mit einer entsprechenden Fehlermeldung über den Abbruch der Zahlung informiert Anfragenachricht - Pseudokartennummer registrieren Der Ablauf beim Registrieren einer Pseudokartennummer entspricht dem Transaktionsablauf bei Zahlungen, allerdings unterscheiden sich die Parameter der Anfragenachricht. Beim Registrieren einer Pseudokartennummer sind in der Anfragenachricht folgende Parameter anzugeben: Version Ausgabedatum:

35 4.6 Transaktionsdetails command FIX sslform Pflichtfeld; Requestdefinition Tabelle 4-56: Parameter command cssurl ANS Optional. URL des Cascading Stylesheet, mit dem das Formular angezeigt wird. Ohne diesen Parameter wird die im Frontoffice konfigurierte URL verwendet. Tabelle 4-57: Parameter cssurl form_label_cancel AL-30 Zurück Optional. Text der Abbrechen-Schaltfläche. Falls der Parameter nicht mitgeschickt wird, wird der Standardtext angezeigt. Bitte achten Sie darauf, dass der übergebene Text zur Sprache des Formulars passt (s. Parameter locale). Tabelle 4-58: Parameter form_label_cancel form_label_submit AL-30 Bezahlen Optional. Text der Submit-Schaltfläche. Falls der Parameter nicht mitgeschickt wird, wird der Standardtext angezeigt. Bitte achten Sie darauf, dass der übergebene Text zur Sprache des Formulars passt (s. Parameter locale). Tabelle 4-59: Parameter form_label_submit form_merchantname ANL-32 Schulze und Schrader GmbH Optional. Name des Händlers, der den Kunden im Formular angezeigt wird. Falls leer, wird kein Händlername angezeigt. Falls der Parameter nicht mitgeschickt wird, wird der in payplace.express konfigurierte Name angezeigt. Tabelle 4-60: Parameter form_merchantname Version Ausgabedatum:

36 4.6 Transaktionsdetails locale FIX en Optional. Sprache des anzuzeigenden Formulars. "de" - deutsch, "en" - englisch oder "sv" - schwedisch. Falls nicht angegeben, wird das deutschsprachige Formular angezeigt. Tabelle 4-61: Parameter locale mac N[abcdef]40 0fab98c2d51992adff4732e2c5ab8599f15723e3 Pflichtfeld; Message Authentication Code, dient der Absicherung gegen Manipulationen der übertragenen Daten, s. Abschnitt MAC - Message Authentication Code, S. 76. Tabelle 4-62: Parameter mac notificationfailedurl ANS Optional. Wenn der Shop nicht über den Ausgang der Zahlung informiert werden kann, wird dem Kunden eine Ergebnisseite mit einem Link zu dieser URL angezeigt. Tabelle 4-63: Parameter notificationfailedurl notifyurl ANS Optional. URL, an welche die Shopbenachrichtigung geschickt werden soll. Ohne diesen Parameter wird die im Frontoffice konfigurierte URL verwendet. Tabelle 4-64: Parameter notifyurl Version Ausgabedatum:

37 4.6 Transaktionsdetails payment_options FIX cardholder Optional. "cardholder" gibt an, dass das Formular, das dem Kunden angezeigt wird, ein Pflichtfeld zur Eingabe des Karteninhabers enthält. "optionalcardholder" gibt an, dass das Formular ein optional auszufüllendes Feld "Karteninhaber" enthält Ohne diese Angabe enthält das Formular kein Eingabefeld für den Karteninhaber. "accountholder" gibt an, dass das Formular, das dem Kunden angezeigt wird, ein Pflichtfeld zur Eingabe des Kontoinhabers enthält. "optionalaccountholder" gibt an, dass das Formular ein optional auszufüllendes Feld "Kontoinhaber" enthält Ohne diese Angabe enthält das Formular kein Eingabefeld für den Kontoinhaber. Tabelle 4-65: Parameter payment_options paymentmethod FIX registerpan Pflichtfeld, Wert ist "registerpan" zur Registerierung einer Pseudokartennummer für eine Kreditkarte bzw. "registeraccount" zur Registerierung einer Pseudokartennummer für eine Bankverbindung. Tabelle 4-66: Parameter paymentmethod ppan ANLS-50 5b6fd81b60f88b52c99ca71df555c831 Optional. Pseudokartennummer. Falls nicht angegeben, generiert payplace.express eine Pseudokartennummer und sendet Ihnen diese in der Shopbenachrichtigung. Tabelle 4-67: Parameter ppan sessionid ANSL-255 Nhdz747458sNX Optional; Kennung der aktuellen Session im Onlineshop, wird für die Benachrichtigung des Shops verwendet Tabelle 4-68: Parameter sessionid Version Ausgabedatum:

38 4.6 Transaktionsdetails sslmerchant ANS-16 mycompanyssl Pflichtfeld; Händlerkennung Tabelle 4-69: Parameter sslmerchant version FIX 1.8 Pflichtfeld. Version des Formularservice. "1.8" für Standard-Webbrowser, "1.8m" um Formulare angezeigt zu bekommen, die für Smartphones und ähnliche mobile Geräte optimiert wurden. Tabelle 4-70: Parameter version Benachrichtigung des Shops Nach Abwicklung einer Zahlung wird der Shop über das Ergebnis informiert (Schritt 8 in Abschnitt Kreditkartenzahlungen mit 3D-Secure, S. 15). Dazu sendet der payplace.express einen HTTP-Request an die bei der Initialisierung im Parameter notifyurl angegebene URL. Ohne diesen Parameter erfolgt die Benachrichtigung an die im Frontoffice konfigurierte URL. Dabei werden die in den folgenden Tabellen aufgeführten CGI-Parameter übertragen. Wichtig Aus Sicherheitsgründen ist es zwingend erforderlich, dass Sie die Shopbenachrichtigung auswerten. Insbesondere können Sie nur aus der Shopbenachrichtigung entnehmen, ob eine erfolgreiche Zahlung stattgefunden hat oder nicht. Hinweis Wenn Sie die SSL-verschlüsselte Übertragung der Shopbenachrichtigung wünschen, benötigen Sie ein SSL-Zertifikat, das von einer anerkannten Zertifizierungsstelle auf den Server ausgestellt wurde, den Sie in der URL für die Shopbenachrichtigung angeben. Selbst generierte Zertifikate werden nicht akzeptiert. Sie erhalten in diesem Fall keine Shopbenachrichtigung. Sie erhalten ebenfalls keine Shopbenachrichtigung, wenn der Servername in der URL für die Shopbenachrichtigung nicht mit dem Server übereinstimmt, für den das Zertifikat ausgestellt wurde. Das gilt z.b. auch, wenn Sie in der URL für die Shopbenachrichtigung die IP-Adresse statt des Servernamens angeben. Wichtig Wenn Ihre Shopbenachrichtigung SSL-verschlüsselt übertragen wird, testen Sie bitte nach einem Wechsel des SSL-Zertifikats, ob die Shopbenachrichtigung nach wie vor funktioniert. Version Ausgabedatum:

39 4.6 Transaktionsdetails Beachten Sie, dass zukünftige Versionen von payplace.express zusätzliche Parameter enthalten können Parameterübersicht Shopbenachrichtigung - Zahlungen Die folgenden Tabellen geben eine Übersicht der Parameter der Shopbenachrichtigung. Bitte beachten Sie, dass nicht jede Antwortnachricht alle aufgeführten Parameter enthält bzw. einige Parameter unter Umständen keine Werte enthalten. sweise ist der Parameter aid bei einer fehlerhaften Transaktion leer und die Parameter basketid und sessionid sind nur dann gefüllt, wenn Sie diese Parameter in der Anfragenachricht übergeben haben. account N[*] **** Maskierte Kontonummer, wenn der Kunde die Kontonummer bei einer Lastschriftzahlung angegeben hat. Tabelle 4-71: Parameter account aid ANL-32 a34232 Genehmigungsnummer des Autorisierers Tabelle 4-72: Parameter aid amount ANS-10 22,60 Betrag. Cent-Beträge sind mit Dezimalkomma abgetrennt. Tabelle 4-73: Parameter amount bankcode N Bankleitzahl, wenn der Kunde diese bei einer Lastschriftzahlung angegeben hat. Tabelle 4-74: Parameter bankcode Version Ausgabedatum:

40 4.6 Transaktionsdetails basketid ANLS-50 ba_ Kennung des bestellten Warenkorbs oder Artikels Tabelle 4-75: Parameter basketid bic AN8-11 VZVDDED1XXX BIC der Bankverbindung des Kunden. Bei einer SEPA-Lastschriftzahlung. Tabelle 4-76: Parameter bic creditc N[*] ******1111 Maskierte Kreditkartennummer. Bei einer Kreditkartenzahlung. Tabelle 4-77: Parameter creditc currency A3 EUR Der Währungscode gemäß ISO Tabelle 4-78: Parameter currency deliverycountry FIX 0 Wenn in der Anfragenachricht deliverycountry angegeben wurde und deliveryaction=notify. Mögliche Werte: "0" Übereinstimmung "1" keine Übereinstimmung zwischen Lieferland und Ausgabeland der Kreditkarte "2" die Überprüfung war nicht möglich. (Das Ausgabeland kann nur bei Visa und MasterCard Karten festgestellt werden.) Tabelle 4-79: Parameter deliverycountry Version Ausgabedatum:

41 4.6 Transaktionsdetails directposerrorcode N-3 0 Dieser Parameter enthält den primären Rückgabecode des Systems, Details siehe Tabelle 5-7, S. 72 Tabelle 4-80: Parameter directposerrorcode directposerrormessage ANSL-255 Genehmigung verweigert. ggf. Fehlermeldung Tabelle 4-81: Parameter directposerrormessage expdat N Das Ablaufdatum einer Kreditkarte im Format JJMM. Die ersten beiden Stellen bezeichnen das Ablaufjahr der Karte. Die letzten beiden Stellen bezeichnen den Ablaufmonat. Bei einer Kreditkartenzahlung. Tabelle 4-82: Parameter expdat iban AN-34 DE IBAN. Bei einer SEPA-Lastschriftzahlung. Tabelle 4-83: Parameter iban ipcheckresult FIX accepted Wenn in der Anfragenachricht ipcheckaction=notify angegeben wurde. Mögliche Werte: "accepted" akzeptiert "rejected" Land der IP-Adresse ist nicht akzeptiert "unknown" die Überprüfung war nicht möglich Tabelle 4-84: Parameter ipcheckresult Version Ausgabedatum:

42 4.6 Transaktionsdetails mac N[abcdef]40 0fab98c2d51992adff4732e2c5ab8599f15723e3 Message Authentication Code, dient der Absicherung gegen Manipulationen der Shopbenachrichtigung (s. Anhang, Abschnitt MAC - Message Authentication Code, S. 76) Tabelle 4-85: Parameter mac orderid AN[-_/]-17 order_ Vorgangsnummer Tabelle 4-86: Parameter orderid ppan ANLS-50 5b6fd81b60f88b52c99ca71df555c831 Pseudokartennummer, wenn in der Anfrage payment_options=generate_ppan oder paymentmethod=generate_ppan_verify_online angegeben wurde. Tabelle 4-87: Parameter ppan rc N Dieser Parameter enthält den sekundären Rückgabecode des Payment-Systems. Tabelle 4-88: Parameter rc rc_avsamex FIX 5F Antwortcode einer American Express Adressverifizierung. "5F": Adresse und Postleitzahl sind korrekt. "5N": weder Adresse noch Postleitzahl sind korrekt. "5A": die Adresse ist korrekt aber nicht die Postleitzahl. "5Z": die Postleitzahl ist korrekt aber nicht die Adresse. "5U": unbekannt, Adresse und Postleitzahl wurden nicht überprüft. Tabelle 4-89: Parameter rc_avsamex Version Ausgabedatum:

43 4.6 Transaktionsdetails rc_score FIX Y Ampelwert einer American Express Adressverifizerung. Folgende Werte sind möglich: G - grün, Y - yellow/gelb, R - rot, U - unbekannt. G bedeutet, numerische Adressbestandteile und Postleitzahl sind korrekt und entspricht rc_avsamex=5f. Y bedeutet, entweder numerische Adressbestandteile oder Postleitzahl sind korrekt und entspricht rc_avsamex=5a oder rc_avsamex=5z. R bedeutet, dass weder numerische Adressbestandteile noch Postleitzahl korrekt sind und entspricht rc_avsamex=5n. U bedeutet, die Adresse konnte nicht geprüft werden und entspricht rc_avsamex=5u. Tabelle 4-90: Parameter rc_score retrefnum AN Referenznummer vom Payment-Gateway Tabelle 4-91: Parameter retrefnum sessionid ANSL-255 Nhdz747458sNX Kennung der aktuellen Session im Onlineshop, wird für den Link zurück zum Shop verwendet Tabelle 4-92: Parameter sessionid trefnum AN[-_/]-20 order_ _01 payplace.express Transaktionsnummer Tabelle 4-93: Parameter trefnum txn_card ANSL-255 VISA Markenname der Kreditkarte. Bei einer Kreditkartenzahlung. Tabelle 4-94: Parameter txn_card Version Ausgabedatum:

44 4.6 Transaktionsdetails version FIX 1.1 Version der Shopbenachrichtigung. Diese Dokumentation beschreibt Version 1.1 der Shopbenachrichtigung. Tabelle 4-95: Parameter version Parameterübersicht Shopbenachrichtigung - Pseudokartennummer registrieren Wenn Sie eine Pseudokartennummer unabhängig von einer Zahlung registrieren, enthält die Antwort ebenfalls die im vorigen Abschnitt aufgeführeten Parameter. Allerdings enthalten einige Parameter der Antwortnachricht keine Werte. In diesem Fall sind folgende Parameter relevant: directposerrorcode, directposerrormessage, mac, ppan und ggf. sessionid. Zusätzlich zu den im vorigen Abschnitt aufgeführeten Parametern enthält die Shopbenachrichtigung bei der Registrierung einer Pseudokartennummer folgende Felder: account N[*] **** Maskierte Kontonummer. Wenn die Pseudokartennummer für eine Bankverbindung registriert wurde. Tabelle 4-96: Parameter account accountholder ANLS-255 Otto Müller Name des Kontoinhabers, sofern dieser bei der Registrierung angegeben wurde. Tabelle 4-97: Parameter accountholder bankcode N Bankleitzahl. Wenn die Pseudokartennummer für eine Bankverbindung registriert wurde. Tabelle 4-98: Parameter bankcode Version Ausgabedatum:

45 4.6 Transaktionsdetails bic AN8-11 VZVDDED1XXX BIC. Wenn die Pseudokartennummer für eine Bankverbindung registriert wurde. Tabelle 4-99: Parameter bic cardholder ANLS-255 Otto Müller Name des Karteninhabers, sofern dieser bei der Registrierung angegeben wurde. Tabelle 4-100: Parameter cardholder creditc N[*] ******1111 Maskierte Kreditkartennummer. Wenn die Pseudokartennummer für eine Kreditkarte registriert wurde. Tabelle 4-101: Parameter creditc expdat N Das Ablaufdatum einer Kreditkarte im Format JJMM. Die ersten beiden Stellen bezeichnen das Ablaufjahr der Karte. Die letzten beiden Stellen bezeichnen den Ablaufmonat. Wenn die Pseudokartennummer für eine Kreditkarte registriert wurde. Tabelle 4-102: Parameter expdat iban AN-34 DE IBAN. Wenn die Pseudokartennummer für eine Bankverbindung registriert wurde. Tabelle 4-103: Parameter iban Version Ausgabedatum:

46 4.6 Transaktionsdetails txn_card ANSL-255 VISA Markenname der Kreditkarte. Wenn die Pseudokartennummer für eine Kreditkarte registriert wurde. Tabelle 4-104: Parameter txn_card version FIX 1.1 Version der Shopbenachrichtigung. Diese Dokumentation beschreibt Version 1.1 der Shopbenachrichtigung. Tabelle 4-105: Parameter version Antwortnachricht Auf diese Nachricht erwartet der payplace.express-server eine Bestätigung vom Onlineshop, andernfalls wird dem Kunden eine Fehlermeldung angezeigt. Die Antwort auf eine Benachrichtigung ist ein URL-kodiertes Dokument, das lediglich eine Textzeile (keine HTML-Tags, etc.) im Format Parameter=Wert enthält. Verwenden Sie den Parameter rurls, um dem Kunden die Erfolgsseite anzeigen zu lassen oder rurlf, wenn Sie die Fehlerseite anzeigen lassen wollen. Weisen Sie dem Parameter als Wert eine URL zu. Diese wird dem Kunden auf der Ergebnisseite als Link dargestellt. Statt dem Kunden die payplace.express-erfolgs- oder Fehlerseite anzeigen zu lassen, können Sie payplace.express auch veranlassen, dem Kunden einen HTTP-Redirect zu Ihrer eigenen Erfolgs- oder Fehlerseite zu senden. Verwenden Sie dazu für die Erfolgsseite statt rurls den Parameter redirecturls, für die Fehlerseite redirecturlf statt rurlf. Beachten Sie, dass auch eine erfolgreich abgewickelte Zahlung einen Fehler enthalten kann. sweise wäre es möglich, dass der übermittelte mac-parameter nicht mit dem berechneten Parameter übereinstimmt. In solchen Fällen sollte die Rückmeldung über einen Fehler berichten. Die Zahlung wird anschließend nicht automatisch storniert. Stornieren Sie in diesem Fall die Zahlung manuell im Frontoffice. Ob dem Kunden eine Erfolgs- oder Fehlermeldung angezeigt wird, hängt vom Parameter ab, den die URL enthält. Die Antwort auf eine Benachrichtigung sollte innerhalb von 30 Sekunden erfolgen. Version Ausgabedatum:

47 4.6 Transaktionsdetails Parameterübersicht Antwortnachricht redirecturlf ANS Gibt an, dass die Zahlung fehlerhaft beendet wurde. Enthält eine URL. payplace.express sendet einen Redirect zur angegebenen URL an den Browser des Kunden. Tabelle 4-106: Parameter redirecturlf redirecturls ANS Kennzeichnet eine Zahlung als erfolgreich. Enthält eine URL. payplace.express sendet einen Redirect zur angegebenen URL an den Browser des Kunden. Tabelle 4-107: Parameter redirecturls rurlf ANS Gibt an, dass die Zahlung fehlerhaft beendet wurde. Enthält eine URL. Die payplace.express-fehlerseite wird angezeigt. Tabelle 4-108: Parameter rurlf rurls ANS Kennzeichnet eine Zahlung als erfolgreich. Enthält eine URL. Dem Kunden wird die payplace.express-erfolgsseite angezeigt. Tabelle 4-109: Parameter rurls Eine Antwortnachricht könnte wie folgt gestaltet sein: Listing 4-2 rurls= Version Ausgabedatum:

48 4.7 Anpassung der Formulare 4.7 Anpassung der Formulare Sie können das Erscheinungsbild der Formulare mit Hilfe eines Cascading Stylesheets beeinflussen. Die URL des Stylesheets können Sie entweder im Frontoffice konfigurieren oder in der Anfragenachricht im Parameter cssurl angeben. Bitte beachten Sie, dass dieses Stylesheet sowohl für die Fomulare zur Eingabe der Zahlungsdaten (Kreditkarte und Lastschrift), als auch für die Erfolgs- und Fehlerseite verwendet wird. Bei der Einrichtung Ihres Zugangs wird die URL eines Standard-Stylesheets konfiguriert. Der HTML-Code der Formulare besteht aus div-elementen und Standard-Tags wie body oder form. Die Formulare werden durch geschachtelte div-elemente strukturiert, die entweder mit einer id oder einem class-attribut versehen sind: Version Ausgabedatum:

49 4.7 Anpassung der Formulare Abbildung 4-3: Aufbau des Formulars Die Bezeichner für ids und class-attribute entnehmen sie bitte obiger Abbildung. Die für das Apple iphone und andere Smartphones mit WebKit basiertem Webbrowser optimierten Formulare weisen ebenfalls den oben dargestellten Aufbau auf, benötigen jedoch ein eigenes Stylesheet. Verwenden Sie die folgenden Stylesheets als Grundlage für Ihre Anpassungen. Die Bezeichner der Styles dürfen nicht verändert werden. Version Ausgabedatum: