Handbuch

Handbuch zur Paypage der ePayBL

17. Februar 2012

Klaus Peters Projektentwicklung Tel: +49 (30) 515 932 – 246 Mail: [email protected]

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

4

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

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 5

Aufrufparameter für die Paypage ............................................................... 61

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 WebserviceMethoden. 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, Kun-

!

dennummern, 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 ePayBL17

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, SEPALastschrift) 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-NichtVorliegens 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 SEPALastschrift (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 SEPAMandat, 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

RahmenBildOben.gif

Breite: genau 190 Pixel

Menüs im Navigationsteil

Höhe: maximal 300 Pixel Dateiformat: gif

Bild links oben (linker Teil

KopfBildLinks.gif

des Kopfbildes)

Breite: genau 250 Pixel Höhe: maximal 93 Pixel Dateiformat: gif

Bild rechts oben (rechter

KopfBildRechts.gif

Teil des Kopfbildes)

Breite: genau 900 Pixel Höhe: maximal 93 Pixel Dateiformat: gif

Bild über dem Frame (im

BildZentral.gif

Hauptteil)

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 .href=… und .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

URL für das Integrationssystem

https://zv.egov.sachsen.de/paypage/login.do

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 : String,: String, bewirtschafterNr bewirtschafterNr : String, kunde : Kunde kunde : Kunde ) returns KundeErgebnis ) returns KundeErgebnis Parameterstrukturen Parameterstrukturen Kunde Kunde eShopKundenNr : String eShopKundenNr : String sprache : String sprache : String : BankVerbindung bankVerbindung bankVerbindung : BankVerbindung … …

Rückgabestruktur Rückgabestruktur KundeErgebnis KundeErgebnis ergebnis : Ergebnis ergebnis Ergebnis kunde : :Kunde kunde : Kunde

eShopKundenNr : String eShopKundenNr : String Bankverbindung sprache : String Bankverbindung sprache : String : BankVerbindung bankVerbindung bankVerbindung BLZ String : BankVerbindung … : :String BLZ … kontoNr : String kontoNr : String kontoinhaber ::String eShopKundenNr String kontoinhaber ::String … eShopKundenNr String sprache : String … sprache : String : BankVerbindung bankVerbindung bankVerbindung : BankVerbindung … …

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

Erklärung

anlegenKunde mandantNr

Ihre Mandantennummer

bewirtschafterNr

Ihre Bewirtschafternummer

Kunde eShopKundenNr

Die E-Shop-Kundennummer wird von Ihrer Fachanwendung vergeben, sodass der Kunde in Ihrem System eindeutig identifizierbar ist.

sprache

Die Sprache des Kunden wird als Alpha-2-Länder-Code nach ISO 639 angegeben. Im Regelfall ist dies „DE“.

bankverbindung

Wird ein Artikel per Bankeinzug bezahlt, muss eine Bankverbindung angegeben werden. Ansonsten kann der Parameter leer bleiben.

Bankverbindung BLZ

Die Bankleitzahl der Bank des Kunden

kontoNr

Die Kontonummer des Kunden

kontoinhaber

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

Erklärung

zahlverfahrenListe null

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.

KREDITKARTE

Es wird keine Seite für die Auswahl eines Zahlverfahrens angeboten. Es wird direkt auf die Startseite für die Bezahlung mittels Kreditkarte weitergeleitet.

GIROPAY

Es wird keine Seite für die Auswahl eines Zahlverfahrens angeboten. Es wird direkt auf die Startseite für die Bezahlung mittels Giropay weitergeleitet.

UEBERWEISUNGVOR

Es wird keine Seite für die Auswahl eines Zahlverfahrens angeboten. Es wird direkt auf die Startseite für die Bezahlung mittels Vorkasse weitergeleitet.

UEBERWEISUNGNACH

Es wird keine Seite für die Auswahl eines Zahlverfahrens angeboten. Es wird direkt auf die Startseite für die Bezahlung mittels Rechung weitergeleitet.

LASTSCHRIFTOHNE

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.

LASTSCHRIFTMIT

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.

KREDITKARTE, GIROPAY

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 : String, eShopKundenNr : String, eShopKundenNr buchungsListe: :String, BuchungsListe buchungsListe lieferAdresse: :BuchungsListe LieferAdresse lieferAdresse : LieferAdresse buchungsText : String buchungsText : String: String[] zahlverfahrenListe zahlverfahrenListe : String[] ) returns BuchungsListeErgebnis ) returns BuchungsListeErgebnis Parameterstrukturen Parameterstrukturen BuchungsListe BuchungsListe betrag : BigDecimal betrag : BigDecimal waehrungskennzeichen : String BuchungsListe waehrungskennzeichen BuchungsListe bewirtschafterNummer: :String String bewirtschafterNummer : String kennzeichenMahnverfahren : String kennzeichenMahnverfahren : String faelligkeitsDatum : Calendar faelligkeitsDatum : Calendar buchungen : Buchung[] buchungen : Buchung[] kassenZeichen : String kassenZeichen : String eShopTransaktionsNummer : String eShopTransaktionsNummer : String betrag : BigDecimal betrag : BigDecimal Buchung waehrungskennzeichen : String Buchung waehrungskennzeichen bewirtschafterNummer: :String String bewirtschafterNummer : String haushaltsStelle : String kennzeichenMahnverfahren : String haushaltsStelle : String kennzeichenMahnverfahren : String objektNummer: String faelligkeitsDatum : Calendar objektNummer: String faelligkeitsDatum : Calendar betrag : BigDecimal buchungen : Buchung[] betrag : BigDecimal buchungen : Buchung[] buchungsText ::String kassenZeichen String buchungsText :::String kassenZeichen String belegNummer String eShopTransaktionsNummer : String belegNummer : String eShopTransaktionsNummer : String href : String href : String

LieferAdresse LieferAdresse anrede : String anrede : String vorname : String vorname : String nachname : String nachname strasse :: String String strasse : String hausnummer : String hausnummer String postfach :: String postfach : String plz : String plz ort: :String String ort : String land : String (ISO3361-1) land : String (ISO3361-1)

Rückgabestruktur Rückgabestruktur BuchungsListeErgebnis BuchungsListeErgebnis ergebnis : Ergebnis ergebnis : Ergebnis buchungsListe : 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

Erklärung

anlegenKassenzeichen mandantNr

Ihre Mandantennummer

eShopKundenNr

Die Kundennummer des Kunden, dessen PIN geprüft werden soll

buchungsListe

Die Buchungsliste, die die einzelnen Buchungen enthält

buchungsText

Dieser Wert wird von der ePayBL nicht ausgewertet und kann freigelassen werden (null).

zahlverfahrenListe

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.

lieferAdresse

Dieser Wert wird von der ePayBL nicht ausgewertet und kann freigelassen werden (null).

BuchungsListe betrag

Der Gesamtbetrag aller Einzelbuchungen, die in dieser Buchungsliste zusammengefasst sind.

waehrungskennzeichen

Das Kennzeichen der Währung der Buchungen. Momentan ist nur „EUR“ vorgesehen.

bewirtschafterNr

Ihre Bewirtschafternummer

kennzeichenMahnverfahren

Ihr Mahnkennzeichen

faelligkeitsDatum

Das Datum, zu welchem die Zahlung fällig ist.

kassenzeichen

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.

eShopTransaktionsNr

[optional] Ihre Fachanwendung kann der Buchungsliste eine eindeutige Nummer vergeben, sodass sie von Ihrem System eindeutig zu identifizieren ist.

buchungen

Die Einzelforderungen, die von dieser Buchungsliste zusammengefasst werden.

Buchung haushaltsStelle

Die anzugebende Haushaltstelle entspricht bei Verwendung von SaxMBS dem „Kapitel“.

68

objektNummer

Die anzugebende Objektnummer entspricht bei Verwendung von SaxMBS dem „Titel“.

betrag

Der Betrag der Einzelforderung

buchungsText

Der Text darf nur aus den Zeichen [AZ0-9,.:/+& *$%ÄÖÜß] bestehen.

belegNummer

Ob eine Belegnummer übergeben werden muss hängt von der Mandantenkonfiguration ab. Die ePayBL kann die Generierung von Belegnummern übernehmen. Sie können die ePayBL aber auch so konfigurieren lassen, dass Sie eigene Belegnummern für die Buchungen angeben können. Wird die Belegnummer mitgeliefert, muss sie aus 8 Ziffern bestehen (ggf. mit führenden '0' auffüllen) und eindeutig im Belegnummernkreis des Bewirtschafters sein.

href

Im Feld „href“ ist die Unteranordnungsstelle zu übergeben, welche die Ebene 1 bis 4 enthält. Die jeweiligen Werte können Sie bei Ihrem Haushälter in Erfahrung bringen. Feld 61 MBS Konto Ebene 1: Zeichen 11-18 Feld 16 MBS Konto Ebene 2: Zeichen 21-28 Feld 17 MBS Konto Ebene 3: Zeichen 31-38 Feld 62 MBS Konto Ebene 4: Zeichen 41-48

Tabelle 4: Parameter "anlegenKassenzeichen" für SaxMBS/Kabu

69

5.3.5 Parameterbelegung mit anderen Kassensystemen Parameter

Erklärung

anlegenKassenzeichen mandantNr

Ihre Mandantennummer

eShopKundenNr

Die Kundennumer des Kunden, dessen PIN geprüft werden soll

buchungsListe

Die Buchungsliste, die die einzelnen Buchungen enthält

buchungsText

Dieser Wert wird von der ePayBL nicht ausgewertet und kann freigelassen werden (null).

zahlverfahrenListe

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.

lieferAdresse

Dieser Wert wird von der ePayBL nicht ausgewertet und kann freigelassen werden (null).

BuchungsListe betrag

Der Gesamtbetrag aller Einzelbuchungen, die in dieser Buchungsliste zusammengefasst sind.

waehrungskennzeichen

Das Kennzeichen der Währung der Buchungen. Momentan ist nur „EUR“ vorgesehen.

bewirtschafterNr

Ihre Bewirtschafternummer

kennzeichenMahnverfahren

Ihr Mahnkennzeichen

faelligkeitsDatum

Das Datum, zu welchem die Zahlung fällig ist.

kassenzeichen

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.

eShopTransaktionsNr

[optional] Ihre Fachanwendung kann der Buchungsliste eine eindeutige Nummer vergeben, sodass sie von Ihrem System eindeutig zu identifizieren ist.

buchungen

Die Einzelforderungen, die von dieser Buchungsliste zusammengefasst werden.

Buchung haushaltsStelle objektNummer

Je nach Kassensystem werden die Parameter „haushaltsStelle“ und „objektNummer“ unterschiedlich belegt, z.B.: Gliederung und Gruppierung. Die tatsächlichen Werte hängen vom

70

verwendeten Kassensystem ab und können bei Ihrem Betreuer erfragt werden. betrag

Der Betrag der Einzelforderung

buchungsText

Der Text darf nur aus den Zeichen [AZ0-9,.:/+& -*$%ÄÖÜß] bestehen.

belegNummer

Ob eine Belegnummer übergeben werden muss hängt von der Mandantenkonfiguration ab. Die ePayBL kann die Generierung von Belegnummern übernehmen. Sie können die ePayBL aber auch so konfigurieren lassen, dass Sie eigene Belegnummern für die Buchungen angeben können. Wird die Belegnummer mitgeliefert, muss sie aus 8 Ziffern bestehen (ggf. mit führenden '0' auffüllen) und eindeutig im Belegnummernkreis des Bewirtschafters sein.

href

Die Belegung des Rucksatzdatensatzes ist von Kassensystem zu Kassensystem unterschiedlich. Ihr Betreuer kann Ihnen genaue Informationen zur Belegung für das jeweilige Kassensystem geben.

Tabelle 5: Parameter "anlegenKassenzeichen" für andere Kassensysteme

71

5.4 Der Web-Service „loeschenKunde“ 5.4.1 Voraussetzungen 

Der Mandant existiert im System und ist aktiviert



Der Kunde existiert im System

5.4.2 Aufrufbeschreibung loeschenKunde( loeschenKunde( mandantNr : String, mandantNr : String,: String, bewirtschafterNr bewirtschafterNr String, eShopKundenNr : :String eShopKundenNr ) returns Ergebnis : String ) returns Ergebnis Rückgabestruktur Rückgabestruktur Ergebnis Ergebnis

Abbildung 46: Aufrufbeschreibung "loeschenKunde"

Die Methode „loeschenKunde“ erwartet, ähnlich der Methode anlegenKunde, die Mandantennummer und die Bewirtschafternummer. Anstelle des Kunden-Objektes reicht hier jedoch die eShopKundenNr aus, um den Kunden zu löschen. 5.4.3 Parameterbelegung Parameter

Erklärung

mandantNr

Ihre Mandantennummer

bewirtschafterNr

Ihre Bewirtschafternummer

eShopKundenNr

Die von Ihrer Fachanwendung vergebene Kundennummer

Tabelle 6: Parameterbelegung für "loeschenKunde"

5.5 Der Web-Service „abbuchenMitSepaMandatreferenz“ 5.5.1 Voraussetzungen 

Der Mandant existiert im System und ist aktiviert



Der Kunde existiert im System

72

5.5.2 Aufrufbeschreibung abbuchenMitSepamandatreferenz( mandantNr : String, eShopKundenNr : String, mandatReferenz : String, buchungsliste : BuchungsListe, pin : string ) returns BuchungsListeErgebnis

Rückgabestruktur BuchungsListeErgebnis

Abbildung 47: Aufrufbeschreibung "abbuchenMitSepamandatreferenz"

Die Methode „abbuchenMitSepamandatreferenz“ kann dazu verwendet werden, Buchungslisten über SEPA-Lastschrift auszugleichen. Dabei wird die vorhandene Mandatsreferenz des Kunden übergeben. Die PIN dient zur Authentifizierung des Kunden, falls die die Verwendung einer PIN für SEPA-Mandate an der ePayBL konfiguriert ist. 5.5.3 Parameterbelegung Parameter

Erklärung

mandantNr

Ihre Mandantennummer

eShopKundenNr

Kundennummer aus dem E-Shop-System.

mandatReferenz

Die Mandatreferenz des SEPA Mandats das für den Geschäftsfall benutzt werden soll.

buchungsliste

Buchungsliste zum Zahlungseinzug. Eine Buchungsliste beinhaltet im Kopf Informationen zum Zahlbetrag, Kassenzeichen und zur Fälligkeit. Die Buchungsliste setzt sich aus den Belegzeilen zum Zahlungseinzug zusammen.(Untergliederung des Zahlbetrages in Titel/Objekte)

pin

PIN, die zur Authentifizierung des Kunden und dessen SEPAMandat gegengeprüft wird.

Tabelle 7: Parameterbelegung für "abbuchenMitSepamandatreferenz"

5.6 Der Web-Service „anlegenSepaMandat“ 5.6.1 Voraussetzungen 

Der Mandant existiert im System und ist aktiviert



Der Kunde existiert im System 73

5.6.2 Aufrufbeschreibung anlegenSepaMandat( mandantNr : String, bewirtschafterNr: String, mandat: SepaMandat ) returns SepaMandatErgebnis

Rückgabestruktur SepaMandatErgebnis

Abbildung 48: Aufrufbeschreibung "anlegenSepaMandat"

5.6.3 Parameterbelegung Parameter

Erklärung

mandantNr

Ihre Mandantennummer

bewirtschafterNr

Feld beinhaltet die Nummer des Bewirtschafters.

mandat

Die Struktur SepaMandatErgebnis beinhaltet einerseits eine Ergebnisstruktur, die Auskunft über den Fehlerstatus des Methodenaufrufes gibt und andererseits eine SepaMandatstruktur

Tabelle 8: Parameterbelegung für "anlegenSepaMandat"

5.7 Der Web-Service „leseKassenzeichenInfo“ 5.7.1 Voraussetzungen 

Der Mandant existiert im System und ist aktiviert



Der Kunde existiert im System



Das Kassenzeichen existiert im System.

74

5.7.2 Aufrufbeschreibung leseKassenzeichenInfo( mandantNr : String, kassenzeichen : String, ) returns KassenzeichenInfoErgebnis

Rückgabestruktur KassenzeichenInfoErgebnis

Abbildung 49: Aufrufbeschreibung "loeschenKunde" ePayBL Paypage

Mit der Methode „lesenKassenzeichenInfo“ kann das Fachverfahren ermitteln, ob die Bezahlung über die Paypage erfolgreich verlaufen ist oder nicht. Im Fall eines Erfolges wird der Paypage-Status des Kassenzeichens auf „INAKTIV“ gesetzt. Ansonsten bleibt es auf „AKTIV“. 5.7.3 Parameterbelegung Parameter

Erklärung

mandantNr

Ihre Mandantennummer

kassenzeichen

das zu analysierende Kassnezeichen

Tabelle 9: Parameterbelegung für "leseKassenzeichenInfo"

75

Fragen und Antworten Frage

Antwort

Es ist unklar, ob beim Aufruf der Methode anlegenKassenzeichenMitZ ahlverfahrenliste() für die spätere Verwendung auf der zentralen Paypage der Parameter "zahlverfahren" angegeben werden muss. Ein String "PAYPAGE" anstatt "KREDITKARTE" oder "GIROPAY" findet sich in der Dokumentation nicht

Ein String "PAYPAGE" anstatt "KREDITKARTE" oder "GIROPAY" findet sich in der Dokumentation nicht. Die Methode anlegenKassenzeichenmitZahlverfahrenliste() erwartet beim Parameter ZahlverfahrenListe ein Stringarray die Werte „KREDITKARTE" und/oder "GIROPAY" oder null, wobei der Wert GIROPAY die Saferpay-Seiten via ProviderSet=631 auf Giropay einschränkt.

Welche Parameter existieren für die zentrale Paypage?

Bekannt sind , , , , , aus dem Dokument anbei.

Gibt es eine ausführliche Spezifikation?

Die Paypage-Parameter dienen nur zum Befüllen der Felder und zur Übergabe einer Mandantennummer, anhand der das Aussehen der Paypage bestimmt werden kann. Die Parameter sind 

Kassenzeichen



EShopKundenNr



EShopTransaktionsNr



EMailAdresse



accountId (für Saferpay)

Beispiel für URL mit Parametern: http://10.32.56.253:8090/paypage/login.do?kassenzeichen=123456789013&EShopKundenNr=TDG_ESHOP&EShopTransaktions Nr=678&EMailAdresse=abc.de&accountId=97137-94913954 Die Parameter sind dokumentiert in FSpec_PayPage_giropay_v1_1.doc Wenn Kassenzeichen und EShopKundennummer ausgefüllt sind, wird der Browser gleich zum Schritt Zahlverfahrenauswahl geleitet. Kann der zentralen Paypage ein URL als Parameter übergeben werden, auf den der Browser des Kunden nach Abschluss weiterleitet?

Eine URL zum Zurücklenken kann als Parameter nicht mitgegeben werden. Aber die Paypage ermittelt die aufrufende Seite (http-REFERER) und bietet ggf. auf der letzten Seite des Dialoges einen Link „Zurueck zur Ursprungsseite“. Mit diesem Link kann der Kunde zum WebShop zurück navigieren.

Wie kann der WebShop die erfolgreiche Bezahlung an der ePayBL erfragen?

Der Webshop kann erfragen, ob die Bezahlung des Kassenzeichens erfolgt ist. Wir empfehlen dazu die Methode lesenKassenzeichenInfo(). Hier sollte der WebShop prüfen, ob Saldo = 0 ist, er erfährt das benutzte Zahlverfahren und den paypageStatus (ist nach Paypage Bezahlung inaktiv)

76