Internetkasse. Titelseite. Sparkassen-Internetkasse Anbindung für Händler und Integratoren - Formularservice

Transkript

1 Internetkasse Titelseite Sparkassen-Internetkasse Anbindung für Händler und Integratoren - Formularservice

2 Anbindung für Händler und Integratoren - Formularservice Dieses Dokument bezieht sich auf Sparkassen-Internetkasse, Version 1.2. Revision: Ausgabedatum: Abschnitt Pseudokartennummern, S. 15: Hinweis zum automatischen Löschen der Pseudokartennummer zwölf Monate nach Ablauf der Karte ergänzt. Revision: Ausgabedatum: Abschnitt Transaktionsarten, S. 16: fehlenden Abschnitt Reservieren/Buchen, S. 17 hinzugefügt. Revision: Ausgabedatum: Abschnitt Anfragenachricht - Pseudokartennummer registrieren, S. 26: Parameter payment_options hinzugefügt. Registrierung einer Pseudokartennummer mittels Formularservice: zusätzliche Antwortparameter hinzugefügt im Abschnitt Parameterübersicht Shopbenachrichtigung - Pseudokartennummer registrieren, S. 33. Abschnitt MAC - Message Authentication Code, S. 63: Parameterlisten aktualisiert. Revision: 3.3 Ausgabedatum: Kapitel Formularservice / 3D-Secure, S. 13: Registrierung von Pseudokartennummern, Hinweise zu Formularen für das Apple iphone und Parameter cssurl ergänzt. Parameter locale: Wert "sv" für schwedische Formulare ergänzt. Revision: Ausgabedatum: Abschnitt Benachrichtigung des Shops, S. 29: Zuordnung der rc_score zu den entsprechenden rc_avsamex für die American Express Adressverifizierung ergänzt. Abschnitt Kartenprüfnummer, S. 47: American Express Kartenprüfnummer kann jetzt auch 3-stellig sein. Abschnitt Testdaten für Zahlungstransaktionen, S. 50: Testdaten für die American Express Adressverifizierung hinzugefügt. Revision: Ausgabedatum: Formularservice, Tabelle 4-23, S. 24: Option "amexavs" ergänzt. Hinweise ergänzt, dass Lastschriften nur in EUR möglich sind.

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 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 Sparkassen-Internetkasse Meldungen Meldungen des VÖB-ZVD-Payment-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: Benutzereingaben Hier stehen Zeichen und Befehle, die vom Benutzer einzugeben sind. : chkconfig --add oracle Programmlistings, Quellcode Hier stehen Auszüge aus dem Programmquellcode oder Listings. : Listing 1-1 import java.util.stringtokenizer; Parameter Die Bezeichnungen sämtlicher Parameter erscheinen in der Schriftart Andale Mono. : amount. Hinweis Hinweis Ein kontextbezogener Hinweis oder weiterführende Informationen. Tipp Tipp Ein Vorschlag oder eine Empfehlung für den Benutzer. Wichtig Wichtig Ein besonders wichtiger Hinweis. Vorsicht Achtung Ein Hinweis auf einen Sachverhalt, der Vorsicht und Aufmerksamkeit erfordert. Warnung Warnung Ein sicherheitsrelevanter Hinweis. Wird dieser nicht beachtet, kann es zu Störungen im Programmablauf oder zu Hardware-Problemen kommen. Version Ausgabedatum:

6 1.2 Haftungsausschluss 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. 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 GmbH - 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 Bank für Zahlungsverkehrsdienstleistungen GmbH 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 Sparkassen-Internetkasse ist ein Managementsystem zur Weiterverarbeitung, Genehmigung und Verwaltung der bei einem Online-Händler eingehenden Kreditkarten- und 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 Sparkassen-Internetkasse 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. Der webbasierte Zugriff des Online-Händlers ist nicht Teil dieser Anbindungs- Dokumentation. Näheres dazu finden Sie im Sparkassen-Internetkasse-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 Sparkassen-Internetkasse. 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 Sparkassen-Internetkasse und unterstützt Sie bei der Anbindung Ihres Shops bzw. Ihrer Anwendung. 2.3 Inhaltsübersicht Die Dokumentation beginnt mit einer Übersicht über Sparkassen-Internetkasse. 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 Sparkassen-Internetkasse über Webbrowser Ihre Kunden Version Ausgabedatum:

10 3.2 Voraussetzungen für die Anbindung das Sparkassen-Internetkasse-System, das aus mehreren Komponenten besteht sowie die Systeme von Kreditkartenorganisationen Banken für die Abwicklung von Zahlungstransaktionen. Über Webbrowser können Sie auf Sparkassen-Internetkasse 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 Sparkassen-Internetkasse-Anwenderhandbuch beschrieben. Die Zahlungstransaktionen Ihres Shops werden von Sparkassen-Internetkasse auf ihre Plausibilität geprüft. Zur Abwicklung der Zahlungen werden die Transaktionen vom Sparkassen-Internetkasse Payment-Gateway an die Systeme der Kreditkartenorganisationen und Banken weitergeleitet. Bei Kreditkartentransaktionen erfolgt die Antwort in wenigen Sekunden. Sie wird von Sparkassen-Internetkasse 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 Sparkassen-Internetkasse 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 Sparkassen-Internetkasse-Formularservice durchführen (s. Kapitel Formularservice / 3D-Secure, S. 13). 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. Version Ausgabedatum:

11 3.3 Ablauf der Anbindung 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 Sparkassen- Internetkasse 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 Sparkassen-Internetkasse 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 Sparkassen-Internetkasse 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 Version Ausgabedatum:

12 3.4 Support-Kontakt Mit diesen Zugangsdaten konfigurieren Sie Ihr System für den Wirkbetrieb. 7. Betrieb Das Zahlungssystem steht jetzt für Sie und Ihre Kunden bereit. 3.4 Support-Kontakt Bitte erfragen Sie den Support-Kontakt beim jeweiligen Lizenznehmer/Institut. Version Ausgabedatum:

13 4.1 Voraussetzungen 4 Formularservice / 3D-Secure Mit dem Formularservice bietet Sparkassen-Internetkasse 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 Sparkassen-Internetkasse. 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. Version Ausgabedatum:

14 4.2 Funktionsbeschreibung 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. 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. Version Ausgabedatum:

15 4.3 Pseudokartennummern 8. Die CCS leitet den Paymentrequest an das Sparkassen-Internetkasse Payment-Backend weiter und benachrichtigt den Shop über das Transaktionsergebnis 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. Auf diese Weise müssen Sie 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. Wenn Ihr Zugang für die Nutzung von Pseudokartennummern konfiguriert ist, können Sie durch Angabe des Parameters payment_options=generate_ppan Sparkassen-Internetkasse mitteilen, dass Sie eine Pseudokartennummer für die Kreditkarte des Kunden anlegen wollen. In der Shopbenachrichtigung erhalten Sie dann eine von Sparkassen-Internetkasse generierte Pseudokartennummer. Sie können im Feld ppan auch selbst eine Pseudokartennummer angeben. Mit der Pseudokartennummer können Sie weitere Transaktionen mit dieser Kreditkarte in der Händleransicht oder über die Shopschnittstelle durchführen. Als Alternative können Sie mit dem Formularservice Pseudokartennummern auch unabhängig von einer Zahlung registrieren. Der Transaktionsablauf entspricht dem für Zahlungen ohne 3D-Secure. Sparkassen-Internetkasse gewährleistet eine eindeutige Zuordnung einer Pseudokartennummer zu einer Kreditkarte. Eine bereits vergebene Pseudokartennummer darf nicht noch einmal für eine andere Kreditkarte verwendet werden. Umgekehrt dürfen für eine Kreditkarte nicht mehrere Pseudokartennummern vergeben werden. Version Ausgabedatum:

16 4.4 Zugangsdaten Pseudokartennummern 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 Sparkassen-Internetkasse 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. Sparkassen-Internetkasse ermöglicht Ihnen auch, bei der Reservierung zu bestimmen, ob und wann das System die Reservierung automatisch buchen soll. 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. 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. Version Ausgabedatum:

17 4.6 Transaktionsdetails 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 Sparkassen-Internetkasse Anfragenachricht - Zahlungen Die in den folgenden Tabellen aufgeführten Parameter werden über den Browser des Kunden durch ein Redirect an den Sparkassen-Internetkasse-Server übermittelt. Der Shop reagiert also auf eine Aktion des Browsers mit einer Antwort, die den Kunden an den Sparkassen-Internetkasse-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. 26. en zu den in den folgenden Tabellen angegebenen en der Parameter finden Sie im Abschnitt Formatbeschreibung der Parameter, S. 62. Näheres zum Parameter mac finden Sie im Anhang im Abschnitt MAC - Message Authentication Code, S. 63. Zur Verwendung der Warenkorbnummer (Parameter basketid) lesen Sie bitte auch Abschnitt Warenkorbnummer, S. 48. Die optionalen Parameter acceptcountries, countryrejectmessage, deliverycountry, deliverycountryaction, deliverycountryrejectmessage und rejectcountries dienen der Ü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 Ausgabelandes statt, 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. 18) oder von Sparkassen-Internetkasse die Standard-Fehlermeldung für diesen Fehler anzeigen lassen. Die optionalen Parameter customer_addr_... dienen der Adressverifizierung durch American Express. Die Parameter sind nur relevant, wenn die Zahlung mit einer American Express Kreditkarte erfolgt. Andernfalls werden diese Parame- Version Ausgabedatum:

18 4.6 Transaktionsdetails ter 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 Sparkassen-Internetkasse vom Access Control Server die Antwort erhält, dass eine Autorisierung nicht möglich ist. Dies kann technische Gründe haben oder daran liegen, dass eine Kreditkarte nicht am Verified by Visa bzw. MasterCard SecureCode Programm teilnimmt. Aufgrund der unterschiedlichen Regelungen von Visa und MasterCard geht Sparkassen-Internetkasse 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 in der Anfragenachricht wurde der Parameter payment_options=sslifvisaenrolledu übermittelt. In diesem Fall wird die Transaktion 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. 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. Ohne diesen Parameter gilt keine Einschränkung hinsichtlich des Ausgabelandes. Tabelle 4-1: Parameter acceptcountries Version Ausgabedatum:

19 4.6 Transaktionsdetails 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 NS-10 22,60 Pflichtfeld; Betrag mit Dezimalkomma 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 basketid Achtung Bei der "autocapture"-buchung erfolgt keine separate Rückmeldung an den Shop. 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. Daher empfehlen wir, die betroffenen Reservierungen in regelmäßigen Abständen zu kontrollieren und fehlerhafte Buchungen gegebenenfalls manuell nachzuholen. 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. 48 Tabelle 4-5: Parameter basketid Version Ausgabedatum:

20 4.6 Transaktionsdetails command FIX sslform Pflichtfeld; Requestdefinition Tabelle 4-6: Parameter command countryrejectmessage AN-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-7: Parameter countryrejectmessage cssurl ANS Optional. URL des Cascading Stylesheet, mit dem das Formular angezeigt wird. Ohne diesen Parameter wird die in der Händleroberfläche konfigurierte URL verwendet. Tabelle 4-8: Parameter cssurl currency A3 EUR Pflichtfeld; Währungscode gemäß ISO Für Lastschriften immer EUR. Tabelle 4-9: Parameter currency customer_addr_city ANLS-80 Bonn Optional; Stadt der Adresse des Kunden. Für Adressverifizierung bei Zahlungen mit American Express Kreditkarte. Tabelle 4-10: Parameter customer_addr_city Version Ausgabedatum:

21 4.6 Transaktionsdetails customer_addr_number ANLS-32 98a Optional; Hausnummer der Adresse des Kunden. Für Adressverifizierung bei Zahlungen mit American Express Kreditkarte. Tabelle 4-11: 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. Tabelle 4-12: Parameter customer_addr_street customer_addr_zip ANL Optional; Postleitzahl der Adresse des Kunden. Für Adressverifizierung bei Zahlungen mit American Express Kreditkarte. Tabelle 4-13: Parameter customer_addr_zip date N[_:] _12:23:45 Optional; aktuelles Datum und Uhrzeit im Format JJJJMMTT_HH:mm:ss Tabelle 4-14: Parameter date deliverycountry A2 DE Optional. Land der Lieferadresse. Zweibuchstabiges Länderkürzel nach ISO Tabelle 4-15: Parameter deliverycountry Version Ausgabedatum:

22 4.6 Transaktionsdetails 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-16: Parameter deliverycountryaction deliverycountryrejectmessage AN-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-17: Parameter deliverycountryrejectmessage 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. Falls nicht angegeben, wird das deutschsprachige Formular angezeigt. Für Spenden und Beiträge existieren zusätzliche "Locales" mit angepassten Texten: "spde" (Spende, deutsch), "spen" (Spende, englisch), "btde" (Beitrag, deutsch), "bten" (Beitrag, englisch). Tabelle 4-18: 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. 63 Tabelle 4-19: Parameter mac Version Ausgabedatum:

23 4.6 Transaktionsdetails 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-20: Parameter merchantref 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-21: Parameter notificationfailedurl orderid AN[-_/]-17 order_ Pflichtfeld; Vorgangsnummer Tabelle 4-22: Parameter orderid Version Ausgabedatum:

24 4.6 Transaktionsdetails payment_options FIX sslifvisaenrolledu Optional. 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. "sslifvisaenrolledu" gibt an, dass bei einer Visa Karte, für die eine Autorisierung nicht möglich ist, eine SSL-Transaktion ohne Haftungsumkehr durchgeführt wird. Falls nicht angegeben, wird in diesem Fall die Transaktion abgebrochen. "generate_ppan": nur, wenn Ihr Zugang für die Verwendung von Pseudokartennummern konfiguriert ist. Gibt an, dass für die Kreditkarte, mit der der Kunde bezahlt, eine Pseudokartennummer angelegt werden soll. "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. Falls Sie mehr als einen Wert angeben wollen,trennen Sie die einzelnen Werte durch ein Semikolon voneinander, z.b. "checklist;accountholder" Tabelle 4-23: Parameter payment_options 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-24: Parameter paymentmethod Version Ausgabedatum:

25 4.6 Transaktionsdetails ppan ANLS-50 5b6fd81b60f88b52c99ca71df555c831 Optional, nur für Kreditkartenzahlungen zusammen mit payment_options=generate_ppan verwenden. Pseudokartennummer für eine Kreditkarte. Falls nicht angegeben, generiert Sparkassen-Internetkasse eine Pseudokartennummer und sendet Ihnen diese in der Shopbenachrichtigung. Tabelle 4-25: 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-26: Parameter rejectcountries sessionid ANSL-255 Nhdz747458sNX Optional; Kennung der aktuellen Session im Onlineshop, wird für die Benachrichtigung des Shops verwendet Tabelle 4-27: Parameter sessionid sslmerchant ANS-16 mycompany Pflichtfeld; Händlerkennung Tabelle 4-28: Parameter sslmerchant transactiontype FIX authorization Optional, wenn nicht gesetzt: "preauthorization"; Transaktionsart. Entweder Reservieren ("preauthorization") oder Reservieren/Buchen ("authorization") Tabelle 4-29: Parameter transactiontype Version Ausgabedatum:

26 4.6 Transaktionsdetails version FIX 1.5 Pflichtfeld. Version des Formularservice. "1.5" für Standard-Webbrowser, "1.5m" um Formulare angezeigt zu bekommen, die für das Apple iphone und andere Smartphones mit WebKit basiertem Webbrowser optimiert wurden. Tabelle 4-30: Parameter version Dieses zeigt, wie Ihr Shop den Kunden zum Sparkassen-Internetkasse- 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.5&mac=0fab98c2d51992adff4732e2c5ab8599f15723e3"> </head> <body></body> </html> Hinweis Kopieren Sie die in diesem angegebene URL nicht in die Adressleiste Ihres Browsers, um damit Sparkassen-Internetkasse aufzurufen. Sie würden lediglich eine Fehlermeldung erhalten Reaktion des Sparkassen-Internetkasse-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. 14). 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 Version Ausgabedatum:

27 4.6 Transaktionsdetails Anfragenachricht. Beim Registrieren einer Pseudokartennummer sind in der Anfragenachricht folgende Parameter anzugeben: command FIX sslform Pflichtfeld; Requestdefinition Tabelle 4-31: Parameter command cssurl ANS Optional. URL des Cascading Stylesheet, mit dem das Formular angezeigt wird. Ohne diesen Parameter wird die in der Händleroberfläche konfigurierte URL verwendet. Tabelle 4-32: Parameter cssurl 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-33: 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. 63. Tabelle 4-34: Parameter mac Version Ausgabedatum:

28 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-35: Parameter notificationfailedurl 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. Tabelle 4-36: Parameter payment_options paymentmethod FIX registerpan Pflichtfeld, Wert ist "registerpan". Tabelle 4-37: Parameter paymentmethod ppan ANLS-50 5b6fd81b60f88b52c99ca71df555c831 Optional. Pseudokartennummer für eine Kreditkarte. Falls nicht angegeben, generiert Sparkassen-Internetkasse eine Pseudokartennummer und sendet Ihnen diese in der Shopbenachrichtigung. Tabelle 4-38: Parameter ppan sessionid ANSL-255 Nhdz747458sNX Optional; Kennung der aktuellen Session im Onlineshop, wird für die Benachrichtigung des Shops verwendet Tabelle 4-39: Parameter sessionid Version Ausgabedatum:

29 4.6 Transaktionsdetails sslmerchant ANS-16 mycompany Pflichtfeld; Händlerkennung Tabelle 4-40: Parameter sslmerchant version FIX 1.5 Pflichtfeld. Version des Formularservice. "1.5" für Standard-Webbrowser, "1.5m" um Formulare angezeigt zu bekommen, die für das Apple iphone und andere Smartphones mit WebKit basiertem Webbrowser optimiert wurden. Tabelle 4-41: 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. 14). Dazu sendet der Sparkassen-Internetkasse-Server einen HTTP-Request an die in der Händleroberfläche 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:

30 4.6 Transaktionsdetails Beachten Sie, dass zukünftige Versionen von Sparkassen-Internetkasse 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. aid ANL-32 a34232 Genehmigungsnummer des Autorisierers Tabelle 4-42: Parameter aid amount ANS-10 22,60 Betrag mit Dezimalkomma Tabelle 4-43: Parameter amount basketid ANLS-50 ba_ Kennung des bestellten Warenkorbs oder Artikels Tabelle 4-44: Parameter basketid currency A3 EUR Der Währungscode gemäß ISO Tabelle 4-45: Parameter currency Version Ausgabedatum:

31 4.6 Transaktionsdetails 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-46: Parameter deliverycountry directposerrorcode N-3 0 Dieser Parameter enthält den primären Rückgabecode des Systems, Details siehe Tabelle 5-7, S. 59 Tabelle 4-47: Parameter directposerrorcode directposerrormessage ANSL-255 Genehmigung verweigert. ggf. Fehlermeldung Tabelle 4-48: Parameter directposerrormessage mac N[abcdef]40 0fab98c2d51992adff4732e2c5ab8599f15723e3 Message Authentication Code, dient der Absicherung gegen Manipulationen der Shopbenachrichtigung (s. Anhang, Abschnitt MAC - Message Authentication Code, S. 63) Tabelle 4-49: Parameter mac orderid AN[-_/]-17 order_ Vorgangsnummer Tabelle 4-50: Parameter orderid Version Ausgabedatum:

32 4.6 Transaktionsdetails ppan ANLS-50 5b6fd81b60f88b52c99ca71df555c831 Pseudokartennummer für eine Kreditkarte, wenn in der Anfrage payment_options=generate_ppan oder paymentmethod=registerpan angegeben wurde. Tabelle 4-51: Parameter ppan rc N Dieser Parameter enthält den sekundären Rückgabecode des Payment-Systems. Tabelle 4-52: 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-53: Parameter rc_avsamex 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-54: Parameter rc_score Version Ausgabedatum:

33 4.6 Transaktionsdetails retrefnum AN Referenznummer vom Payment-Gateway Tabelle 4-55: Parameter retrefnum sessionid ANSL-255 Nhdz747458sNX Kennung der aktuellen Session im Onlineshop, wird für den Link zurück zum Shop verwendet Tabelle 4-56: Parameter sessionid trefnum AN[-_/]-20 order_ _01 Sparkassen-Internetkasse Transaktionsnummer Tabelle 4-57: Parameter trefnum 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 im vorigen Abschnitt aufgeführeten Parametern enthält die Shopbenachrichtigung bei der Registrierung einer Pseudokartennummer folgende Felder: cardholder ANLS-255 Otto Müller Name des Karteninhabers, sofern dieser bei der Registrierung angegeben wurde. Tabelle 4-58: Parameter cardholder Version Ausgabedatum:

34 4.6 Transaktionsdetails creditc N[*] ******1111 Maskierte Kreditkartennummer Tabelle 4-59: 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. Tabelle 4-60: Parameter expdat txn_card ANSL-255 VISA Markenname der Kreditkarte. Tabelle 4-61: Parameter txn_card Antwortnachricht Auf diese Nachricht erwartet der Sparkassen-Internetkasse-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 Sparkassen-Internetkasse-Erfolgs- oder Fehlerseite anzeigen zu lassen, können Sie Sparkassen-Internetkasse 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- Version Ausgabedatum:

35 4.6 Transaktionsdetails ßend nicht automatisch storniert. Stornieren Sie in diesem Fall die Zahlung manuell über die Händleroberfläche. 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. Parameterübersicht Antwortnachricht redirecturlf ANS Gibt an, dass die Zahlung fehlerhaft beendet wurde. Enthält eine URL. Sparkassen- Internetkasse sendet einen Redirect zur angegebenen URL an den Browser des Kunden. Tabelle 4-62: Parameter redirecturlf redirecturls ANS Kennzeichnet eine Zahlung als erfolgreich. Enthält eine URL. Sparkassen-Internetkasse sendet einen Redirect zur angegebenen URL an den Browser des Kunden. Tabelle 4-63: Parameter redirecturls rurlf ANS Gibt an, dass die Zahlung fehlerhaft beendet wurde. Enthält eine URL. Die Sparkassen-Internetkasse-Fehlerseite wird angezeigt. Tabelle 4-64: Parameter rurlf rurls ANS Kennzeichnet eine Zahlung als erfolgreich. Enthält eine URL. Dem Kunden wird die Sparkassen-Internetkasse-Erfolgsseite angezeigt. Tabelle 4-65: Parameter rurls Version Ausgabedatum:

36 4.7 Anpassung der Formulare Eine Antwortnachricht könnte wie folgt gestaltet sein: Listing 4-2 rurls= 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 in der Händleroberfläche 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. Der HTML-Code der Formulare besteht aus div-elementen und Standard-Tags wie body oder form. Auf dem Test- und Produktivsystem stehen Ihnen bereits CSS-Dateien mit den im folgenden genannten URLs zur Verfügung. Testsystem, Formular mit Schriftzug "S-Internetkasse": Produktivsystem, Formular mit Schriftzug "S-Internetkasse": Testsystem, Formular ohne Schriftzug "S-Internetkasse": Produktivsystem, Formular ohne Schriftzug "S-Internetkasse": Die CSS-Datei mit Schriftzug "S-Internetkasse" existiert außerdem in einer Variante für die für Smartphones optimierten Formulare. Ersetzen Sie dazu in der URL die Versionsangabe "1.5" durch "1.5m". Die Formulare werden durch geschachtelte div-elemente strukturiert, die entweder mit einer id oder einem class-attribut versehen sind: Version Ausgabedatum:

37 4.7 Anpassung der Formulare Abbildung 4-3: Aufbau des Popup-Fensters 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: