| ... |
... |
@@ -1,10
+1,5 @@ |
| 1 |
1 |
{{content/}} |
| 2 |
2 |
|
| 3 |
|
-{{info}} |
| 4 |
|
-**Achtung:** |
| 5 |
|
-Bevor Sie die AKDB EPayment in ihren Formular-Prozessen einbinden, stellen Sie bitte sicher, dass die konfigurative Anbindung des Dienstes durch den Xima® Formcycle-Administrator erfolgt ist! |
| 6 |
|
-{{info/}} |
| 7 |
|
- |
| 8 |
8 |
Das AKDB EPayment Plugin ermöglicht es über die von der AKDB bereitgestellte Payment-Schnittstelle Bezahlvorgänge in einen Formularprozesse einzubauen. |
| 9 |
9 |
|
| 10 |
10 |
Der nachfolgende Artikel beschreibt beispielhaft die von einen Formular-Ersteller auszuführenden Schritte, um einen Bezahlvorgang in einem Formular einzubauen. |
| ... |
... |
@@ -90,8
+90,6 @@ |
| 90 |
90 |
; Eingaben pruefen vor Absenden |
| 91 |
91 |
: Wenn ausgewählt, wird das Formular vor dem Absenden validiert, sonst erfolgt keine Prüfung. |
| 92 |
92 |
|
| 93 |
|
-{{id name="config_process"/}} |
| 94 |
|
- |
| 95 |
95 |
== 2. Statusverarbeitung für EPayment konfigurieren == |
| 96 |
96 |
|
| 97 |
97 |
Um eine Bezahl-Transaktion in einen Formularprozess einzubauen werden die folgenden Aktions-Plugins zur Verfügung gestellt: |
| ... |
... |
@@ -167,13
+167,15 @@ |
| 167 |
167 |
|
| 168 |
168 |
{{panel title="Konfiguration für die PayPage" fullwidth="true" initial="hidden" triggerable="true"}} |
| 169 |
169 |
|
| 170 |
|
-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. |
| 171 |
|
- |
| 172 |
172 |
{{figure image="plugin_init_config_paypage.png"}} |
| 173 |
173 |
Konfiguration für die PayPage |
| 174 |
174 |
{{/figure}} |
| 175 |
175 |
|
|
167 |
+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. |
|
168 |
+((( |
| 176 |
176 |
|
|
170 |
+ |
|
171 |
+))) |
| 177 |
177 |
; URL zur PayPage (Pflichtfeld) |
| 178 |
178 |
: URL zur PayPage des EPayment-Systems. Die hier hinterlegte URL wird durch das ePay-BL-System vorgegeben und beinhaltete den Verweis auf die PayPage im ePay-BL-System. |
| 179 |
179 |
; Automatische Weiterleitung zur PayPage verhindern |
| ... |
... |
@@ -195,7
+195,7 @@ |
| 195 |
195 |
Konfiguration für die Kundenstammdaten |
| 196 |
196 |
{{/figure}} |
| 197 |
197 |
|
| 198 |
|
-In diesem Bereich werden die Daten des Benutzers hinterlegt, für den die Bezahl-Transaktion erzeugt werden soll. |
|
193 |
+In diesem Bereich werden die Daten des Benutzers, für den die Bezahl-Transaktion erzeugt werden soll, hinterlegt. |
| 199 |
199 |
Die einzelnen Parameter können per Platzhalter oder fest definiert hinterlegt werden. |
| 200 |
200 |
|
| 201 |
201 |
{{info}} |
| ... |
... |
@@ -224,14
+224,14 @@ |
| 224 |
224 |
{{/figure}} |
| 225 |
225 |
|
| 226 |
226 |
In diesem Bereich werden die bestellbaren Artikel definiert. |
| 227 |
|
-In dem Feld //Übermittelte Bestellung// wird der Wert per Platzhalter festgelegt, welcher zum Ausführungszeitpunkt die JSON-Struktur mit den im Formular bestellten Artikeln enthält. |
|
222 |
+Weiterhin wird im Feld //Übermittelte Bestellung//, per Platzhalter, der Wert festgelegt, welcher zum Ausführungszeitpunkt die JSON-Struktur mit den im Formular bestellten Artikeln enthält. |
| 228 |
228 |
|
| 229 |
229 |
|
| 230 |
230 |
{{info}} |
| 231 |
|
-Wenn das Formular über die Elemente **[[EPayment-Artikel>>doc:||anchor="epay_artikel"]]** und **[[EPayment Bestellen Button>>doc:||anchor="epay_btn"]]** verfügt kann über den jeweiligen Button [[image:icon_update.png]] eine Vorbefüllung der vorhandenen Pflichtfelder durchgeführt werden. |
|
226 |
+Wenn das Formular über die Elemente **EPayment-Artikel** und **EPayment Bestellen Button** verfügt kann über den jeweiligen Button [[image:icon_update.png]] eine Vorbefüllung der vorhandenen Pflichtfelder durchgeführt werden. |
| 232 |
232 |
{{/info}} |
| 233 |
233 |
|
| 234 |
|
-In der Tabelle //Bestellartikel-Definitionen// erfolgt die Definition der einzelnen Bestellartikel. Die hier konfigurierten Angaben sind maßgeblich für eine Übermittlung an den ePay-BL-Service. |
|
229 |
+In der Tabelle //Bestellartikel-Definitionen// erfolgt die Definition der einzelnen Bestell-Artikel. Die hier konfigurierten Angaben sind maßgeblich für eine Übermittlung an den ePay-BL-Service. |
| 235 |
235 |
Jeder Artikel muss über folgende Parameter verfügen: |
| 236 |
236 |
; Artikelnummer (Pflichtfeld) |
| 237 |
237 |
: Eine Nummer die den einzelnen Artikel innerhalb einer Bestellung eindeutig identifizierbar macht. |
| ... |
... |
@@ -244,7
+244,7 @@ |
| 244 |
244 |
|
| 245 |
245 |
|
| 246 |
246 |
{{info}} |
| 247 |
|
-**Achtung:** Um zur Laufzeit den Gesamtpreis einer Zahlungsanweisung zu errechnen, wird **immer** der Artikel-Preis aus der //Bestellartikel-Definitionen//-Tabelle entnommen. |
|
242 |
+__Hinweis:__ Um zur Laufzeit den Gesamtpreis einer Zahlungsanweisung zu errechnen, wird immer der Artikel-Preis aus der //Bestellartikel-Definitionen//-Tabelle entnommen. |
| 248 |
248 |
Einzig Artikelnummer und Bestellmenge werden aus den vom Browser übermittelten Daten zur Erstellung der Bezahl-Transaktion herangezogen. |
| 249 |
249 |
{{/info}} |
| 250 |
250 |
|
| ... |
... |
@@ -377,7
+377,7 @@ |
| 377 |
377 |
Konfiguration des Plugins //AKDB:EPayment verifizieren// |
| 378 |
378 |
{{/figure}} |
| 379 |
379 |
|
| 380 |
|
-Dieses Aktions-Plugin ist zum Auswerten des Status einer Bezahl-Transaktion zuständig. Im Standardfall muss innerhalb des Plugins keine weitere Konfiguration erfolgen, da alle notwendigen Parameter, für eine Prüfanfrage am ePay-BL-Service, intern hinterlegt sind. |
|
375 |
+Dieses Plugin ist zum Auswerten des Status einer Bezahl-Transaktion zuständig. Im Standardfall muss innerhalb des Plugins keine weitere Konfiguration erfolgen, da alle notwendigen Parameter, für eine Prüfanfrage am ePay-BL-Service, intern hinterlegt sind. |
| 381 |
381 |
Es besteht aber auch die Möglichkeit die //AKDB-Mandantennummer// und das //Kassenzeichen// durch eine Konfiguration zu übersteuern. Dies kann immer dann der Fall sein, wenn die Prüfung in einem anderem Formularvorgang erfolgen soll, in dem **nicht** die eigentliche Bezahl-Transaktion erzeugt wurde. |
| 382 |
382 |
|
| 383 |
383 |
|
| ... |
... |
@@ -424,16
+424,17 @@ |
| 424 |
424 |
== 3. Ergebnisanzeige == |
| 425 |
425 |
|
| 426 |
426 |
{{figure image="hilfe_statusverabeitung_bedingung.png"}} |
| 427 |
|
-Beispiel für die Konfiguration einer Bedingung, welche den aktuelle Status einer Bezahl-Transaktion beinhaltet. Die Bedingung im vorliegenden Beispiel wird positiv durchlaufen, wenn der Nutzer zuvor bezahlt hat. |
|
422 |
+Beispiel für die Konfiguration einer Bedingung, welche den aktuelle Status einer Bezahl-Transaktion beinhaltet. Die Bedingung im vorliegenden Beispiel wird positiv durchlaufen wenn der Nutzer zuvor bezahlt hat. |
| 428 |
428 |
{{/figure}} |
| 429 |
429 |
|
| 430 |
430 |
Für die Anzeige des Ergebnisses bzw. dem Status einer Bezahl-Transaktion bestehen mehrere Möglichkeiten. |
| 431 |
431 |
Man kann dem Nutzer dieses in einer extra dafür hinterlegten Abschluss-Seite oder durch die Wiederanzeige das Formulars anzeigen. |
| 432 |
|
-Ein Beispiel für die Ergebnisanzeige innerhalb des Formular ist unter dem Punkt //[[Statusverarbeitung für EPayment konfigurieren>>doc:||anchor="config_process"]]// aufgeführt. |
|
427 |
+Ein Beispiel für die Ergebnisanzeige innerhalb des Formular ist unter //Punkt 2// aufgeführt. |
| 433 |
433 |
|
| 434 |
|
-In den meisten Fällen ist es gewünscht, dass je nach Status der Bezahl-Transaktion unterscheidliche Rückmeldungstexte angezeigt oder zusätzliche Aktionen ausgeführt werden. |
|
429 |
+In den meisten Fällen ist es gewünscht, dass je nach Status der Bezahl-Transaktion unterscheidliche Rückmeldungstexte angezeigt oder |
|
430 |
+zusätzliche Aktionen ausgeführt, werden. |
| 435 |
435 |
|
| 436 |
|
-Erreichen kann man dies über eine entsprechende Bedingung an der jeweiligen Aktion. |
|
432 |
+Erreichen kann man dies über eine entsprechende Bedingung am Status oder der jeweiligen Aktion. |
| 437 |
437 |
|
| 438 |
438 |
|
| 439 |
439 |
== Weiterführende Informationen == |
| ... |
... |
@@ -440,5
+440,5 @@ |
| 440 |
440 |
|
| 441 |
441 |
=== Aktions-Plugin //AKDB:EPayment PayPageURL bereitstellen// === |
| 442 |
442 |
|
| 443 |
|
-Durch dieses Aktions-Plugin kann die aktuell gültige URL zur Bezahl-Transaktion ins ePay-BL-Portal aus dem Formular-Vorgang ermittet werden. |
| 444 |
|
-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. |
|
439 |
+Durch dieses Plugin kann die aktuell gültige URL zur Bezahl-Transaktion ins ePay-BL-Portal aus dem Formular-Vorgang ermittet werden. |
|
440 |
+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 Plugins **AKDB:EPayment initialisieren** konfiguriert sein. |