| ... |
... |
@@ -1,4 +1,13 @@ |
|
1 |
+[[**Plugin download**>>url:https://customer.formcycle.eu/index.php/apps/files/?dir=/FORMCYCLE%20-%20Plugins%20Customer/plugin-bundle-akdb-epayment&fileid=2674||rel="noopener noreferrer" target="_blank"]] (Anmeldung erforderlich) |
|
2 |
+ |
| 1 |
1 |
{{info}} |
|
4 |
+**Hinweis zur Inbetriebnahme des Plugins:** |
|
5 |
+Im Download-Ordner der jeweilige Plugin-Version befindet sich eine Anleitung zur initialen Inbetriebnahme, sowie zu weiter reichenden Information die den allgemeinen Betrieb dieses Plugins betreffen. |
|
6 |
+{{/info}} |
|
7 |
+ |
|
8 |
+{{content/}} |
|
9 |
+ |
|
10 |
+{{info}} |
| 2 |
2 |
**Achtung:** |
| 3 |
3 |
Bevor Sie die AKDB EPayment in ihren Formular-Prozessen einbinden, stellen Sie bitte sicher, dass die konfigurative Anbindung des Dienstes durch den {{formcycle/}}-Administrator erfolgt ist! |
| 4 |
4 |
{{/info}} |
| ... |
... |
@@ -223,26 +223,85 @@ |
| 223 |
223 |
==== 2.1.1 Rückgabewerte der Workflow-Aktion ==== |
| 224 |
224 |
|
| 225 |
225 |
{{figure image="plugin_init_result.png"}} |
| 226 |
|
-Konfiguration AKDB EPayment-Mandant |
|
235 |
+Rückgabewert und Fehlercodes der Aktion |
| 227 |
227 |
{{/figure}} |
| 228 |
228 |
|
|
238 |
+__Rückgabewerte__ |
|
239 |
+ |
|
240 |
+; [%$[Name der Aktion].RESULT.BestellPosition[i]['key']%] |
|
241 |
+: Eine Auflistung über alle Bestell-Positionen, welche in der aktuellen Bestellung enthalten sind. |
|
242 |
+Zu jeder Bestell-Position können folgende Werte abgefragt werden: |
|
243 |
+ |
|
244 |
+((( |
|
245 |
+* **Artikelnummer**: Die am //EPayment Artikel// hinterlegte eindeutige Kennung für den Artikel |
|
246 |
+* **Buchungstext**: Der übermittelte Buchungstext (max.21 Zeichen, SEPA konform) |
|
247 |
+* **Menge**: Die bestellte Menge für die aktuelle Bestell-Position |
|
248 |
+* **Beschreibung**: Die am //EPayment Artikel// hinterlegte Artikel-Beschreibung |
|
249 |
+* **Einzelpreis**: Der am //EPayment Artikel// hinterlegte Preis für ein Stück. Ausgabe mit Währungssymbol. |
|
250 |
+* **Preis**: Der errechnete Gesamtpreis für die aktuelle Bestell-Position. Ergibt sich aus //Menge x Einzelpreis//. Ausgabe mit Währungssysmbol |
|
251 |
+ |
|
252 |
+ Nachfolgend einige Beispiele für die Datenabfrage aus den Bestellpositionen: |
|
253 |
+ Für die Beispiele wird folgender durch eine Aktion mit Namen //Bestellung übermitteln// bereitgestellter Platzhalter zu Grunde |
|
254 |
+ gelegt: **[%$Bestellung übermitteln.RESULT.Bestellung[i][''key'']%]** |
|
255 |
+ Die in den eckigen Klammern hinterlegten Werte sind variabel und haben folgende Bedeutung: |
|
256 |
+ |
|
257 |
+ |
|
258 |
+* **i**: Zählvariable für den Zugriff auf eine Bestell-Position aus der Gruppe aller Bestell-Positionen. Ein möglicher Wert muss sich im Bereich von 0 bis zum Wert der BestellPositionAnzahl -1 befinden. |
|
259 |
+* **key**: Schlüssel für den Zugriff auf die jeweilige Eigenschaft |
|
260 |
+ |
|
261 |
+ Beispiele: |
|
262 |
+ Abfrage des Einzelpreises an der 1. Bestell-Position: **[%$Bestellung übermitteln.RESULT.Bestellung[0][''Einzelpreis'']%]** |
|
263 |
+ Abfrage der Menge an der 3. Bestell-Position: **[%$Bestellung übermitteln.RESULT.Bestellung[2][''Menge'']%]** |
|
264 |
+))) |
|
265 |
+ |
|
266 |
+; [%$[Name der Aktion].RESULT.BestellPositionAnzahl%] |
|
267 |
+: Die Gesamtanzahl der Bestellpositionen, welche in der aktuellen Bestellung enthalten sind |
|
268 |
+; [%$[Name der Aktion].RESULT.Gesamtbetrag%] |
|
269 |
+: Der in der Zahlungstransaktion ausgewiesene zu zahlende Geldbetrag. Angabe in Euro |
|
270 |
+; [%$[Name der Aktion].RESULT.Kassenzeichen%] |
|
271 |
+: Das aktuelle Kassenzeichen unter dem die Zahlungstransaktion im ePay-BL Portal geführt wird. |
|
272 |
+; [%$[Name der Aktion].RESULT.UrlToPaypage%] |
|
273 |
+: Die URL zur Bezahlseite auf Seiten von ePay-BL, wo die Bezahlung der aktuellen Transaktion durchgeführt werden kann. |
|
274 |
+ |
|
275 |
+__Fehlercodes__ |
|
276 |
+ |
|
277 |
+; NO_ORDER_DATA |
|
278 |
+: Fehlercode, wenn zur Laufzeit keine Bestellpositionen übermittelt wurden. Diese kann beispielweise auftreten, wenn der Formular-Nutzer beispielsweise keine Artikel zum Bestellen ausgewählt hatte. |
|
279 |
+; SRV_NOT_AVIALABLE |
|
280 |
+: Fehlercode, wenn der ePay-BL Service nicht verfügbar ist. |
|
281 |
+; SRV_METHOD_ERROR |
|
282 |
+: Fehlercode, wenn eine ePay-BL Webservice-Methode einen Fehler lieferte. Bei Auftreten von solchen Fehlertypen sollte das |
|
283 |
+{{formcycle/}} interne Fehler-Protokoll für eine tiefere Analyse einbezogen werden. |
|
284 |
+; INTERNAL_ERROR |
|
285 |
+: Fehlercode für einen nicht nähere beschriebenen Fehler. Bei Auftreten von solchen Fehlertypen sollte das |
|
286 |
+{{formcycle/}} interne Fehler-Protokoll für eine tiefere Analyse einbezogen werden. |
| 229 |
229 |
{{id name="plugin_event_epay_success"/}} |
| 230 |
230 |
|
| 231 |
231 |
=== 2.2. Workflow-Ereignis //Bezahlung erfolgreich// === |
| 232 |
232 |
|
|
291 |
+{{figure image="trigger_success.png"}} |
|
292 |
+Workflow-Ereignis bei erfolgreicher Bezahlung |
|
293 |
+{{/figure}} |
|
294 |
+ |
| 233 |
233 |
Eine Workflow-Verarbeitungskette mit diesem Ereignis wird ausgeführt, wenn eine Rückleitung aus dem ePay-BL Portal erfolgt |
| 234 |
234 |
und die Bezahlung erfolgreich durchgeführt wurde. Pro Formular-Vorgang kann dieses Ereignis genau einmal eintreten. |
| 235 |
235 |
Das Ereignis stellt dabei folgende Werte bereit, die per Platzhalter in nachfolgenden Aktionen ausgewertet werden können: |
| 236 |
236 |
|
| 237 |
237 |
; **[%$TRIGGER.paymentStatus%]** |
| 238 |
|
-: Bezeichnung des Status, wie er vom ePay-BL Portal zurückgeliefert wird. (Möglicher Wert: INAKTIV) |
|
300 |
+: Bezeichnung des Status, wie er vom ePay-BL Portal zurück geliefert wird. (Möglicher Wert: INAKTIV) |
| 239 |
239 |
; **[%$TRIGGER.paymentStatusText%]** |
| 240 |
|
-: Eine Nachricht, die den zurückgelieferten Status näher beschreibt |
|
302 |
+: Eine Nachricht, die den zurück gelieferten Status näher beschreibt |
|
303 |
+; **[%$TRIGGER.paymentMethod%] {{version major="3" minor="5"}}{{/version}}** |
|
304 |
+: Parameter gibt Auskunft über das in der Bezahl-Transaktion angewendete Zahlverfahren |
| 241 |
241 |
|
| 242 |
242 |
{{id name="plugin_event_epay_error"/}} |
| 243 |
243 |
|
| 244 |
244 |
=== 2.3. Workflow-Ereignis //Bezahlung nicht erfolgreich// === |
| 245 |
245 |
|
|
310 |
+{{figure image="trigger_error.png"}} |
|
311 |
+Workflow-Ereignis bei nicht erfolgreicher Bezahlung |
|
312 |
+{{/figure}} |
|
313 |
+ |
| 246 |
246 |
Eine Workflow-Verarbeitungskette mit diesem Ereignis wird immer dann ausgeführt, wenn eine Rückleitung aus dem ePay-BL Portal erfolgte |
| 247 |
247 |
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). |
| 248 |
248 |
Das Ereignis stellt folgende Werte bereit, die per Platzhalter in nachfolgenden Aktionen ausgewertet werden können: |
| ... |
... |
@@ -250,7 +250,7 @@ |
| 250 |
250 |
; **[%$TRIGGER.paymentStatus%]** |
| 251 |
251 |
: Bezeichnung des Status, wie er vom ePay-BL Portal zurückgeliefert wird. |
| 252 |
252 |
: Folgende Werte sind möglich: |
| 253 |
|
-: **AKTIV**: Die Bezahlung über die PayPage ist noch nicht erfolgt. |
|
321 |
+: **AKTIV**: Die Bezahlung über die PayPage ist noch nicht erfolgt (z.B. weil der Nutzer den Bezahlvorgang auf Seiten von ePay-BL abgebrochen hat). |
| 254 |
254 |
: **MANDANT_NICHT_GEFUNDEN**: Der Mandant wurde im ePayment-System nicht gefunden. |
| 255 |
255 |
: **MANDANT_INAKTIV**: Der Mandant ist im ePayment-System derzeit als inaktiv gekennzeichnet. |
| 256 |
256 |
: **VERBINDUNG_OHNE_HTTPS**: Die Verbindung zum Webservice erfolgte nicht über HTTPS mit Client-Zertifikaten. |
| ... |
... |
@@ -263,6 +263,10 @@ |
| 263 |
263 |
: Eine Nachricht, die den zurückgelieferten Status näher beschreibt |
| 264 |
264 |
; **[%$TRIGGER.paypageUrl%]** |
| 265 |
265 |
: URL zur Paypage mit der aktuellen Transaktionsnummer. Damit ist ein nochmaliges Aufrufen und Bezahlen der offenen Transaktion möglich. |
|
334 |
+; **[%$TRIGGER.paymentMethod%]** {{version major="3" minor="5"}}{{/version}} |
|
335 |
+: Parameter gibt Auskunft über das in der Bezahl-Transaktion angewendete Zahlverfahren |
|
336 |
+; **[%$TRIGGER.paymentVerifyUrl%] {{version major="3" minor="5"}}{{/version}}** |
|
337 |
+: URL zum erneuten Prüfen des Bezahlstatus. Ein Aufruf der URL löst im Anschluss, an die Überprüfung des aktuellen Bezahlstatus, die entsprechenden Workflow-Ereignisse aus |
| 266 |
266 |
|
| 267 |
267 |
== 3. Ergebnisanzeige == |
| 268 |
268 |
|
| ... |
... |
@@ -280,6 +280,45 @@ |
| 280 |
280 |
|
| 281 |
281 |
== Versionshistorie == |
| 282 |
282 |
|
|
355 |
+=== 3.6.0 === |
|
356 |
+ |
|
357 |
+* Erweiterung AKDB ePay Setup: Konfigurationsmöglichkeit für Proxy-Server-Einstellungen |
|
358 |
+* Platzhalter für Payment Verify-Url: Mit dem Platzhalter [%$PAYMENT_VERIFY_URL%] kann Status-übergreifend auf den URL zum nochmaligen Prüfen des Status einer Bezahltransaktion zugegriffen werden. |
|
359 |
+ |
|
360 |
+=== 3.5.1 === |
|
361 |
+ |
|
362 |
+* Fehlerbehebung: Im Zusammenspiel mit der {{formcycle/}} Version {{version major="7" patch="10"}}{{/version}} konnten Zertifikatsdateien nicht über das AKDB ePay Setup hochgeladen werden. Dieser Fehler wurde behoben. |
|
363 |
+ |
|
364 |
+=== 3.5.0 === |
|
365 |
+ |
|
366 |
+* Erweiterungen: EPayment-Verifikation-Aktion (V6) um 'Zahlverfahren' erweitert. |
|
367 |
+Trigger (Workflow V7) um genutztes 'Zahlverfahren' innerhalb der Rückgabewerte erweitert. |
|
368 |
+Error-Trigger (Workflow V7) um 'PaymentVerifyUrl' erweitert. Dieser Parameter kann zum nochmaligen Aufruf der Verifizierung einer Bezahlung genutzt werden. |
|
369 |
+* Erweiterung AKDB ePay Setup: Eingabemöglichkeit für Daten des anzubindenden ePayment-Mandanten; Zusätzlicher Hinweis auf freizugebende URLs (notwendige Firewall-Freigaben) |
|
370 |
+ |
|
371 |
+=== 3.4.3 === |
|
372 |
+ |
|
373 |
+* Fehlerbehebung bei Rückleitung von der PayPage zum Formular: In einigen Fällen, insbesondere bei Kommunikation über den Frontend-Server, kam es zu Störungen beim Auslösen der nachgelagerten Workflow-Verarbeitung. Dies wurde behoben. |
|
374 |
+ |
|
375 |
+=== 3.4.2 === |
|
376 |
+ |
|
377 |
+* Fehlerbehebung: ein Anzeige-Fehler bei der Berechnung des Gesamtpreises für einen EPayment-Bestellartikel wurde behoben |
|
378 |
+* Fehlerbehebung: Aufgrund von Fehlern beim Decodieren und Entschlüsseln von URL-Parametern, wurde die Verschlüsselungs-Routine angepasst. |
|
379 |
+ |
|
380 |
+=== 3.4.1 === |
|
381 |
+ |
|
382 |
+* Fehlerbehebung EPayment Bestellartikel: Die Werte der widget-internen HTML-Elemente sind bei einer Zwischenspeicherung nicht berücksichtigt worden. Dies wurde behoben. |
|
383 |
+ |
|
384 |
+=== 3.4.0 === |
|
385 |
+ |
|
386 |
+* Erweiterung AKDB ePay Setup: Ein Verbindungstest ist jetzt auch ohne Konfiguration eines AKDB-Mandanten möglich. |
|
387 |
+* Anpassung EPayment Bestellartikel: HTML-Elemente innerhalb des Widgets um 'data-' Präfix erweitert |
|
388 |
+* Fehlerbehebung: Session-Replacer werden bei Verarbeitung der Workflow-Ereignisse berücksichtigt. |
|
389 |
+ |
|
390 |
+=== 3.3.1 === |
|
391 |
+ |
|
392 |
+* Fehlerbehebung: Mehrfache Anfragen auf den gleichen Vorgang bei Rückleitung vom ePay-BL-Portal werden jetzt vom System abgelehnt, solange der aktuell angefragte Vorgang sich in Verarbeitung befindet. |
|
393 |
+ |
| 283 |
283 |
=== 3.3.0 === |
| 284 |
284 |
|
| 285 |
285 |
* Plugin benötigt mindestens {{formcycle/}} in der Version {{version major="7" patch="9"}}{{/version}} |
