| ... |
... |
@@ -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 seines Bezahlvorgangs 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 |
|
| ... |
... |
@@ -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// |
| ... |
... |
@@ -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. |