... |
... |
@@ -93,9 +93,6 @@ |
93 |
93 |
* Workflow-Aktion **[[Bestellung übermitteln>>doc:||anchor="plugin_epay_init"]]**: Diese erzeugt eine neue Bezahl-Transaktion auf Seiten der AKDB und leitet den Benutzer auf dessen Portalseite weiter. |
94 |
94 |
* Workflow-Ereignis **[[Bezahlung erfolgreich>>doc:||anchor="plugin_event_epay_success"]]**: Verarbeitet ein Ereignis, welches auf der Rückmeldung über eine erfolgreiche Bezahlung auf dem ePay-BL Portal basiert. |
95 |
95 |
* Workflow-Ereignis **[[Bezahlung nicht erfolgreich>>doc:||anchor="plugin_event_epay_error"]]**: Verarbeitet ein Ereignis, welches auf der Rückmeldung über eine noch offene Bezahlung auf dem ePay-BL Portal basiert. Dabei kann dies verschiedene Ursachen haben. Zum einen kann die Bezahlvorgang durch den Nutzer abgebrochen worden sein oder es ist zu einem Fehler im ePay-BL Portal gekommen. |
96 |
|
-* HTML-Template **AKDB ePayment Bezahlung Erfolg**: Standard-Template für Anzeige bei erfolgreich abgeschlossener Bezahlung. |
97 |
|
-* HTML-Template **AKDB ePayment Bezahlung Fehler**: Standard-Template für Anzeige bei offenen bzw. fehlerhaft beendeten Bezahlvorgang |
98 |
|
-* HTML-Template **AKDB ePayment Fehler**: Standard-Template für Anzeige bei allgemeinen technischen Fehlern |
99 |
99 |
|
100 |
100 |
Ein Workflow für einen einfachen Fall kann folgendermaßen konfiguriert sein: |
101 |
101 |
|
... |
... |
@@ -201,3 +201,53 @@ |
201 |
201 |
|
202 |
202 |
{{/panel}} |
203 |
203 |
|
|
201 |
+{{id name="plugin_event_epay_success"/}} |
|
202 |
+ |
|
203 |
+=== 2.2. Workflow-Ereignis //Bezahlung erfolgreich// === |
|
204 |
+ |
|
205 |
+Eine Workflow-Verarbeitungskette mit diesem Ereignis wird ausgeführt, wenn eine Rückleitung aus dem ePay-BL Portal erfolgt |
|
206 |
+und die Bezahlung erfolgreich durchgeführt wurde. Pro Formular-Vorgang kann dieses Ereignis genau einmal eintreten. |
|
207 |
+Das Ereignis stellt dabei folgende Werte bereit, die per Platzhalter in nachfolgenden Aktionen ausgewertet werden können: |
|
208 |
+ |
|
209 |
+; **[%$TRIGGER.paymentStatus%]** |
|
210 |
+: Bezeichnung des Status, wie er vom ePay-BL Portal zurückgeliefert wird. (Möglicher Wert: INAKTIV) |
|
211 |
+; **[%$TRIGGER.paymentStatusText%]** |
|
212 |
+: Eine Nachricht, die den zurückgelieferten Status näher beschreibt |
|
213 |
+ |
|
214 |
+{{id name="plugin_event_epay_error"/}} |
|
215 |
+ |
|
216 |
+=== 2.3. Workflow-Ereignis //Bezahlung nicht erfolgreich// === |
|
217 |
+ |
|
218 |
+Eine Workflow-Verarbeitungskette mit diesem Ereignis wird immer dann ausgeführt, wenn eine Rückleitung aus dem ePay-BL Portal erfolgte |
|
219 |
+und die Bezahlung nicht durchgeführt wurde. Pro Formular-Vorgang kann dieses Ereignis mehrfach eintreten (Bei Fehlern im ePay-BL Portal oder bei Abbruch des Bezahlvorgangs durch den Nutzer). |
|
220 |
+Das Ereignis stellt folgende Werte bereit, die per Platzhalter in nachfolgenden Aktionen ausgewertet werden können: |
|
221 |
+ |
|
222 |
+; **[%$TRIGGER.paymentStatus%]** |
|
223 |
+: Bezeichnung des Status, wie er vom ePay-BL Portal zurückgeliefert wird. |
|
224 |
+: Folgende Werte sind möglich: |
|
225 |
+: **AKTIV**: Die Bezahlung über die PayPage ist noch nicht erfolgt. |
|
226 |
+: **MANDANT_NICHT_GEFUNDEN**: Der Mandant wurde im ePayment-System nicht gefunden. |
|
227 |
+: **MANDANT_INAKTIV**: Der Mandant ist im ePayment-System derzeit als inaktiv gekennzeichnet. |
|
228 |
+: **VERBINDUNG_OHNE_HTTPS**: Die Verbindung zum Webservice erfolgte nicht über HTTPS mit Client-Zertifikaten. |
|
229 |
+: **VERBINDUNG_ZERTIFIKAT_FEHLER**: Das für die Verbindung verwendete Client-Zertifikat darf nicht für den gewählten Mandanten verwendet werden. |
|
230 |
+: **KASSENZEICHEN_NICHT_VORHANDEN**: Das gewählte Kassenzeichen ist nicht vorhanden. |
|
231 |
+: **KASSENZEICHEN_NICHT_GEFUNDEN**: Das gewählte Kassenzeichen konnte nicht gefunden werden. |
|
232 |
+: **INTERNER_EPAYMENT_FEHLER**: Interner nicht dokumentierter Fehler im ePayment-System. |
|
233 |
+: **UNDEFINIERT**: Ein im System nicht bekannter Status |
|
234 |
+; **[%$TRIGGER.paymentStatusText%]** |
|
235 |
+: Eine Nachricht, die den zurückgelieferten Status näher beschreibt |
|
236 |
+; **[%$TRIGGER.paypageUrl%]** |
|
237 |
+: URL zur Paypage mit der aktuellen Transaktionsnummer. Damit ist ein nochmaliges Aufrufen und Bezahlen der offenen Transaktion möglich. |
|
238 |
+ |
|
239 |
+== 3. Ergebnisanzeige == |
|
240 |
+ |
|
241 |
+Die Anzeige des Ergebnisses bzw. des Status einer Bezahl-Transaktion erfolgt standardmäßig mittels einer extra Abschluss-Seite. |
|
242 |
+Dafür stellt das Plugin 3 HTML-Templates bereit: |
|
243 |
+ |
|
244 |
+* **AKDB ePayment Bezahlung Erfolg**: Standard-Template für Anzeige bei erfolgreich abgeschlossener Bezahlung. |
|
245 |
+* **AKDB ePayment Bezahlung Fehler**: Standard-Template für Anzeige bei offenen bzw. fehlerhaft beendeten Bezahlvorgang. Dieser Template enthält Platzhalter für Anzeige des konkreten Fehlers und einen Link zum Wiederaufruf des noch ausstehenden Bezahlvorgangs. |
|
246 |
+* **AKDB ePayment Fehler**: Standard-Template für Anzeige bei allgemeinen technischen Fehlern. Der genaue Fehler wird mittels enthaltener Platzhalter ausgewiesen. |
|
247 |
+ |
|
248 |
+{{info}} |
|
249 |
+Die durch das Plugin bereitgestellten HTML-Templates können bearbeitet werden. Änderungen haben dab |
|
250 |
+{{/info}} |