Von Version < 24.29 >
bearbeitet von rth
am 12.03.2020, 13:14
Auf Version < 24.34 >
bearbeitet von rth
am 12.03.2020, 13:36
< >
Änderungskommentar: Es gibt keinen Kommentar für diese Version

Zusammenfassung

Details

Seiteneigenschaften
Inhalt
... ... @@ -23,7 +23,7 @@
23 23  
24 24  {{id name="epay_artikel"/}}
25 25  
26 -=== Artikel definieren durch das Formular-Element: //EPayment Artikel//: ===
26 +=== 1.1. Artikel definieren durch das Formular-Element: //EPayment Artikel//: ===
27 27  
28 28  {{figure image="hilfe_epay_artikel_form.png"}}
29 29  Konfigurationsmöglichkeiten am Formular-Element //EPayment Artikel//
... ... @@ -55,7 +55,7 @@
55 55  
56 56  {{id name="epay_vorlage"/}}
57 57  
58 -=== Vorlagen zur Ermittlung von Bestellinformationen: ===
58 +=== 1.2. Vorlagen zur Ermittlung von Bestellinformationen: ===
59 59  
60 60  {{figure image="hilfe_epay_vorlagen_form.png"}}
61 61  Vorlagen zur Datenerhebung für das EPayment
... ... @@ -74,7 +74,7 @@
74 74  
75 75  {{id name="epay_btn"/}}
76 76  
77 -=== Bestellprozess starten mittels Formular-Element //EPayment Bestellen Button//: ===
77 +=== 1.3. Bestellprozess starten mittels Formular-Element //EPayment Bestellen Button//: ===
78 78  
79 79  {{figure image="hilfe_epay_button_form.png"}}
80 80  Konfigurationsmöglichkeiten am Formular-Element //EPayment Bestellen Button//
... ... @@ -96,8 +96,8 @@
96 96  
97 97  Um eine Bezahl-Transaktion in einen Formularprozess einzubauen werden die folgenden Aktions-Plugins zur Verfügung gestellt:
98 98  
99 -* **AKDB:EPayment initialisieren**: Dieses erzeugt eine neue Bezahl-Transaktion auf Seiten der AKDB und leitet den Benutzer auf dessen Portalseite weiter.
100 -* **AKDB:EPayment verifizieren**: Prüft den aktuellen Status einer Bezahl-Transaktion
99 +* **[[AKDB:EPayment initialisieren>>doc:||anchor="plugin_epay_init"]]**: Dieses erzeugt eine neue Bezahl-Transaktion auf Seiten der AKDB und leitet den Benutzer auf dessen Portalseite weiter.
100 +* **[[AKDB:EPayment verifizieren>>doc:||anchor="plugin_epay_verify"]]**: Prüft den aktuellen Status einer Bezahl-Transaktion
101 101  
102 102  Ein Statusverarbeitung für einen einfachen Fall kann folgendermaßen konfiguriert sein:
103 103  
... ... @@ -105,14 +105,14 @@
105 105  |(% style="border-style:none; width:180px" %)[[image:hilfe_statusverabeitung.png||alt="Statusverarbeitung mit Anbindung EPayment"]]|(% style="border-style:none; width:700px" %)(((
106 106  __Kurze Ablaufbeschreibung zur dargestellten Statusverarbeitung:__
107 107  
108 -~1. Nach dem Absenden des Bestellformulars wird in den Status //Eingegangen// gewechselt und dort das Aktions-Plugin **[[AKDB:EPayment initialisieren>>doc:||anchor="plugin_epay_init"]]** ausgeführt. Dieses ermittelt die für den Bestellvorgang notwendigen Daten aus dem Formular und startet mit diesen eine Bezahl-Transaktion auf Seiten der AKDB. Wenn dies erfolgreich war, wird der Benutzer zum [[ePay-BL>>https://www.epaybl.de/||rel="noopener noreferrer" target="_blank" title="E-Payment Bund und Länder"]] Portal der AKDB, unter vorheriger [[Angabe eines Rücksprung-Ziels>>doc:||anchor="config_paypage"]], weitergeleitet.
108 +~1. Nach dem Absenden des Bestellformulars wird in den Status //Eingegangen// gewechselt und dort das Aktions-Plugin **[[AKDB:EPayment initialisieren>>doc:||anchor="plugin_epay_init"]]** ausgeführt. Dieses ermittelt die für den Bestellvorgang notwendigen Daten aus dem Formular und startet mit diesen eine Bezahl-Transaktion auf Seiten der AKDB. Wenn dies erfolgreich war, wird der Benutzer zum [[ePay-BL>>https://www.epaybl.de/||rel="noopener noreferrer" target="_blank" title="E-Payment Bund und Länder"]] Portal der AKDB, unter vorheriger [[Angabe eines Rücksprung-Ziels>>doc:||anchor="config_paypage"]] (Realisiert über Festlegung eines Ziel-Status), weitergeleitet.
109 109  
110 -2. Nach Abschluss des Bezahlvorgangs auf im ePay-BL Portal wird der Benutzer wieder zum {{formcycle/}}-Formular zurückgeleitet. Dies erfolgt unter Benutzung des angegebenen Rücksprung-Ziels.
110 +2. Nach Abschluss des Bezahlvorgangs im ePay-BL Portal wird der Benutzer wieder zum {{formcycle/}}-Formular zurückgeleitet. Dies erfolgt unter Benutzung des angegebenen Rücksprung-Ziels.
111 111  Aus einer im Vorfeld festgelegten Konfiguration im **[[AKDB:EPayment initialisieren>>doc:||anchor="plugin_epay_init"]]** Aktions-Plugin wird der Ziel-Status nach Rückkehr aus dem ePay-BL Portal ermittelt. Im vorliegenden Beispiel wird deshalb in den Status //Zahlung pruefen// gewechselt.
112 112  
113 113  3. Die Statusverarbeitung //Zahlung pruefen// wird ausgeführt und dort das Aktions-Plugin **[[AKDB:EPayment verifizieren>>doc:||anchor="plugin_epay_verify"]]** durchlaufen. Unter Zuhilfenahme dieses Plugins wird der aktuelle Status der Bezahlung am EPayment-System geprüft und in der weiteren Statusverarbeitung (per Platzhalter) zur Verfügung gestellt.
114 114  
115 -4. Im Falle einer positiven Verifizierung des Bezahlvorgangs wird unter Zuhilfenahme der Aktion [[**Statusänderung**>>doc:Formcycle.UserInterface.MyForms.WorkflowProcessing.Actions.ChangeState]] in den Status //Bezahlt //gewechselt. Innerhalb von diesem Status ist eine [[**Weiterleitungs**>>doc:Formcycle.UserInterface.MyForms.WorkflowProcessing.Actions.Redirect]]-Aktion zum aktuellen Formular konfiguriert, sodass dieses dem Benutzer wieder angezeigt wird. Innerhalb dieses Formulares kann dann ein Text-Element konfiguriert werden, welches nur im Status //Bezahlt// angezeigt wird und dem Benutzer eine positive Rückmeldung zum Ausgang seinen Bezahlvorgangs anzeigt.
115 +4. Im Falle einer positiven Verifizierung des Bezahlvorgangs wird unter Zuhilfenahme der Aktion [[**Statusänderung**>>doc:Formcycle.UserInterface.MyForms.WorkflowProcessing.Actions.ChangeState]] in den Status //Bezahlt //gewechselt. Innerhalb von diesem Status ist eine [[**Weiterleitungs**>>doc:Formcycle.UserInterface.MyForms.WorkflowProcessing.Actions.Redirect]]-Aktion zum aktuellen Formular konfiguriert, sodass dieses dem Benutzer wieder angezeigt wird. Innerhalb dieses Formulares kann dann ein Text-Element konfiguriert werden, welches nur im Status //Bezahlt// angezeigt wird und dem Benutzer eine positive Rückmeldung zum Ausgang seineBezahlvorgangs anzeigt.
116 116  
117 117  __Hinweis:__ Anstatt einer Rückleitung ins Formular kann im Status //Bezahlt// auch eine individuelle Abschluss-Seite konfiguriert sein. Dann würde diese dem Nutzer angezeigt werden.
118 118  
... ... @@ -123,7 +123,7 @@
123 123  
124 124  {{id name="plugin_epay_init"/}}
125 125  
126 -=== Konfigurationsmöglichkeiten des Aktions-Plugins //AKDB:EPayment initialisieren// ===
126 +=== 2.1. Konfigurationsmöglichkeiten des Aktions-Plugins //AKDB:EPayment initialisieren// ===
127 127  
128 128  Dieses Aktions-Plugin ist für das Erzeugen einer Bezahl-Transaktion im [[ePay-BL>>https://www.epaybl.de/||rel="noopener noreferrer" target="_blank" title="E-Payment Bund und Länder"]] Portal zuständig. Hier werden im Vorfeld die Daten, welche im Zusammenhang mit der Transaktion stehen (bestellte Artikel, Preisbestimmung, persönliche Daten des Käufers, Rechnungsadresse etc.), festgelegt. Weiterhin erfolgt die Festlegung in welchen Status, nach Rückkehr aus dem ePay-BL Portal, gewechselt werden soll.
129 129  
... ... @@ -137,7 +137,7 @@
137 137  
138 138  Die Konfigurationsoberfläche des Aktions-Plugins ist in einzelne Bereiche unterteilt die nachfolgend kurz beschrieben werden.
139 139  
140 -{{panel title="Konfiguration AKDB EPayment-Mandant" fullwidth="true" initial="hidden" triggerable="true"}}
140 +{{panel title="Konfiguration AKDB EPayment-Mandant" fullwidth="true" initial="visible" triggerable="true"}}
141 141  
142 142  {{figure image="plugin_init_config_akdb_mandant.png"}}
143 143  Konfiguration AKDB EPayment-Mandant
... ... @@ -169,7 +169,7 @@
169 169  
170 170  {{id name="config_paypage"/}}
171 171  
172 -{{panel title="Konfiguration für die PayPage" fullwidth="true" initial="hidden" triggerable="true"}}
172 +{{panel title="Konfiguration für die PayPage" fullwidth="true" initial="visible" triggerable="true"}}
173 173  
174 174  Bei der "PayPage" handelt es sich dabei um eine bereits ausgefüllte Bezahlseite zur Online-Bezahlung der vom Gläubiger, für die jeweils erbrachten Leistungen, veranschlagten Gebühren, Entgelte etc.
175 175  
... ... @@ -193,7 +193,7 @@
193 193  die Einstellung für den **Fälligkeitszeitraum** wird nicht beachtet.
194 194  {{/panel}}
195 195  
196 -{{panel title="Kundenstammdaten" fullwidth="true" initial="hidden" triggerable="true"}}
196 +{{panel title="Kundenstammdaten" fullwidth="true" initial="visible" triggerable="true"}}
197 197  
198 198  {{figure image="plugin_init_config_kundenstammdaten.png"}}
199 199  Konfiguration für die Kundenstammdaten
... ... @@ -222,7 +222,7 @@
222 222  
223 223  {{id name="config_artikel"/}}
224 224  
225 -{{panel title="Bestellinformationen" fullwidth="true" initial="hidden" triggerable="true"}}
225 +{{panel title="Bestellinformationen" fullwidth="true" initial="visible" triggerable="true"}}
226 226  {{figure image="plugin_init_config_artikel.png"}}
227 227  Konfiguration der Bestellinformationen
228 228  {{/figure}}
... ... @@ -255,7 +255,7 @@
255 255  
256 256  {{/panel}}
257 257  
258 -{{panel title="Konfiguration Rechnungsadresse (optional)" fullwidth="true" initial="hidden" triggerable="true"}}
258 +{{panel title="Konfiguration Rechnungsadresse (optional)" fullwidth="true" initial="visible" triggerable="true"}}
259 259  
260 260  {{figure image="plugin_init_config_rechadr.png"}}
261 261  Konfiguration der Rechnungsadresse
... ... @@ -283,7 +283,7 @@
283 283  
284 284  {{/panel}}
285 285  
286 -{{panel title="Konfiguration Lieferadresse (optional)" fullwidth="true" initial="hidden" triggerable="true"}}
286 +{{panel title="Konfiguration Lieferadresse (optional)" fullwidth="true" initial="visible" triggerable="true"}}
287 287  
288 288  {{figure image="plugin_init_config_lieferadr.png"}}
289 289  Konfiguration der Lieferadressdaten
... ... @@ -315,7 +315,7 @@
315 315  
316 316  {{/panel}}
317 317  
318 -{{panel title="Konfiguration für die Bankverbindung (optional)" fullwidth="true" initial="hidden" triggerable="true"}}
318 +{{panel title="Konfiguration für die Bankverbindung (optional)" fullwidth="true" initial="visible" triggerable="true"}}
319 319  
320 320  {{figure image="plugin_init_config_bank.png"}}
321 321  Konfiguration für die Bankverbindung
... ... @@ -342,7 +342,7 @@
342 342  
343 343  {{/panel}}
344 344  
345 -{{panel title="Allgemeine Rückgabeparameter" fullwidth="true" initial="hidden" triggerable="true"}}
345 +{{panel title="Allgemeine Rückgabeparameter" fullwidth="true" initial="visible" triggerable="true"}}
346 346  
347 347  {{figure image="plugin_init_config_result.png"}}
348 348  Konfiguration der Plugin Rückgabedaten (Platzhalter)
... ... @@ -377,7 +377,7 @@
377 377  
378 378  {{id name="plugin_epay_verify"/}}
379 379  
380 -=== Konfigurationsmöglichkeiten des Aktions-Plugins //AKDB:EPayment verifizieren// ===
380 +=== 2.2. Konfigurationsmöglichkeiten des Aktions-Plugins //AKDB:EPayment verifizieren// ===
381 381  
382 382  {{figure image="plugin_verify.png"}}
383 383  Konfiguration des Plugins //AKDB:EPayment verifizieren//
... ... @@ -388,7 +388,7 @@
388 388  
389 389  
390 390  
391 -{{panel title="Allgemeine Rückgabeparameter" fullwidth="true" initial="hidden" triggerable="true"}}
391 +{{panel title="Allgemeine Rückgabeparameter" fullwidth="true" initial="visible" triggerable="true"}}
392 392  
393 393  
394 394  In diesem Bereich werden die vom Plugin als Ergebnis der Status-Prüfung am ePay-BL-Service zurückgelieferten Parameter aufgeführt.
... ... @@ -447,4 +447,4 @@
447 447  === Aktions-Plugin //AKDB:EPayment PayPageURL bereitstellen// ===
448 448  
449 449  Durch dieses Aktions-Plugin kann die aktuell gültige URL zur Bezahl-Transaktion ins ePay-BL-Portal aus dem Formular-Vorgang ermittet werden. 
450 -Dadurch besteht die Möglichkeit eine noch nicht abgeschlossene Bezahl-Transaktion nochmals zur Anzeige zu bringen und die Zahlung durchzuführen. Dieses Aktions-Plugin muss dabei im zeitlichen Ablauf nach dem Plugin **AKDB:EPayment initialisieren** konfiguriert sein.
450 +Dadurch besteht die Möglichkeit eine noch nicht abgeschlossene Bezahl-Transaktion nochmals zur Anzeige zu bringen und die Zahlung durchzuführen. Dieses Aktions-Plugin muss dabei im zeitlichen Ablauf nach dem Plugin **[[AKDB:EPayment initialisieren>>doc:||anchor="plugin_epay_init"]]** konfiguriert sein.
Copyright 2000-2025