Änderungen von Dokument ePayBL Setup


Von Version 28.1
bearbeitet von fse
am 21.03.2023, 09:45
Änderungskommentar: Es gibt keinen Kommentar für diese Version
Auf Version 37.2
bearbeitet von gru
am 04.09.2023, 11:01
Änderungskommentar: Hinweis auf URL an anderer Stelle ergänzt

Zusammenfassung

Details

Seiteneigenschaften
Dokument-Autor
... ... @@ -1,1 +1,1 @@
1 -XWiki.fse
1 +XWiki.gru
Inhalt
... ... @@ -20,23 +20,6 @@
20 20  
21 21  Falls Sie bereits das [[**AKDB: EPayment-Plugin** >>url:https://help.formcycle.de/xwiki/bin/view/Formcycle/PluginDocumentation/AkdbEPaymentPlugin/]] in Ihren Mandanten installiert haben, können Sie wie folgt vorgehen:
22 22  
23 -1. Gehen Sie in den Menüpunkt //AKDB ePay Setup//
24 -1. Notieren Sie sich Ihre bisherigen Angaben
25 -1.1 Mandant-Nummer
26 -1.2 Bewirtschafter-Nummer
27 -1.3 Haushaltsstelle
28 -1.4 Objektnummer
29 -1.5 Kennzeichen-Manverfahren
30 -1.6 Proxy (falls vorhanden)
31 -1. Ermitteln Sie die URL Ihres ePayBL Providers
32 -1. Stellen Sie Zertifikat und Zertifikatspasswort sicher
33 -1. Ermitteln Sie die erlaubten Zahlverfahren Ihres ePayBL Providers
34 -1. Deaktivieren Sie das //AKDB: EPayment-Plugin// in Ihrem Mandanten
35 -1. Loggen Sie sich als Systemadministrator an
36 -1. Hinterlegen Sie das //ePayBL: EPayment-Plugin// in den System-Plugins
37 -1. Gehen Sie in den neuen Menüpunkt //ePayBL Setup//
38 -1. Hinterlegen Sie Ihre notierten Angaben, nähere Informationen sind in den folgenden Abschnitten hinterlegt.
39 -
40 40  === Vorbereitung ===
41 41  
42 42  Um die neue ePayBL Schnittstelle anzubinden, benötigen Sie ein Zertifikat von der AKDB. Wenn Sie es für die Produktivumgebung noch nicht haben, wenden Sie sich an Ihren Ansprechpartner bei der AKDB.
... ... @@ -44,33 +44,33 @@
44 44  === Migration ===
45 45  
46 46  1. Datensicherung
47 -1.1 Gehen Sie im FORMCYCLE Hauptmenü auf **AKDB ePay Setup**.
30 +1.1 Gehen Sie im {{formcycle/}} Hauptmenü auf **AKDB ePay Setup**.
48 48  1.2 Klicken Sie auf **Zur Anbindung ePay-BL Umgebung**.
49 49  1.3 Notieren Sie die Informationen für Mandant-Nummer, Bewirtschafter-Nummer, Haushaltsstelle, Objektnummer, Kennzeichen-Mahnverfahren, Fälligkeitszeitraum (in Tagen) und Buchungstext für die PayPage.
50 50  1. Bestimmen der URL Ihres ePayBL Providers
51 -2.1 Wenn unter "Anzubindende Umgebung" der Wert "TEST" ausgewählt ist, verwenden Sie in Zukunft die Adresse "xxxxxxxxxxxxxxxx" zur Anbindung.
52 -2.2 Wenn unter "Anzubindende Umgebung" der Wert "LIVE" ausgewählt ist, verwenden Sie in Zukunft die Adresse "xxxxxxxxxxxxxxxx" zur Anbindung.
34 +2.1 Wenn unter "Anzubindende Umgebung" der Wert "TEST" ausgewählt ist, verwenden Sie in Zukunft die Adresse "https://infra-pre.buergerserviceportal.de" oder "https://epay-pre.akdb.de" zur Anbindung. Welche Umgebung in Ihrem Fall greift können Sie bei der AKDB nachfragen.
35 +2.2 Wenn unter "Anzubindende Umgebung" der Wert "LIVE" ausgewählt ist, verwenden Sie in Zukunft die Adresse "https://epay.akdb.de" zur Anbindung.
53 53  1. Deaktivieren des AKDB: EPayment-Plugin
54 -3.1 Gehen Sie im FORMCYCLE Hauptmenü auf "Mandant" -> "Plugin".
37 +3.1 Gehen Sie im {{formcycle/}} Hauptmenü auf "Mandant" -> "Plugin".
55 55  3.2 Fahren Sie mit der Maus über den Eintrag //plugin-bundle-akdb-epayment.jar//. Es erscheint das Symbol zum Deaktivieren des Plugins.
56 56  3.3 Klicken Sie auf das Symbol, um das Plugin zu deaktivieren.
57 57  3.4 Das Plugin wird nun durchgestrichen dargestellt.
58 58  1. Löschen der Datei //epay_wf_result.js//
59 -4.1 Gehen Sie im FORMCYCLE Hauptmenü auf "Dateien & Templates" -> "Dateien".
42 +4.1 Gehen Sie im {{formcycle/}} Hauptmenü auf "Dateien & Templates" -> "Dateien".
60 60  4.2 Wählen Sie den Eintrag //epay_wf_result.js// aus indem Sie das Kästchen links davon anhaken.
61 61  4.3 Klicken Sie auf das löschen Symbolüberhalb der Auflistung.
62 -1. Installation des //plugin-bundle-epaybl.jar
63 -5.1 Melden Sie sich als Systemadministrator (sadmin) am FORMCYCLE Backend an.
64 -5.2 Gehen Sie im FORMCYCLE Hauptmenü auf "System" -> "Systemplugins".
65 -5.3 Klicken Sie auf den Plus-Button, um die Datei //plugin-bundle-epaybl.jar// hinzuzufügen.//
45 +1. Installation des //plugin-bundle-epaybl.jar//
46 +5.1 Melden Sie sich als Systemadministrator (sadmin) am {{formcycle/}} Backend an.
47 +5.2 Gehen Sie im {{formcycle/}} Hauptmenü auf "System" -> "Systemplugins".
48 +5.3 Klicken Sie auf den Plus-Button, um die Datei //plugin-bundle-epaybl.jar// hinzuzufügen.
66 66  1. Einrichten mit ePayBL Setup
67 -6.1 Im FORMCYCLE Hauptmenü steht Ihnen nun ein neuer Punkt **ePayBL Setup** zur Verfügung.
50 +6.1 Im {{formcycle/}} Hauptmenü steht Ihnen nun ein neuer Punkt **ePayBL Setup** zur Verfügung. Eventuell müssen Sie sich erneut anmelden um diesen zu sehen.
68 68  6.2 Klicken Sie auf dem Menüpunk **ePayBL Setup**
69 69  6.3 Tragen Sie die URL aus Schritt 2 ein.
70 70  6.4 Geben Sie nun die Informationen für Mandant-Nummer, Bewirtschafter-Nummer, Haushaltsstelle, Objektnummer, Kennzeichen-Mahnverfahren, Fälligkeitszeitraum (in Tagen) und Buchungstext für die PayPage ein, die für alle Mandanten gelten sollen.
71 71  6.5 Laden Sie das Zertifikat hoch, das Sie von der AKDB erhalten haben, und geben Sie das dazugehörige Passwort ein.
72 72  6.6 Klicken Sie auf „Speichern“.
73 -6.7 Alle Angaben, die Sie als Systemadministrator in den Systemeinstellungen hinterlegen, sind optional und sind als Standardeinstellungen, die für alle Mandanten in Ihrer FORMCYCLE Umgebung gelten zu verstehen.
56 +6.7 Alle Angaben, die Sie als Systemadministrator in den Systemeinstellungen hinterlegen, sind optional und sind als Standardeinstellungen, die für alle Mandanten in Ihrer {{formcycle/}} Umgebung gelten zu verstehen.
74 74  6.8 Informationen, die nicht durch den Systemadministrator hinterlegt wurden, werden im Mandanten als Pflichtangabe angezeigt und müssen später dort angegeben werden.
75 75  1. Vervollständigung des Setups im Mandanten
76 76  7.1 Melden Sie sich beim Mandanten an, in dem Sie zuvor das AKDB: EPayment-Plugin deaktiviert haben.
... ... @@ -100,7 +100,7 @@
100 100  
101 101  === Obligatorische Installationsschritte ===
102 102  
103 -* Anmeldung als **sadmin **am FORMCYCLE-System.
86 +* Anmeldung als **sadmin **am {{formcycle/}}-System.
104 104  * Registrierung des **//plugin-bundle-epaybl.jar//** Plugins im Bereich der System-Plugins.
105 105  
106 106  === Fakultative Installationsschritte ===
... ... @@ -153,7 +153,8 @@
153 153  Falls bereits eine Eingabe durch den {{formcycle/}} Systemadministrator getätigt wurde, ist das Eingabefeld für den Mandanten kein Pflichtfeld mehr und der Default-Wert wird als Platzhalter angezeigt. Jeder Mandant kann die Default-Werte überschreiben, indem das entsprechende Eingabefeld ausgefüllt wird.
154 154  
155 155  ; URL des Providers
156 -: Die URL der anzubindenen Umgebung. Default-Wert wird als Platzhalter angezeigt.
139 +: Die URL der anzubindenen Umgebung. Der Default-Wert wird als Platzhalter angezeigt.
140 +: Für die Anbindung ePayBL-Systeme der AKDB muss hier _https://infra-pre.buergerserviceportal.de_ für das Testsytem und _https://epay.akdb.de_ für das Livesystem eingetragen werden.
157 157  ; Mandant-Nummer
158 158  : Die Mandant-Nummer ist den ePayBL Vertragsdaten zu entnehmen. Default-Wert wird als Platzhalter angezeigt.
159 159  ; Bewirtschafter-Nummer
... ... @@ -178,3 +178,16 @@
178 178  : Default-Wert wird als Platzhalter angezeigt.
179 179  ; Port
180 180  : Der Port zum Proxy-Host. Default-Wert wird als Platzhalter angezeigt.
165 +
166 +=== Zahlverfahren ===
167 +
168 +In {{formcycle/}} müssen die verfügbaren Zahlverfahren ausgewählt werden, welche von Ihrem ePayBL-System unterstützt werden. Aktuell werden folgende Zahlverfahren unterstützt:
169 +
170 +; Giropay
171 +; Kreditkarte
172 +; PayPal
173 +; PayDirekt
174 +; Überweisung
175 +; Lastschrift ohne Einzugsermächtigung
176 +
177 +Sobald in {{formcycle/}} Zahlverfahren angegeben werden, welche nicht im ePayBL-System erlaubt sind, kommt eine Fehlermeldung. Sie können die Zahlverfahren auf ein Minimum von einem Zahlverfahren eingrenzen.