| ... |
... |
@@ -93,6 +93,9 @@ |
| 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 |
| 96 |
96 |
|
| 97 |
97 |
Ein Workflow für einen einfachen Fall kann folgendermaßen konfiguriert sein: |
| 98 |
98 |
|
| ... |
... |
@@ -157,89 +157,55 @@ |
| 157 |
157 |
|
| 158 |
158 |
{{panel title="Konfiguration für die PayPage" fullwidth="true" initial="visible" triggerable="true"}} |
| 159 |
159 |
|
| 160 |
|
-Bei der "PayPage" handelt es sich um eine bereits vorbefüllte Bezahlseite zur Online-Bezahlung. Der Nutzer hat hier noch die Auswahl, mit welchem Bezahl-Dienstleister er bezahlen möchte (Paypal, SEPA-Lastschrift, giropay etc.). Die Art und Anzahl der dem Nutzer zur Auswahl stehenden Bezahl-Dienstleister hängt dabei davon ab, was im Vorfeld vertraglich mit der AKDB verbart wurde. |
|
163 |
+Bei der "PayPage" handelt es sich um eine bereits vorbefüllte Bezahlseite zur Online-Bezahlung. Der Nutzer hat hier noch die Auswahl, mit welchem Bezahl-Dienstleister er bezahlen möchte (Paypal, SEPA) |
| 161 |
161 |
|
| 162 |
162 |
{{figure image="plugin_init_config_paypage.png"}} |
| 163 |
163 |
Konfiguration für die PayPage |
| 164 |
164 |
{{/figure}} |
| 165 |
165 |
|
|
169 |
+ |
|
170 |
+; URL zur PayPage (Pflichtfeld) |
|
171 |
+: 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. |
| 166 |
166 |
; Automatische Weiterleitung zur PayPage verhindern |
| 167 |
167 |
: Bei aktivierter Einstellung kann eine automatische Weiterleitung zur PayPage unterbunden werden. |
|
174 |
+; Status, in welchen nach erfolgreicher Transaktion gewechselt wird (Pflichtfeld) |
|
175 |
+: Hier muss ein Status festgelegt werden, in welchen gewechselt wird, wenn der Bezahlvorgang auf Seiten des ePay-BL-Systems erfolgreich durchlaufen wurde. |
|
176 |
+; Status, in welchen nach fehlerhafter oder abgebrochener Transaktion gewechselt wird (Pflichtfeld) |
|
177 |
+: Hier muss ein Status festgelegt werden, in welchen gewechselt wird, wenn der Bezahlvorgang auf Seiten des ePay-BL-Systems abgebrochen wurde. |
|
178 |
+; PayPage Buchungstext |
|
179 |
+: Dieser Buchungstext wird dem Benutzer auf der PayPage angezeigt. |
| 168 |
168 |
; Fälligkeitsdatum |
| 169 |
|
-: Der konfigurierte Wert muss sich in ein gültiges Datum umwandeln lassen. Wenn an dieser Stelle ein Wert hinterlegt ist, wird dieser als Fälligkeitszeitpunkt für die Zahlung übermittelt und die globale Einstellung für den **Fälligkeitszeitraum** wird nicht beachtet. |
| 170 |
|
-; Buchungstext auf PayPage |
| 171 |
|
-: Der hier festgelegte Buchungstext wird dem Benutzer auf der PayPage angezeigt. |
|
181 |
+: Der konfigurierte Wert muss sich in ein gültiges Datum umwandeln lassen. Wenn an dieser Stelle ein Wert hinterlegt ist, wird dieser als Fälligkeitszeitpunkt für die Zahlung übermittelt und |
|
182 |
+die Einstellung für den **Fälligkeitszeitraum** wird nicht beachtet. |
| 172 |
172 |
{{/panel}} |
| 173 |
173 |
|
| 174 |
|
-{{panel title="Konfiguration AKDB ePayment-Mandant" fullwidth="true" initial="visible" triggerable="true"}} |
|
185 |
+{{panel title="Konfiguration AKDB EPayment-Mandant" fullwidth="true" initial="visible" triggerable="true"}} |
| 175 |
175 |
|
| 176 |
176 |
{{figure image="plugin_init_config_akdb_mandant.png"}} |
| 177 |
177 |
Konfiguration AKDB EPayment-Mandant |
| 178 |
178 |
{{/figure}} |
| 179 |
179 |
|
| 180 |
|
-In diesem Bereich können die globalen Einstellungen für den zu verwendenden ePay-BL Mandanten übersteuert werden. Die Einstellungen zum ePay-BL Mandanten sind notwendig, um später die Transaktion auf Seiten von ePay-BL |
| 181 |
|
-der richtigen Behörde (entspricht der festgelegten Mandant-Nummer), dem Bewirtschafter und der Haushaltsstelle zuzuordnen. |
| 182 |
|
-In den meisten Fällen sind diese Einstellungen bereits durch einen Plugin-Administrator global hinterlegt worden, sodass an dieser Stelle keine Konfiguration notwendig ist. |
|
191 |
+In diesem Bereich werden die für den Formular-Prozess zu verwendenden Einstellungen des ePay-BL Mandanten hinterlegt. Diese sind notwendig, um später die Transaktion auf Seiten von ePay-BL |
|
192 |
+der richtigen Behörde (entspricht der festgelegten Mandant-Nummer), Bewirtschafter und Haushaltsstelle zuzuordnen. Die Daten in diesem Bereich sind meistens bereits mit globalen Einstellungen vorbefüllt, |
|
193 |
+sofern diese durch einen Plugin-Administrator korrekt hinterlegt wurden. |
| 183 |
183 |
|
| 184 |
|
-Die einzelnen Parameter können per Platzhalter oder fest definiert hinterlegt werden. Weiterhin kann über den Button [[image:icon_update.png]] //Webservice Erreichbarkeit prüfen// die generelle Erreichbarkeit des EPayment Webservice geprüft werden. |
| 185 |
185 |
|
| 186 |
|
-; Mandant-Nummer |
|
196 |
+Die einzelnen Parameter können per Platzhalter oder fest definiert hinterlegt werden. Weiterhin kann über den Button [[image:icon_update.png]] //EPayment Webservice Erreichbarkeit prüfen// die generelle Erreichbarkeit des EPayment Webservice geprüft werden. |
|
197 |
+ |
|
198 |
+; Mandant-Nummer (Pflichtfeld) |
| 187 |
187 |
: AKDB-Mandantennummer des aufrufenden eShops (FORMCYCLE) (Wird durch ePay-BL-System vorgegeben) |
| 188 |
|
-; Bewirtschafter-Nummer |
|
200 |
+; Bewirtschafter-Nummer (Pflichtfeld) |
| 189 |
189 |
: Bewirtschafternummer (Wird durch ePay-BL-System vorgegeben) |
| 190 |
|
-; Haushaltsstelle |
|
202 |
+; Haushaltsstelle (Pflichtfeld) |
| 191 |
191 |
: Nummer der Haushaltsstelle, welcher die Buchung zugeordnet werden soll. (Wird durch ePay-BL-System vorgegeben) |
| 192 |
|
-; Objektnummer |
|
204 |
+; Objektnummer (Pflichtfeld) |
| 193 |
193 |
: Dient der internen Verbuchung im EPayment-System. (Wird durch ePay-BL-System vorgegeben) |
| 194 |
|
-; Kennzeichen-Mahnverfahren |
|
206 |
+; Kennzeichen-Mahnverfahren (Pflichtfeld) |
| 195 |
195 |
: Einstellung für das Kennzeichen in einem Mahnverfahren. (Mögliche Werte werden durch ePay-BL-System vorgegeben) |
| 196 |
|
-; Fälligkeitszeitraum |
|
208 |
+; Fälligkeitszeitraum (Pflichtfeld) |
| 197 |
197 |
: Einstellung für die Berechnung des Fälligkeitszeitraumes der Zahlung (Dauer in Tagen). |
|
210 |
+; Währung |
|
211 |
+: Währung in welcher der Betrag ausgewiesen wird. Ist nichts definiert wird als Wert **EUR** angenommen. |
| 198 |
198 |
|
| 199 |
199 |
{{/panel}} |
| 200 |
200 |
|
| 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 |
|
-Für die Anzeige des Ergebnisses bzw. dem Status einer Bezahl-Transaktion |
| 242 |
|
- |
| 243 |
|
-* HTML-Template **AKDB ePayment Bezahlung Erfolg**: Standard-Template für Anzeige bei erfolgreich abgeschlossener Bezahlung. |
| 244 |
|
-* HTML-Template **AKDB ePayment Bezahlung Fehler**: Standard-Template für Anzeige bei offenen bzw. fehlerhaft beendeten Bezahlvorgang |
| 245 |
|
-* HTML-Template **AKDB ePayment Fehler**: Standard-Template für Anzeige bei allgemeinen technischen Fehlern |
