Handbuch Handbuch zur Paypage der epaybl 17. Februar 2012 Klaus Peters Projektentwicklung Tel: +49 (30) 515 932 246 Mail: kpeters@dresearch.de www.dresearch.de
Inhaltsverzeichnis Inhaltsverzeichnis... 2 Referenzen... 4 Abkürzungen... 4 Hinweis der Redaktion... 4 Abbildungsverzeichnis... 5 1 Einleitung... 7 1.1 Die Paypage der epaybl... 7 1.2 Zum Inhalt des Dokumentes... 9 1.3 Mögliche Zahlverfahren... 10 1.4 Paypage und der externe Zahlungsdienstleister... 13 2 Hinweise zur organisatorischen Einbindung der Paypage... 14 3 Ablauf der Zahlverfahren... 16 3.1 Anmeldung... 16 3.2 Bezahlung mit Giropay über Saferpay... 19 3.3 Bezahlung Kreditkarte über Saferpay... 23 3.4 Bezahlung mittels Elektronischer Lastschrift... 26 3.5 Bezahlung mittels Lastschrift mit Einzugsermächtigung... 29 3.6 Bezahlung mittels Überweisung... 34 3.7 Bezahlung mittels Überweisung (Vorkasse)... 35 3.8 Bezahlung mittels SEPA-Lastschrift... 36 3.8.1 Der Kunde hat ein gültiges SEPA-Mandat... 37 3.8.2 Der Kunde hat kein gültiges SEPA-Mandat... 39 3.8.3 Einmal-Lastschrift... 44 3.8.4 Verwendung einer PIN... 46 4 Konfiguration der Paypage... 48 2
4.1 Überblick... 48 4.2 Konfiguration über das Portal... 49 4.3 Struktur des Konfigurationsarchivs... 52 4.3.1 Konfiguration der Bilder... 54 4.3.2 Konfiguration der Links auf der Navigationsleiste... 57 4.3.3 Weitere Konfigurationen über die Datei links.txt... 59 4.3.4 Beispiel für die Datei links.txt... 60 4.4 Aufrufparameter für die Paypage... 61 5 Anbindung der Paypage... 62 5.1 Ablauf... 63 5.2 Der Web-Service anlegenkunde... 64 5.2.1 Voraussetzungen... 64 5.2.2 Aufrufbeschreibung... 64 5.2.3 Parameterbelegung... 65 5.3 Der Web-Service anlegenkassenzeichenmitzahlverfahrenliste... 65 5.3.1 Voraussetzungen... 65 5.3.2 Hinweise zu einzelnen Zahlverfahren bei Verwendung der Paypage... 65 5.3.3 Aufrufbeschreibung... 67 5.3.4 Parameterbelegung mit SaxMBS/Kabu... 68 5.3.5 Parameterbelegung mit anderen Kassensystemen... 70 5.4 Der Web-Service loeschenkunde... 72 5.4.1 Voraussetzungen... 72 5.4.2 Aufrufbeschreibung... 72 5.4.3 Parameterbelegung... 72 5.5 Der Web-Service abbuchenmitsepamandatreferenz... 72 5.5.1 Voraussetzungen... 72 5.5.2 Aufrufbeschreibung... 73 5.5.3 Parameterbelegung... 73 5.6 Der Web-Service anlegensepamandat... 73 5.6.1 Voraussetzungen... 73 5.6.2 Aufrufbeschreibung... 74 5.6.3 Parameterbelegung... 74 5.7 Der Web-Service lesekassenzeicheninfo... 74 3
5.7.1 Voraussetzungen... 74 5.7.2 Aufrufbeschreibung... 75 5.7.3 Parameterbelegung... 75 Fragen und Antworten... 76 Referenzen [Integrationshandbuch] epaybl Integrationshandbuch, Revision: 11.02.2015 14:01:00 [Administrationshandbuch] Handbuch Administration Rechnungslegung, Stand 31.1.10 Abkürzungen RLE Rechnungslegende Einheit RE Rechnungsempfänger Hinweis der Redaktion In diesem Dokument wird auf die Nennung beider Geschlechterbezeichnungen verzichtet; mit der Nennung der männlichen Form ist immer auch die weibliche gemeint. 4
Tabellenverzeichnis Tabelle 1: Paypage URLs Freistaat Sachsen... 61 Tabelle 2: Parameterbelegung für "anlegenkunde"... 65 Tabelle 3: Beispielbelegung des Parameters zahlverfahrenliste... 66 Tabelle 4: Parameter "anlegenkassenzeichen" für SaxMBS/Kabu... 69 Tabelle 5: Parameter "anlegenkassenzeichen" für andere Kassensysteme... 71 Tabelle 6: Parameterbelegung für "loeschenkunde"... 72 Tabelle 7: Parameterbelegung für "abbuchenmitsepamandatreferenz"... 73 Tabelle 8: Parameterbelegung für "anlegensepamandat"... 74 Tabelle 9: Parameterbelegung für "lesekassenzeicheninfo"... 75 Abbildungsverzeichnis Abbildung 1: Konfigurierung von Zahlverfahren für einen Mandanten... 12 Abbildung 2: Organisatorischer Ablauf der Paypage-Anbindung... 14 Abbildung 3: Anmeldung... 17 Abbildung 4: Auswahl der Zahlverfahren... 17 Abbildung 5: Paypage-Auswahl: Giropay über Saferpay... 19 Abbildung 6: Angabe der Bankverbindung für Giropay... 20 Abbildung 7: Bezahlung der Rechnung über Giropay... 21 Abbildung 8: Online-Banking über die eigene Bank... 21 Abbildung 9: Bestätigung der Bezahlung mittels Giropay... 22 Abbildung 10: Paypage-Auswahl: Kreditkarte... 23 Abbildung 11: Angabe der Kreditkartendaten... 24 Abbildung 12: Bestätigung der Bezahlung über Kreditkarte... 25 Abbildung 13: Paypage-Auswahl: elektronische Lastschrift... 26 Abbildung 14: Bestätigung der Daten zur Lastschrift... 27 Abbildung 15: Paypage-Auswahl: Überweisung mit Einzugsermächtigung, Eingabe der PIN... 29 Abbildung 16: Eingabe der initialen PIN und Aufforderung zur Änderung... 30 Abbildung 17: Änderung einer PIN... 31 Abbildung 18: Eingabe der PIN... 32 5
Abbildung 19: Bestätigung der Lastschrift mit Einzugsermächtigung... 33 Abbildung 20: Paypage-Auswahl: Überweisung... 34 Abbildung 21: Bestätigung der Daten zur Überweisung... 35 Abbildung 22: Paypage-Auswahl: Überweisung (Vorkasse)... 36 Abbildung 23: Auswahl der SEPA-Lastschrift als Zahlverfahren... 37 Abbildung 24: Bestätigung für SEPA-Lastschrift... 38 Abbildung 25: Information über die SEPA-Lastschrift... 39 Abbildung 26: Anlegen eines SEPA-Mandates... 40 Abbildung 27: Mandatsübersicht... 41 Abbildung 28: SEPA-Mandat als PDF-Datei herunterladen... 42 Abbildung 29: Beispiel eines SEPA-Mandats... 43 Abbildung 30: Anlegen eines Mandates für eine Einmallastschrift... 45 Abbildung 31: Abfrage der PIN bei SEPA-Mandaten... 47 Abbildung 32: Die Paypage der epaybl... 48 Abbildung 33: Aufruf der Paypage mit mandantenspezifischer Konfiguration... 49 Abbildung 34: Hochladen eines Konfigurationsarchivs... 50 Abbildung 35: Ergebnis des Hochladens des Konfigurationsarchivs... 51 Abbildung 36: Konfigurierbare Bestandteile der Paypage... 52 Abbildung 37: Namen der konfigurierbaren Bilder auf der Paypage-Seite... 54 Abbildung 38: Einträge in links.txt zum Konfigurieren der Bilder... 56 Abbildung 39: Identifizierung der der konfigurierbaren Links... 57 Abbildung 40: Einträge in Links.txt zum Konfigurieren der Links... 58 Abbildung 41: Weitere Konfigurationsmöglichkeiten in links.txt... 59 Abbildung 42: Beispiel für die Datei "links.txt"... 60 Abbildung 43: Genereller Ablauf von Bezahlvorgängen via Paypage... 63 Abbildung 44: Aufrufbeschreibung "anlegenkunde"... 64 Abbildung 45: Aufrufbeschreibung anlegenkassenzeichen... 67 Abbildung 46: Aufrufbeschreibung "loeschenkunde"... 72 Abbildung 47: Aufrufbeschreibung "abbuchenmitsepamandatreferenz"... 73 Abbildung 48: Aufrufbeschreibung "anlegensepamandat"... 74 Abbildung 49: Aufrufbeschreibung "loeschenkunde" epaybl Paypage... 75 6
1 Einleitung 1.1 Die Paypage der epaybl Die Paypage stellt einen separaten Modul in der epaybl dar. Es erlaubt, verschiedene Zahlverfahren online über einen Webbrowser abzuwickeln. Diese Zahlverfahren kann Benutzer kann auf der Paypage auswählen. Dabei stehen zur Verfügung: Giropay über Saferpay, Kreditkarte über Saferpay, elektronische Lastschrift, d.h. Lastschrift ohne schriftliche Einzugsermächtigung, Überweisung (Rechnung), Lastschrift mit schriftlicher Einzugsermächtigung und Überweisung (Vorkasse) und SEPA Lastschrift mit SEPA-Mandat) (SEPA-SDD). Die Zahl der für ein Kassenzeichen auf der Paypage tatsächlich angebotenen Zahlverfahren kann eingeschränkt sein, dadurch, dass der Sachbearbeiter nur bestimmte Zahlverfahren für dieses Kassenzeichen freigegeben hat. Über die Paypage werden die notwendigen Daten der Rechnung, wie Kassenzeichen, Kundennummer usw. abgefragt und die Zahlung entsprechend dem ausgewählten Zahlverfahren ausgelöst. So erfolgt beispielweise bei der Bezahlung mittels Giropay über Saferpay letztendlich eine Verlinkung zur Online-Banking-Seite der eigenen Bank; bei der Bezahlung mit Kreditkarte wird die Zahlung über den Kreditkartenprovider (Saferpay) veranlasst. Bei der Bezahlung mit SEPA-Lastsschrift wird notfalls ein SEPA-Mandat angelegt. Bei der Zuordnung der Kassenzeichen zu Buchungsdaten kommuniziert die Paypage mit der epaybl. Das bedeutet, dass das Kassenzeichen vorher in der epaybl angelegt worden sein muss. Dies erfolgt vom Fachverfahren über Webservice- Methoden. Die Paypage kann direkt über eine entsprechende URL im Browser oder über die Seiten des Webshops aufgerufen werden. Die Paypage-Seite kann direkt mit Kassenzeichen und Kundenummer (als URL-Parameter) aufgerufen werden, so dass sich die Paypage komfortabel mit vorausgefüllten Seiten präsentiert. 7
Insgesamt ist es also mit Hilfe der Paypage möglich, eine medienbruchfreie Bezahlung von Gebührenbescheiden oder von Einkäufen in einem Webshop eines Mandanten anzubieten. 8
1.2 Zum Inhalt des Dokumentes Dieses Handbuch gibt einen Überblick über die organisatorische Einbindung der Paypage und stellt die Funktionsweise der Paypage-Seiten dar. Es werden die Konfiguration erläutert und die Einbindung der Paypage in ein bestehendes System bzw. Fachverfahren beschrieben! Hinweis: Der Aufruf der Paypage für den zahlungspflichtigen Bürger, den Kunden bzw. für ein Unternehmen erfolgt über einen handelsüblichen Internet Browser per https und ist damit sicher. Die Paypage arbeitet mit Firefox Version >= 3.6 und Internetexplorer Version >= 7.! Hinweis: In diesem Dokument werden in einigen Abbildungen Kassenzeichen, Kundennummern, E-Mail-Adressen, Namen, Adressen, Behördenbezeichnungen, Kreditkartennummern und Kontonummern verwendet. Es handelt sich bei diesen Angaben um reine Testdaten. In Kapitel 2 Hinweise zur organisatorischen Einbindung der Paypage wird in allgemeiner Weise der organisatorische Ablauf zur Anbindung der Paypage an einen bestehenden Webshop bzw. ein Fachverfahren beschrieben. Es richtet sich besonders an die Dienststellenleiter eines Mandanten. In Kapitel 3 wird der Ablauf der verschiedenen möglichen Zahlverfahren in der Paypage erläutert. Für jedes Zahlverfahren gibt es ein eigenes Unterkapitel. Dieses Kapitel erläutert den Umgang mit der Paypage anhand von Screenshots und der Beschreibung der jeweils notwendigen Eingaben. Das Kapitel richtet sich an die Betreuer des Webshops zum besseren Verständnis der Abläufe in der Paypage. Kapitel 4 stellt die Konfigurationsmöglichkeiten der Paypage dar. Der Schwerpunkt liegt dabei auf der Konfiguration des Layouts der Paypage-Seiten. Zielgruppe dieses Kapitels sind Administratoren und Betreuer des Mandanten für die epaybl. 9
Kapitel 5 liefert Informationen über die software-technischen Aspekte der Anbindung der Paypge an einen Webshop. Dieses Kapitel richtet sich besonders an Entwickler eines Webshops oder einer Fachanwendung und trägt Überblickscharakter. Für ausführliche Details sei auf das [Integrationshandbuch] verwiesen. Kapitel 5.5 gibt Antworten auf häufig gestellte Fragen 1.3 Mögliche Zahlverfahren In der epaybl sind insgesamt die folgenden Zahlverfahren möglich und von der Anwendungsbetreuung der Bezahlkomponente frei geschaltet werden: Giropay über einen externen Dienstleister Kreditkarte über einen externen Dienstleister elektronische Lastschrift / Lastschrift mit Einzugsermächtigung Überweisung Überweisung (Vorkasse) SEPA-Lastsschrift Giropay beinhaltet die Anbindung an das Online-Banking der Bank des Kunden. Nach Eingabe der notwendigen Daten wird der Kunde zum Bezahlen der Rechnung auf die Online-Banking-Seite seiner eigenen Bank geleitet. Liegt für den Kunden eine schriftliche Einzugsermächtigung vor, kann er das Zahlverfahren Lastschrift mit Einzugsermächtigung verwenden, sofern dies in der epaybl frei geschaltet wurde. Der Kunde identifiziert sich bezüglich der Einzugsermächtigung mit einer PIN. Liegt für einen Kunden keine Einzugsermächtigung vor, wird das Zahlverfahren elektronische Lastschrift angeboten, das sich für den Kunden bis auf die Abfrage einer PIN wie Lastschrift mit Einzugsermächtigung darstellt. Auch die Zahlverfahren Überweisung und Überweisung (Vorkasse) stellen sich bezüglich des Bezahlvorganges für den Kunden gleich dar: er ist angehalten die Rechnung per Überweisung zu bezahlen. Aus Sicht des Fachverfahrens bedeutet Überweisung (Vorkasse) aber, dass die Ware erst nach eingegangener Zahlung zu liefern ist. 10
Die SEPA-Lastsschrift entspricht der Lastschrift mit Einzugsermächtigung. Der Unterschied ist, dass zur Zahlung ein Mandat erforderlich ist. Diese Mandat muss in schriftlicher Form vorliegen. Wenn der Kunde noch kein Mandat hat, wird es im Rahmen der Paypage angelegt. Der Kunde lädt es sich herunter, unterschreibt es und schickt es zurück. Eigentlich muss der Webshop den Prozess solange unterbrechen, bis ein SEPA-Mandat vorliegt. Im Fall einer einmaligen Zahlung kann die Paypage aber so konfiguriert werden, dass sie den Bezahlprozess weiterführt, auch wenn das Mandat noch nicht vorliegt Die für einen Mandanten erlaubten Zahlverfahren werden im epaybl-portal über die Seite epayment Hauptmenü Administration Zahlverfahren konfiguriert (siehe Abbildung 1). Diese Einstellung wird nur von der Anwendungsbetreuung Zahlungsverkehr durchgeführt. 11
Abbildung 1: Konfigurierung von Zahlverfahren für einen Mandanten Für einen Mandanten können Zahlverfahren aktiviert, erlaubte Mindest- und Höchstbeträge für die Bezahlung festgelegt sowie Gültigkeitsprüfungen für die Bankverbindungen eingeschaltet werden. Neben den am Mandanten erlaubten Zahlverfahren bietet die epaybl dem Webshop die Möglichkeit, für ein Kassenzeichen die Zahlverfahren weiter einzuschränken (vielleicht erlaubt man Neukunden nur die Überweisung mit Vorkasse aus Sicherheitsgründen). Das kann dazu führen, dass an der Paypage für ein Kassenzeichen weniger Zahlverfahren angeboten werden, als am Mandanten erlaubt sind. 12
1.4 Paypage und der externe Zahlungsdienstleister Für die Abwicklung der Bezahlung mittels Giropay und Kreditkarte steht als Mittler zwischen Kunde und Bank bzw. Kreditkartenprovider ein externer Dienstleister zur Verfügung. Diese Lösung ist erforderlich, da die Kreditkartenzahlungen und auch Zahlungen mit Giropay PCI-konform ablaufen müssen. Aus diesem Grunde wird ein externer Zahlungsdienstleister eingebunden, der ein PCI-zertifiziertes Rechenzentrum betreibt und einen epayment-dienst (Saferpay) zur Verfügung stellt. Dieser leitet die entsprechenden Daten an die Bank bzw. Kreditkartenprovider weiter. Für die Benutzung der Paypage bedeutet dies zum einen, dass für den Mandanten bei Saferpay eine Account-ID eingerichtet sein muss, und zum anderen, dass der Zahlungspflichtige im Verlauf des Zahlvorganges auf Seiten von Saferpay verwiesen wird. Die Account-ID beantragt die Anwendungsbetreuung Zahlungsverkehr. Dieses Zusammenspiel zwischen Paypage und Saferpay ist weitgehend transparent für den Nutzer. 13
2 Hinweise zur organisatorischen Einbindung der Paypage Dieser Abschnitt gibt einen Überblick über den organisatorischen Ablauf zur Einrichtung und Anbindung der Paypage. Die software-technische Anbindung an einen Webshop wird in Kapitel 5 erläutert. Der organisatorische Prozess wird in Abbildung 2 illustriert und nachfolgend in Einzelschritten beschrieben. Abbildung 2: Organisatorischer Ablauf der Paypage-Anbindung 14
Der Prozess beginnt mit der Anfrage eines Mandanten zur Anbindung der Paypage, die er an die Anwenderbetreuung epayment (in Sachsen das SID) richtet. In einer Auftaktveranstaltung werden die notwendigen Schritte, die abzuklärenden Dokumente, sowie die zu ermittelnden Daten besprochen. Im Ergebnis entsteht ein Vertrag mit der öffentlichen Einrichtung, die die epayment-plattform bereitstellt. Nun erfolgen die software-technischen Arbeit am Fachverfahren, das die Paypage einsetzen möchte, und die Verlinkung zur Paypage. Darüber hinaus verständigen sich die Anwendungsbetreuung epayment und der externe Dienstleister über die einzurichtenden Daten. Die Ergebnisse dieses Schrittes werden auf der epaybl Integrationsanlage getestet. Diese Tests werden eventuell mehrere Iterationen umfassen. Sind die Tests erfolgreich, wird in Abstimmung mit dem Anwenderbetreuer der Produktivbetrieb eingerichtet. Nach einer Endabnahme (Akzeptanztest) kann dann der Wirkbetrieb aufgenommen werden. In Zusammenarbeit und Abstimmung mit dem Anwenderbetreuer werden später auftretende Fehler korrigiert und Änderungswünsche umgesetzt. 15
3 Ablauf der Zahlverfahren In diesem Kapitel wird der Ablauf der einzelnen Zahlverfahren aus Sicht des Kunden bzw. des Zahlungspflichtigen dargestellt. 3.1 Anmeldung Wenn die Paypage über einen Webshop bzw. ein Fachverfahren aufgerufen wird, werden in der Regel Kassenzeichen und E-Shop-Kundennummer über die URL mitgegeben, so dass die Anmeldung entfällt und der Zahlungspflichtige gleich auf der Seite mit der Zahlverfahrensauswahl startet (Abbildung 4). Andernfalls erfolgt die Eingabe dieser Daten manuell. Dies wird hier der Vollständigkeit halber mit beschrieben. Der erste Schritt auf der Paypage ist die Anmeldung (siehe Abbildung 3). Die Paypage steht in mehreren Sprachen zur Verfügung, die über die Auswahlbox auf der Startseite ausgewählt werden können. 16
Abbildung 3: Anmeldung Zur Identifizierung wird das Kassenzeichen und die Kundennummer benötigt. Statt Kundennummer kann auch die Transaktionsnummer oder die E-Mail-Adresse ( wird zurzeit aus datenschutzrechlichen Gründen nicht erhoben) angegeben werden. Über den Suchen -Button werden die zugehörigen Daten in der epaybl-datenbank gesucht und dem Kunden werden die Zahlungsdaten präsentiert (Name, Behörde (=Mandant), Kassenzeichen, Betrag, Fälligkeitsdatum). Der Kunde hat nun die Möglichkeit, aus den Zahlverfahren ein für ihn passendes auszuwählen (siehe Abbildung 4). Abbildung 4: Auswahl der Zahlverfahren Die auf dieser Seite angezeigten Zahlverfahren ergeben sich aus den für den Mandanten konfigurierten Zahlverfahren (erfolgt über die Administration am epaybl- 17
Portal nur durch die Anwendungsbetreuung epayment). Diese Zahlverfahren können durch den Webshop / die Fachanwendung weiter (z.b. auf ein einziges erlaubtes) eingeschränkt werden. Der Ablauf einer Zahlung auf der Paypage wird im Folgenden für jedes Zahlverfahren beschrieben. 18
3.2 Bezahlung mit Giropay über Saferpay Hat man sich auf der Seite mit der Auswahl der Zahlverfahren (Abbildung 3) für die Bezahlung mittels Giropay über Saferpay entschieden, gelangt man über "Weiter" zu einer Seite, die die wichtigsten Zahlungsdaten (Name, Behörde (=Mandant), Kassenzeichen, Betrag, Fälligkeitsdatum) zusammengefasst präsentiert (siehe Abbildung 5). Der Name (des Zahlungspflichtigen) wird leer gelassen, da aus Datenschutzgründen keine Kundendaten durch die epaybl verarbeitet werden. Abbildung 5: Paypage-Auswahl: Giropay über Saferpay Hier kann man die Daten noch einmal überprüfen, bevor man über den Button "Weiter" zur Saferpay-Seite geleitet wird. Ab hier erfolgt die weitere Bearbeitung nicht mehr durch die Paypage, sondern durch Saferpay selbst. 19
Die Bezahlung mittels Giropay über Saferpay erfolgt in drei Schritten. Der erste Schritt bei Saferpay ist die Angabe der Bankverbindungsdaten mit Bankleitzahl, Kontonummer und Kontoinhaber (siehe Abbildung 6). Abbildung 6: Angabe der Bankverbindung für Giropay Der auf der Seite angegebene Text für Angebot ergibt sich aus einem in der epaybl für den Mandanten hinterlegten Eintrag. Der Wert für Händler ergibt sich aus der Identifizierung des Mandanten beim externen Zahlungsdienstleister. Im Beispiel handelt es sich nur um einen Testzugang. Über den Button "Weiter" gelangt man zum zweiten Schritt, der Weiterleitung an die Online-Banking-Seite der eigenen Bank. (siehe Abbildung 7). 20
Abbildung 7: Bezahlung der Rechnung über Giropay Hier hat man erneut die Möglichkeit, die Bezahldaten zu überprüfen, bevor man dann über den Button "Weiter" zur Online-Banking-Seite der eigenen Bank geleitet wird (siehe Abbildung 8). Abbildung 8: Online-Banking über die eigene Bank 21
Entsprechend der Konfiguration des Online-Banking der eigenen Bank (hier eine Testbank "anybank") wird nun nach der PIN oder der TAN gefragt und die eigentliche Bezahlung erfolgt. Ist die Zahlung auf der Online-Banking-Seite der Bank erfolgt, gelangt man wieder zurück zu Saferpay zu einer Bestätigungsseite (siehe Abbildung 9). Abbildung 9: Bestätigung der Bezahlung mittels Giropay Das Bestätigungsfenster schließt sich automatisch. Danach gelangt man wieder zur Paypage und von dort zum aufrufenden Webshop / zur aufrufenden Fachanwendung zurück. 22
3.3 Bezahlung Kreditkarte über Saferpay Hat man auf der Seite mit der Auswahl der Zahlverfahren (Abbildung 3) die Bezahlung mittels Kreditkarte über Saferpay ausgewählt, gelangt man über "Weiter" zu einer Seite, die die wichtigsten Zahlungsdaten (Name, Behörde (=Mandant), Kassenzeichen, Betrag, Fälligkeitsdatum) zusammengefasst präsentiert (siehe Abbildung 10). Abbildung 10: Paypage-Auswahl: Kreditkarte Auch hier kann man die Rechnungsdaten überprüfen, bevor man über den Button "Weiter" zur Saferpay-Seite kommt. Ab hier erfolgt die Weiterverarbeitung wieder durch Saferpay. 23
Diese Weiterverarbeitung besteht aus zwei Schritten. Im ersten Schritt gibt man die Kreditkartendaten ein (siehe Abbildung 11). Abbildung 11: Angabe der Kreditkartendaten Hier muss man die Kreditkartennummer, das Gültigkeitsdatum, die Prüfnummer und den Namen des Kontoinhabers angeben. Über den Button "Bezahlen" wird die Bezahlung ausgeführt und man gelangt zu einer Bestätigungsseite, siehe Abbildung 12. 24
Abbildung 12: Bestätigung der Bezahlung über Kreditkarte Das Bestätigungsfenster schließt sich automatisch. Danach gelangt man wieder zur Paypage und von dort zum aufrufenden Webshop / zur aufrufenden Fachanwendung zurück. 25
3.4 Bezahlung mittels Elektronischer Lastschrift Hat man sich auf der Seite mit der Auswahl der Zahlverfahren (Abbildung 3) für die Bezahlung mittels elektronischer Lastschrift entschieden, gelangt man über "Weiter" zu einer Seite, die die wichtigsten Zahlungsdaten (Name, Behörde (=Mandant), Kassenzeichen, Betrag, Fälligkeitsdatum) zusammengefasst präsentiert und zur Eingabe der Bankverbindung (Bankleitzahl, Bankname, Kontonummer, Kontoinhaber) auffordert (siehe Abbildung 13). Abbildung 13: Paypage-Auswahl: elektronische Lastschrift 26
Über den "Weiter"-Button gelangt man zu einer Übersichtsseite mit den eingegebenen Daten (siehe Abbildung 14), gleichzeitig wird die eingegebene Bankverbindung auf Plausibilität geprüft. Abbildung 14: Bestätigung der Daten zur Lastschrift Durch Betätigen des "Bestätigen"-Buttons wird die elektronische Lastschrift mit den eingegebenen Daten veranlasst und die Zahlung bestätigt. Von der Paypage gelangt man über den Link Zurück zur Ursprungsseite wieder zum aufrufenden Webshop / zur aufrufenden Fachanwendung. 27
28
3.5 Bezahlung mittels Lastschrift mit Einzugsermächtigung Damit das Zahlverfahren Lastschrift mit Einzugsermächtigung angeboten werden kann, muss im Portal der epaybl im Bereich der Kundenpflege für den Kunden eine elektronische Einzugsermächtigung konfiguriert werden. Dabei bekommt der Kunde ein PIN zugeschickt, mit der er sich authentifiziert an der Paypage als Aussteller einer Einzugermächtigung ausweist. Dieses Zahlverfahren ersetzt dann die elektronische Lastschrift. Hat man sich für Lastschrift mit Einzugsermächtigung entschieden, gelangt man zu einer Seite mit den aktuellen Daten zum Zahlungsvorgang und der Frage nach der PIN (siehe Abbildung 15). Abbildung 15: Paypage-Auswahl: Überweisung mit Einzugsermächtigung, Eingabe der PIN 29
Gibt der Kunde hier seine initiale PIN an, wird er aufgefordert, diese zu ändern (siehe Abbildung 16). Abbildung 16: Eingabe der initialen PIN und Aufforderung zur Änderung Der markierte Button führt dann zu einer Seite, über die man die PIN ändern kann (Abbildung 17). 30
Abbildung 17: Änderung einer PIN Hat man die PIN erfolgreich geändert, kann die neue PIN in der Maske eingegeben werden (Abbildung 18). 31
Abbildung 18: Eingabe der PIN Nachdem die PIN eingegeben wurde, wird man per Weiter -Button auf die nächste Seite geführt. Hier kann bei Bedarf die hinterlegte Bankverbindung angezeigt und die Zahlung bestätigt werden. 32
Abbildung 19: Bestätigung der Lastschrift mit Einzugsermächtigung Von der Paypage gelangt man über den Link Zurück zur Ursprungsseite wieder zum aufrufenden Webshop / zur aufrufenden Fachanwendung. 33
3.6 Bezahlung mittels Überweisung Hat man sich auf der Seite mit der Auswahl der Zahlverfahren (Abbildung 3) für die Bezahlung mittels Überweisung (nach Lieferung) entschieden, gelangt man über "Weiter" zu einer Seite, die die wichtigsten Zahlungsdaten (Name, Behörde (=Mandant), Kassenzeichen, Betrag, Fälligkeitsdatum) sowie die Bankverbindung des Zahlungsempfängers (Kontoinhaber, Bankleitzahl, Kontonummer, BIC, IBAN) zusammengefasst präsentiert (siehe Abbildung 20). Abbildung 20: Paypage-Auswahl: Überweisung 34
Über den "Bestätigen"-Button bestätigt der Zahlungspflichtige, dass der geforderte Betrag per Überweisung bezahlt wird (siehe Abbildung 21). Abbildung 21: Bestätigung der Daten zur Überweisung Über den Link Zurück zur Ursprungsseite gelangt man zurück zum aufrufenden Webshop / zur aufrufenden Fachanwendung. 3.7 Bezahlung mittels Überweisung (Vorkasse) Hat man sich auf der Seite mit der Auswahl der Zahlverfahren (Abbildung 3) für die Bezahlung mittels Überweisung entschieden, gelangt man über "Weiter" zu einer Seite, die die wichtigsten Zahlungsdaten (Name, Behörde (=Mandant), Kassenzeichen, Betrag, Fälligkeitsdatum) sowie die Bankverbindung des Zahlungsempfängers (Kontoinhaber, Bankleitzahl, Kontonummer, BIC, IBAN) zusammengefasst präsentiert (siehe Abbildung 22). 35
Abbildung 22: Paypage-Auswahl: Überweisung (Vorkasse) Über den "Bestätigen"-Button bestätigt der Zahlungspflichtige, dass der geforderte Betrag per Überweisung bezahlt wird. Über den Link Zurück zur Ursprungsseite gelangt man zurück zum aufrufenden Webshop / zur aufrufenden Fachanwendung. 3.8 Bezahlung mittels SEPA-Lastschrift Der Kunde kann das Zahlverfahren SEPA SDD (SEPA Direkt Debit, SEPA- Lastschrift) auswählen, wenn er noch kein oder ein bereits aktiviertes SEPA-Mandat hat. 36
3.8.1 Der Kunde hat ein gültiges SEPA-Mandat Im Fall, dass ein aktiviertes Mandat vorliegt, erscheint eine Seite mit den Bankverbindungsdaten. Abbildung 23: Auswahl der SEPA-Lastschrift als Zahlverfahren Über den weiter -Button gelangt der Kunde zu einer Bestätigungsseite. 37
Abbildung 24: Bestätigung für SEPA-Lastschrift Hier kann man sich die Rechnungsdaten ausdrucken. Mit dem Bestätigen -Button wird die SEPA-Lastschrift definitiv ausgelöst und man gelangt zurück zur Login-Seite. 38
Abbildung 25: Information über die SEPA-Lastschrift 3.8.2 Der Kunde hat kein gültiges SEPA-Mandat Hat der Kunde noch kein gültiges SEPA-Mandat (kein SEPA-Mandat oder ein abgelaufenes), so wird er bei Auswahl des SEPA-Lastschrift-Verfahrens zum Ausfüllen eines Mandates aufgefordert. 39
Abbildung 26: Anlegen eines SEPA-Mandates Der Kunde wählt hier aus, ob es sich um eine Basis- oder Firmenlastschrift handelt, d.h. ob diese Zahlung privat oder geschäftlich ist, sowie ob das Mandat für eine einmalige Zahlung ausgestellt wird oder für mehrere Zahlungen gültig ist. Dann gelangt der Kunde zu einer Voransicht der wichtigsten Daten des Mandates. 40
Abbildung 27: Mandatsübersicht Ist der Kunde mit den Daten einverstanden, öffnet sich ein Fenster in dem das Mandat als PDF-Dokument angezeigt wird. Öffnet sich dieses Fenster nicht automatisch, dann kann man das noch mal extra auslösen durch den SEPA-Mandat PDF herunterladen -Button. 41
Abbildung 28: SEPA-Mandat als PDF-Datei herunterladen 42
Abbildung 29: Beispiel eines SEPA-Mandats 43
Der Kunde muss das SEPA-Mandat vervollständigen, insbesondere unterschreiben, und zurückschicken. Normalerweise ist damit die Paypage-Bezahlprozess beendet, da die Bezahlung erst abgeschlossen werden kann, wenn das unterschrieben Mandat vorliegt und durch den Mitarbeiter am Portal aktiviert wurde (über die SEPA-Mandatspflege, durch Eintragen des Ortes und des Datums der Unterschrift). 3.8.3 Einmal-Lastschrift Im Fall eines Mandates, das für mehrere Zahlungen gültig ist, ist dieser Aufwand vertretbar. Im Fall eines Mandates für eine einmalige Zahlung ist dieser Aufwand aber natürlich zu groß. Die epaybl bietet daher die Möglichkeit, den Bezahlprozess im Fall eines SEPA-Mandates für eine einmalige Zahlung trotz des Noch-Nicht- Vorliegens des Mandates fortzusetzen. Diese Konfiguration muss aber im Rahmen der Installation der epaybl gesetzt werden und kann nicht im Portal im laufenden Betrieb gesetzt werden. Ist die epaybl entsprechend konfiguriert und hat der Kunde beim Anlegen des Mandates ein Mandat für eine Einmallastschrift ausgewählt: 44
Abbildung 30: Anlegen eines Mandates für eine Einmallastschrift 45
dann gelangt er nach dem Bestätigen und Herunterladen, wie im Fall des Vorhandenseins eines aktiven Mandates, auf die Seite mit den Rechnungsdaten (siehe Abbildung 23) und nach Bestätigung zur Abwicklung der Zahlung als SEPA- Lastschrift (siehe Abbildung 24 und Abbildung 25). 3.8.4 Verwendung einer PIN Zur Erhöhung der Sicherheit bietet die epaybl die Möglichkeit der Autorisierung durch eine PIN. Die Verwendung einer PIN wird im Rahmen der Installation der epaybl konfiguriert und kann auch nur über eine Update-Installation geändert werden. Ist die Verwendung einer PIN konfiguriert und hat der Kunde ein gültiges SEPA- Mandat, dann erscheint nach Auswahl der SEPA-Lastschrift die Abfrage der PIN. 46
Abbildung 31: Abfrage der PIN bei SEPA-Mandaten Dabei wird hier die PIN der Einzugsermächtigung abgefragt. Es wird also keine zusätzliche PIN benötigt. Wie bei der Einzugsermächtigung wird der Kunde aufgefordert die PIN zu ändern, falls sie initial ist. Hat der Kunde die gültige PIN eingegeben gelangt er zur Bestätigungsseite für die SEPA-Lastschrift (siehe Abbildung 24). Mit der Bestätigung dieser Seite ist der Bezahlvorgang abgeschlossen. 47
4 Konfiguration der Paypage 4.1 Überblick Das Aussehen der Paypage kann pro Mandant angepasst werden. Abbildung 32: Die Paypage der epaybl Diese Anpassungen bestehen darin, dass die Bilder und Logos im Kopfteil, im Navigationsteil und im Hauptteil die Links auf der Navigationsleiste die Anstriche in den Menüieisten und die Farben 48
geändert werden können. Diese Änderungen werden über das epaybl-portal eingebracht. Wirksam werden die Änderungen, indem beim Aufruf der Paypage den Mandanten angegeben wird, z.b. https://zvtest.egov.sachsen.de/paypage/login.do?mandant=b000000 Abbildung 33: Aufruf der Paypage mit mandantenspezifischer Konfiguration Ist der Parameter "mandant" nicht gesetzt, werden die Standard-Einstellungen verwendet, d.h. es werden die Bilder und Farben verwendet, die im Rahmen der Installation eingebracht wurden. 4.2 Konfiguration über das Portal Ein Benutzer kann für seinen Mandanten die Paypage konfigurieren, indem er im epaybl-portal epayment Hauptmenü Paypage Einstellungen wählt. Hier können die gewünschten Bilder, Links und Stylesheets in Form eines Konfigurationsarchivs (ZIP-Datei) hochgeladen werden (siehe Abbildung 34). 49
Abbildung 34: Hochladen eines Konfigurationsarchivs 50
Das Archiv wird über den "Durchsuchen"-Button im Dateisystem des PCs gesucht und über den Button "Upload" in die Datenbank geladen (siehe Abbildung 35). Abbildung 35: Ergebnis des Hochladens des Konfigurationsarchivs Die Struktur des Archivs (Inhalt und Format der einzelnen Files im Archiv) wird im Folgenden beschrieben. Beim Hochladen wird geprüft, ob das Archiv die verlangte Struktur einhält. Ist das nicht der Fall, wird mit einer entsprechenden Fehlermeldung abgebrochen. Ist das Hochladen erfolgreich verlaufen, kann die Paypage mittels des Parameters "mandant" im mandantenspezifischen Layout aufgerufen werden. 51
4.3 Struktur des Konfigurationsarchivs Die in der folgenden Abbildung 36 markierten Bilder und Links können konfiguriert werden. Abbildung 36: Konfigurierbare Bestandteile der Paypage Es können konfiguriert werden: die markierten Bilder, die markierten Web-Links auf der Navigationsleiste die Anstriche und der Style der Seite (über CSS-Style-Sheets). Die Konfiguration besteht bezüglich der Bilder in: der Liefung des anzuzeigenden Bildes selbst, der Angabe einer Web-Adresse (Link), zu der beim Klicken auf das Bild gesprungen wird, sowie 52
einem Text, der am Mauszeiger beim Bewegen über das Bild angezeigt wird (Beschreibung des Links). Bei Web-Links auf der Navigationsleiste können die Links oberhalb und unterhalb des Bildes ersetzt werden. Hier können bis zu 4 Links angegeben werden. Die Konfiguration dieser Web-Links besteht jeweils in der Angabe: einer Web-Adresse, eines Textes, der auf in der Navigationsleiste erscheint und eines Textes, der am Mauszeiger erscheint, wenn man sich damit über den Link bewegt. Die Konfiguration des Styles der Seiten erfolgt durch Lieferung einer CSS-Datei. Hier müssen die Formate einer CSS-Datei eingehalten werden. Das Konfigurationsarchiv kann einen beliebigen Namen haben. Es muss aber genau die folgenden Files enthalten: RahmenBildOben.gif KopfBildLinks.gif KopfBildRechts.gif BildZentral.gif links.txt Bundesland.css Im Folgenden werden die Inhalte und Formate dieser Dateien und ihr Verwendungszweck beschrieben. 53
4.3.1 Konfiguration der Bilder Die folgende Abbildung 37 zeigt die konfigurierbaren Bilder auf der Paypage-Seite und die zugehörigen Namen im Konfigurationsarchiv. Abbildung 37: Namen der konfigurierbaren Bilder auf der Paypage-Seite 54
Diese Bilder werden unter dem angegeben Namen im Archiv geliefert. Sie müssen die folgenden Formate haben: Datei Dateiname Beschreibung Bild zwischen den beiden Menüs im Navigationsteil RahmenBildOben.gif Breite: genau 190 Pixel Höhe: maximal 300 Pixel Dateiformat: gif Bild links oben (linker Teil des Kopfbildes) KopfBildLinks.gif Breite: genau 250 Pixel Höhe: maximal 93 Pixel Dateiformat: gif Bild rechts oben (rechter Teil des Kopfbildes) KopfBildRechts.gif Breite: genau 900 Pixel Höhe: maximal 93 Pixel Dateiformat: gif Bild über dem Frame (im Hauptteil) BildZentral.gif Breite: maximal 400 Pixel Höhe: maximal 200 Pixel Dateiformat: gif Bild der Anstriche vanstrich.gif Breite: genau 16 Pixel Höhe: genau 12 Pixel Dateiformal: gif 55
Weiterhin können für jedes Bild Web-Links angegeben werden. Diese Links werden in der Textdatei links.txt als Bestandteil des Konfigurationsarchivs beschrieben. Für diese Web-Links gibt es für jedes Bild passende Einträge der Form <Name des Bildes>.href= und <Name des Bildes>.titel= Insgesamt kann es also die Einträge KopfBildLinks.href= KopfBildLinks.titel= KopfBildRechts.href= KopfBildRechts.titel= RahmenBildOben.href= RahmenBildOben.titel= BildZentral.href= BildZentral.titel= Abbildung 38: Einträge in links.txt zum Konfigurieren der Bilder in links.txt geben. Die href -Einträge geben die URL des Links an, während die titel -Einträge einen Text am Mauszeiger beim Bewegen über das Bild anzeigen. Fehlen für ein Bild die entsprechend Einträge, wird das Bild angezeigt, aber ohne Link. Es ist ein Fehler, wenn für ein Bild nur einer der Einträge angegeben ist. 56
4.3.2 Konfiguration der Links auf der Navigationsleiste Die folgende Abbildung 39 zeigt, welche Links auf der Navigationsleiste geändert werden können und wie die entsprechenden Links über Einträge in links.txt identifiziert werden. Abbildung 39: Identifizierung der der konfigurierbaren Links Sowohl im Bereich über dem Bild, als auch im Bereich unterhalb des Bildes können bis zu vier Links konfiguriert werden. Die Links werden in der Datei links.txt beschrieben. Die einzelnen Links werden durch die Namen BoxObenLink1, BoxObenLink2, BoxObenLink3, BoxObenLink4 bzw. BoxUntenLink1, BoxUntenLink2, BoxUntenLink3, BoxUntenLink4 identifiziert. Für jeden Link gibt es entsprechende Einträge mit der Bezeichnung.href und.titel. Möchte man, dass ein Link nicht erscheint, muss man beide Einträge.href und.titel weglassen. Es ist ein Fehler, wenn für einen Link nur einer der zwei Einträge angegeben ist. 57
Der href -Eintrag gibt die Web-Adresse des Links an. Der titel -Eintrag gibt den Text des Links auf der Paypage-Seite an. Insgesamt können also folgende Einträge in links.txt gesetzt werden: BoxObenLink1.href= BoxObenLink1.titel= BoxObenLink2.href= BoxObenLink2.titel= BoxObenLink3.href= BoxObenLink3.titel= BoxObenLink4.href= BoxObenLink4.titel= BoxUntenLink1.href= BoxUntenLink1.titel= BoxUntenLink2.href= BoxUntenLink2.titel= BoxUntenLink3.href= BoxUntenLink3.titel= BoxUntenLink4.href= BoxUntenLink4.titel= Abbildung 40: Einträge in Links.txt zum Konfigurieren der Links 58
4.3.3 Weitere Konfigurationen über die Datei links.txt Neben den Links können in der Datei links.txt auch konfiguriert werden: der Titel der Box, in der das Bild in der Navigationsleiste erscheint und ob die Gruppe der unteren Links überhaupt angezeigt wird, siehe Abbildung 41 Abbildung 41: Weitere Konfigurationsmöglichkeiten in links.txt Für den Text oberhalb des Bildes steht der Eintrag BoxRahmenLinks.text zur Verfügung. Hier kann ein beliebiger Text angegeben werden. Ob die Box mit den unteren Links komplett erscheint oder nicht, wird über den Eintrag BoxHerausgeber.visible 59
gesteuert. Dieser Eintrag kann auf true (Box erscheint auf der Seite) oder false (Box erscheint nicht auf der Seite) gesetzt werden. 4.3.4 Beispiel für die Datei links.txt Die folgende Abbildung zeigt ein Beispiel für die Konfigurationsdatei links.txt. Es beschreibt Links für alle Bilder, jeweils vier Links oberhalb und unterhalb des Bildes in der Navigationsleiste und einen Text für die Box dieses Bildes. KopfBildLinks.href=http://www.sachsen.de KopfBildLinks.titel=Freistaat Sachsen KopfBildRechts.href=http://www.zivit.de KopfBildRechts.titel=Verweis zu zivit RahmenBildOben.href= http://www.sachsen.de RahmenBildOben.titel=Freistaat Sachsen BildZentral.href=http://www.zivit.de BildZentral.titel=Verweis zu zivit BoxObenLink1.href=http://www.sachsen.de BoxObenLink1.titel= Freistaat Sachsen BoxObenLink2.href= http://www.sk.sachsen.de/ BoxObenLink2.titel=Sächsische Staatskanzlei BoxObenLink3.href= https://zvtest.egov.sachsen.de/paypage/ BoxObenLink3.titel=ePayBL-Paypage BoxObenLink4.href= http://amt24.sachsen.de/zfinder/behoerden.do BoxObenLink4.titel=Amt24 BoxUntenLink1.href= http://www.sk.sachsen.de/ BoxUntenLink1.titel= Sächsische Staatskanzlei BoxUntenLink2.href= http://amt24.sachsen.de/zfinder/impressum.do BoxUntenLink2.titel=Impressum BoxUntenLink3.href= http://amt24.sachsen.de/zfinder/kontakt.do BoxUntenLink3.titel=Kontakt BoxUntenLink4.href= http://amt24.sachsen.de/zfinder/kontakt.do BoxUntenLink4.titel=Behördenwegweiser BoxRahmenLinks.text=In freundlicher Zusammenarbeit mit: BoxHerausgeber.visible=true Abbildung 42: Beispiel für die Datei "links.txt" 60
4.4 Aufrufparameter für die Paypage Die folgende Tabelle zeigt die möglichen URL am Beispiel des Freistaats Sachsen: Basis URL Papyage Erklärung https://zvtest.egov.sachsen.de/paypage/login.do URL für das Testsystem https://zvis.egov.sachsen.de/paypage/login.do https://zv.egov.sachsen.de/paypage/login.do URL für das Integrationssystem URL für das Produktivsystem Tabelle 1: Paypage URLs Freistaat Sachsen Wird die URL ohne weiter Parameter aufgerufen, muss der Kunde auf der Startseite der epaybl das Kassenzeichen und seine Kundennummer eingeben. Dieses kann durch die Angabe der zusätzlichen Parameter mandant, kassenzeichen und EShopKundenNr zur Basis URL vermieden werden. Ebenfalls konfigurierbar sind die Web-Links, wohin im Fall eine Fehlers oder des Erfolges gesprungen werden soll. Im Allgemeinen wird man hier Links des vorgeschaltenen Webshop / der vorgeschaltenen Fachanwendung angeben. Diese zwei URLs werden als Parameter backlinkabort und backlinksuccess angegeben. Mit der URL backlinkabort kann der aufrufende Webshop eine Rücksprungadresse übergeben, für den Fall, dass der Kunde den Zahlvorgang abbrechen und zum Webshop / zur Fachanwendung zurückkehren möchte. Mit der URL backlinksuccess kann der aufrufende Webshop / die aufrufende Fachanwendung eine Rücksprungadresse übergeben, mit der der Kunde nach Abschluss des Zahlvorgang zum Webshop / zur Fachanwendung zurückkehren kann. Die übergebenen Links werden auf der Paypage unten rechts unter Zurück zur Ursprungsseite angeboten. Beide Links müssen als absolute Adressen, d.h. sie müssen mit http beginnen, übergeben werden. Die Funktionalität wird von der Paypage nur bereitgestellt, wenn beide URLs als Parameter übergeben werden. Ein Aufruf für das Integrationssystem in Sachsen könnte wie folgt aussehen: https://zvis.egov.sachsen.de/paypage/login.do?mandant=testmandat& kassenzeichen=1234567890&eshopkundennr=kunde_xyz& backlinkabort=http://fehlerseitewebshop.de& 61
backlinksuccess=http://successseitewebshop.de 5 Anbindung der Paypage Die epaybl bietet für Fachanwendungen oder Webshops, die keine eigene Bezahlseite in ihre Anwendung integrieren wollen, die Möglichkeit die Paypage als Bezahlseite zu nutzen. Im Folgenden sind die Abläufe und Aufrufe detailliert beschrieben, die für alle Zahlverfahren bis zur Weiterleitung auf die Paypage gleich sind: Anlegen des Kunden Anlegen eines vorläufigen Kassenzeichens mit Angabe des gewünschten Zahlverfahren Löschen des Kunden Weiterleiten zur Paypage der epaybl lesekassenzeicheninfo Unterscheidet sich der Ablauf bei den einzelnen Zahlverfahren, so wird explizit darauf hingewiesen. 62
5.1 Ablauf Aus Gründen des Datenschutzes dürfen in der epaybl des Freistaats Sachsen keine Kundendaten dauerhaft gespeichert werden. Daraus folgt, dass Fachanwendungen / Webshops bei jedem Bezahlvorgang einen neuen Kunden einrichten und diesen bei Abschluss des Vorgangs wieder löschen müssen. Für jedes Zahlverfahren gilt dementsprechend der folgende grundsätzliche Ablauf: Abbildung 43: Genereller Ablauf von Bezahlvorgängen via Paypage Die epaybl benötigt für die Abwicklung der Zahlverfahren die Kundendaten nicht dauerhaft und kann deswegen dem Datenschutz auf diese Weise Genüge tun. 63
5.2 Der Web-Service anlegenkunde 5.2.1 Voraussetzungen Der Mandant existiert im System und ist aktiviert 5.2.2 Aufrufbeschreibung anlegenkunde( anlegenkunde( mandantnr : String, mandantnr bewirtschafternr : String, : String, bewirtschafternr kunde : Kunde : String, ) returns kunde KundeErgebnis : ) returns KundeErgebnis Parameterstrukturen Parameterstrukturen Kunde Kunde eshopkundennr : String eshopkundennr sprache : String : String sprache bankverbindung : String : BankVerbindung bankverbindung : BankVerbindung Rückgabestruktur Rückgabestruktur KundeErgebnis KundeErgebnis ergebnis : Ergebnis ergebnis kunde : : Kunde Ergebnis kunde : Kunde Bankverbindung Bankverbindung BLZ : String BLZ kontonr : String : String kontonr kontoinhaber : String : String kontoinhaber : String Abbildung 44: Aufrufbeschreibung "anlegenkunde" Die Methode anlegenkunde erwartet Ihre Mandantennummer und Ihre Bewirtschafternummer. Außerdem muss ein Kunden-Objekt übergeben werden, das die Informationen des anzulegenden Kunden enthält. Die eshopkundennr und die Sprache (im Regelfall DE ) sind obligatorisch. Für einige Zahlverfahren wird allerdings die Bankverbindung des Kunden benötigt. Als Rückgabe erhalten Sie ein Objekt, das Verarbeitungsergebnis und den angelegten Kunden enthält. 64
5.2.3 Parameterbelegung Parameter anlegenkunde mandantnr bewirtschafternr Kunde eshopkundennr sprache bankverbindung Bankverbindung BLZ kontonr kontoinhaber Erklärung Ihre Mandantennummer Ihre Bewirtschafternummer Die E-Shop-Kundennummer wird von Ihrer Fachanwendung vergeben, sodass der Kunde in Ihrem System eindeutig identifizierbar ist. Die Sprache des Kunden wird als Alpha-2-Länder-Code nach ISO 639 angegeben. Im Regelfall ist dies DE. Wird ein Artikel per Bankeinzug bezahlt, muss eine Bankverbindung angegeben werden. Ansonsten kann der Parameter leer bleiben. Die Bankleitzahl der Bank des Kunden Die Kontonummer des Kunden Der Vor- und Nachname des Kunden (max. 25 Zeichen) Tabelle 2: Parameterbelegung für "anlegenkunde" 5.3 Der Web-Service anlegenkassenzeichenmitzahlverfahrenliste 5.3.1 Voraussetzungen Der Mandant existiert im System und ist aktiviert Der Kunde existiert im System 5.3.2 Hinweise zu einzelnen Zahlverfahren bei Verwendung der Paypage Mit dem Aufruf von anlegenkassenzeichenmitzahlverfahrenliste kann über den Parameter zahlverfahrenliste gesteuert werden, ob für das angelegte Kassenzeichen explizit ein Zahlverfahren, eine Liste von Zahlverfahren oder alle am Mandanten aktivierten Zahlverfahren erlaubt sind. Die folgende Tabelle listet einige Beispiele für die Belegung des Parameters zahlverfahrenliste auf. Die Spalte Erklärung beschreibt die Auswirkungen auf den Ablauf der Paypage. 65
Parameter zahlverfahrenliste null KREDITKARTE GIROPAY UEBERWEISUNGVOR UEBERWEISUNGNACH LASTSCHRIFTOHNE LASTSCHRIFTMIT KREDITKARTE, GIROPAY Erklärung Es wird die Seite der Paypage geführt auf der der Kunde ein Zahlverfahren auswählen kann. Es werden alle am Mandanten erlaubten Zahlverfahren angeboten. Es wird keine Seite für die Auswahl eines Zahlverfahrens angeboten. Es wird direkt auf die Startseite für die Bezahlung mittels Kreditkarte weitergeleitet. Es wird keine Seite für die Auswahl eines Zahlverfahrens angeboten. Es wird direkt auf die Startseite für die Bezahlung mittels Giropay weitergeleitet. Es wird keine Seite für die Auswahl eines Zahlverfahrens angeboten. Es wird direkt auf die Startseite für die Bezahlung mittels Vorkasse weitergeleitet. Es wird keine Seite für die Auswahl eines Zahlverfahrens angeboten. Es wird direkt auf die Startseite für die Bezahlung mittels Rechung weitergeleitet. Es wird keine Seite für die Auswahl eines Zahlverfahrens angeboten. Es wird direkt auf die Startseite für die Bezahlung mittels elektronischer Lastschrift weitergeleitet. Bedingung: Für den Kunden existiert keine schriftliche Einzugermächtigung. Es wird keine Seite für die Auswahl eines Zahlverfahrens angeboten. Es wird direkt auf die Startseite für die Bezahlung mittels Lastschrift mit Einzugermächtigung weitergeleitet. Bedingung: Für den Kunden existiert eine schriftliche Einzugermächtigung. Es wird die Seite der Paypage geführt auf der der Kunde ein Zahlverfahren auswählen kann. Es werden die Zahlverfahren Kreditkarte und Giropay angeboten. Tabelle 3: Beispielbelegung des Parameters zahlverfahrenliste Wird der Parameter zahlverfahrenliste nur mit einem konkreten Wert gefüllt und diese Zahlverfahren ist für den Mandaten nicht aktiviert, wird kein Kassenzeichen angelegt und der Aufruf mit einem Fehler beendet. 66
5.3.3 Aufrufbeschreibung anlegenkassenzeichenmitzahlverfahrenliste( anlegenkassenzeichenmitzahlverfahrenliste( mandantnr : String, mandantnr eshopkundennr : String, : String, eshopkundennr buchungsliste : : String, BuchungsListe buchungsliste lieferadresse : : BuchungsListe LieferAdresse lieferadresse buchungstext : LieferAdresse String buchungstext zahlverfahrenliste : String : String[] ) returns zahlverfahrenliste BuchungsListeErgebnis : String[] ) returns BuchungsListeErgebnis Parameterstrukturen Parameterstrukturen BuchungsListe BuchungsListe betrag : BigDecimal betrag waehrungskennzeichen : BigDecimal : String waehrungskennzeichen bewirtschafternummer : : String String bewirtschafternummer kennzeichenmahnverfahren : String : String kennzeichenmahnverfahren faelligkeitsdatum : Calendar : String faelligkeitsdatum buchungen : Buchung[] : Calendar buchungen kassenzeichen : Buchung[] : String kassenzeichen eshoptransaktionsnummer : String : String eshoptransaktionsnummer : String Buchung Buchung haushaltsstelle : String haushaltsstelle objektnummer: String : String objektnummer: betrag : BigDecimal String betrag buchungstext : BigDecimal : String buchungstext belegnummer : String belegnummer href : String : String href : String LieferAdresse LieferAdresse anrede : String anrede vorname : String : String vorname nachname : String : String nachname strasse : String String strasse hausnummer : String : String hausnummer postfach :: String String postfach plz : String : String plz ort : : String String ort land : String : String (ISO3361-1) land : String (ISO3361-1) Rückgabestruktur Rückgabestruktur BuchungsListeErgebnis BuchungsListeErgebnis ergebnis : Ergebnis ergebnis buchungsliste : Ergebnis : BuchungsListe buchungsliste zahlverfahren : : BuchungsListe String zahlverfahren lieferaddresse : String : LieferAdresse lieferaddresse : LieferAdresse Pflicht Pflicht Optional Optional Abbildung 45: Aufrufbeschreibung anlegenkassenzeichen 67
5.3.4 Parameterbelegung mit SaxMBS/Kabu Parameter anlegenkassenzeichen mandantnr eshopkundennr buchungsliste buchungstext zahlverfahrenliste lieferadresse BuchungsListe betrag waehrungskennzeichen bewirtschafternr kennzeichenmahnverfahren faelligkeitsdatum kassenzeichen eshoptransaktionsnr buchungen Buchung haushaltsstelle Erklärung Ihre Mandantennummer Die Kundennummer des Kunden, dessen PIN geprüft werden soll Die Buchungsliste, die die einzelnen Buchungen enthält Dieser Wert wird von der epaybl nicht ausgewertet und kann freigelassen werden (null). An dieser Stelle ist ein Stringarray mit dem/den gwünschten Zahlverfahren anzugeben. Das Array kann nur einen Eintrag haben, z.b.: KREDITKARTE oder GIROPAY, je nachdem, welches der beiden Zahlverfahren vom Kunden gewünscht wird. Es ist aber auch erlaubt, hier mehrere Zahlverfahren anzugeben. Dieses hat zur Folge, dass der Kunde auf Paypage entscheiden kann welches der in der Liste enthalten Zahlverfahren er für diesen Zahlvorgang benutzen will. Einschränkung: Wird ein Zahlverfahren übergeben, das am Mandanten nicht erlaubt ist, wird dieses Zahlverfahren nicht zur Auswahl auf der Paypage angeboten. Dieser Wert wird von der epaybl nicht ausgewertet und kann freigelassen werden (null). Der Gesamtbetrag aller Einzelbuchungen, die in dieser Buchungsliste zusammengefasst sind. Das Kennzeichen der Währung der Buchungen. Momentan ist nur EUR vorgesehen. Ihre Bewirtschafternummer Ihr Mahnkennzeichen Das Datum, zu welchem die Zahlung fällig ist. Ob ein Kassenzeichen übergeben werden muss hängt von Ihrer Mandantenkonfiguration ab. Die epaybl kann die Generierung von Kassenzeichen übernehmen. Sie können die epaybl aber auch so konfigurieren lassen, dass Sie ein eigenes Kassenzeichen übergeben können. [optional] Ihre Fachanwendung kann der Buchungsliste eine eindeutige Nummer vergeben, sodass sie von Ihrem System eindeutig zu identifizieren ist. Die Einzelforderungen, die von dieser Buchungsliste zusammengefasst werden. Die anzugebende Haushaltstelle entspricht bei Verwendung von SaxMBS dem Kapitel. 68