| ... |
... |
@@ -1,7 +5,3 @@ |
| 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"]] (requires login) |
| 2 |
|
- |
| 3 |
|
-{{content/}} |
| 4 |
|
- |
| 5 |
5 |
{{info}} |
| 6 |
6 |
**Achtung:** |
| 7 |
7 |
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! |
| ... |
... |
@@ -233,31 +233,28 @@ |
| 233 |
233 |
__Rückgabewerte__ |
| 234 |
234 |
|
| 235 |
235 |
; [%$[Name der Aktion].RESULT.BestellPosition[i]['key']%] |
| 236 |
|
-: Eine Auflistung über alle Bestell-Positionen, welche in der aktuellen Bestellung enthalten sind. |
| 237 |
|
-Zu jeder Bestell-Position können folgende Werte abgefragt werden: |
|
232 |
+: ((( |
|
233 |
+ Eine Auflistung über alle Bestell-Positionen, welche in der aktuellen Bestellung enthalten sind. |
|
234 |
+ Zu jeder Bestell-Position können folgende Werte abgefragt werden: |
| 238 |
238 |
|
| 239 |
|
-((( |
| 240 |
|
-* **Artikelnummer**: Die am //EPayment Artikel// hinterlegte eindeutige Kennung für den Artikel |
| 241 |
|
-* **Buchungstext**: Der übermittelte Buchungstext (max.21 Zeichen, SEPA konform) |
| 242 |
|
-* **Menge**: Die bestellte Menge für die aktuelle Bestell-Position |
| 243 |
|
-* **Beschreibung**: Die am //EPayment Artikel// hinterlegte Artikel-Beschreibung |
| 244 |
|
-* **Einzelpreis**: Der am //EPayment Artikel// hinterlegte Preis für ein Stück. Ausgabe mit Währungssymbol. |
| 245 |
|
-* **Preis**: Der errechnete Gesamtpreis für die aktuelle Bestell-Position. Ergibt sich aus //Menge x Einzelpreis//. Ausgabe mit Währungssysmbol |
|
236 |
+* Artikelnummer: Die am //EPayment Artikel// hinterlegte eindeutige Kennung für den Artikel |
|
237 |
+* Buchungstext: Der übermittelte Buchungstext (max.21 Zeichen, SEPA konform) |
|
238 |
+* Menge: Die bestellte Menge für die aktuelle Bestell-Position |
|
239 |
+* Beschreibung: Die am //EPayment Artikel// hinterlegte Artikel-Beschreibung |
|
240 |
+* Einzelpreis: Der am //EPayment Artikel// hinterlegte Preis für ein Stück. Ausgabe mit Währungssymbol. |
|
241 |
+* Preis: Der errechnete Gesamtpreis für die aktuelle Bestell-Position. Ergibt sich aus //Menge x Einzelpreis//. Ausgabe mit Währungssysmbol |
| 246 |
246 |
|
| 247 |
|
- Nachfolgend einige Beispiele für die Datenabfrage aus den Bestellpositionen: |
| 248 |
|
- Für die Beispiele wird folgender durch eine Aktion mit Namen //Bestellung übermitteln// bereitgestellter Platzhalter zu Grunde |
| 249 |
|
- gelegt: **[%$Bestellung übermitteln.RESULT.Bestellung[i][''key'']%]** |
| 250 |
|
- Die in den eckigen Klammern hinterlegten Werte sind variabel und haben folgende Bedeutung: |
|
243 |
+ Nachfolgend einige Beispiele für die Datenabfrage aus den Bestellpositionen: |
|
244 |
+ Für die Beispiele wird folgender durch die Aktion bereitgestellter Platzhalter zu Grunde gelegt *[%$Bestellung übermitteln.RESULT.Bestellung[i][''key'']%]* |
|
245 |
+ Die in den eckigen Klammern hinterlegten Werte sind variabel und haben folgende Bedeutung: |
| 251 |
251 |
|
|
247 |
+* 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. |
|
248 |
+* key: Schlüssel für den Zugriff auf die jeweilige Eigenschaft |
| 252 |
252 |
|
| 253 |
|
-* **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. |
| 254 |
|
-* **key**: Schlüssel für den Zugriff auf die jeweilige Eigenschaft |
| 255 |
|
- |
| 256 |
|
- Beispiele: |
| 257 |
|
- Abfrage des Einzelpreises an der 1. Bestell-Position: **[%$Bestellung übermitteln.RESULT.Bestellung[0][''Einzelpreis'']%]** |
| 258 |
|
- Abfrage der Menge an der 3. Bestell-Position: **[%$Bestellung übermitteln.RESULT.Bestellung[2][''Menge'']%]** |
|
250 |
+ Beispiele (mit einer Aktion Namens //Bestellung übermitteln//): |
|
251 |
+ Abfrage des Einzelpreises an der 1. Bestell-Position: *[%$Bestellung übermitteln.RESULT.Bestellung[0][''Einzelpreis'']%]* |
|
252 |
+ Abfrage der Menge an der 3. Bestell-Position: *[%$Bestellung übermitteln.RESULT.Bestellung[2][''Menge'']%]* |
| 259 |
259 |
))) |
| 260 |
|
- |
| 261 |
261 |
; [%$[Name der Aktion].RESULT.BestellPositionAnzahl%] |
| 262 |
262 |
: Die Gesamtanzahl der Bestellpositionen, welche in der aktuellen Bestellung enthalten sind |
| 263 |
263 |
; [%$[Name der Aktion].RESULT.Gesamtbetrag%] |
| ... |
... |
@@ -283,29 +283,19 @@ |
| 283 |
283 |
|
| 284 |
284 |
=== 2.2. Workflow-Ereignis //Bezahlung erfolgreich// === |
| 285 |
285 |
|
| 286 |
|
-{{figure image="trigger_success.png"}} |
| 287 |
|
-Workflow-Ereignis bei erfolgreicher Bezahlung |
| 288 |
|
-{{/figure}} |
| 289 |
|
- |
| 290 |
290 |
Eine Workflow-Verarbeitungskette mit diesem Ereignis wird ausgeführt, wenn eine Rückleitung aus dem ePay-BL Portal erfolgt |
| 291 |
291 |
und die Bezahlung erfolgreich durchgeführt wurde. Pro Formular-Vorgang kann dieses Ereignis genau einmal eintreten. |
| 292 |
292 |
Das Ereignis stellt dabei folgende Werte bereit, die per Platzhalter in nachfolgenden Aktionen ausgewertet werden können: |
| 293 |
293 |
|
| 294 |
294 |
; **[%$TRIGGER.paymentStatus%]** |
| 295 |
|
-: Bezeichnung des Status, wie er vom ePay-BL Portal zurück geliefert wird. (Möglicher Wert: INAKTIV) |
|
284 |
+: Bezeichnung des Status, wie er vom ePay-BL Portal zurückgeliefert wird. (Möglicher Wert: INAKTIV) |
| 296 |
296 |
; **[%$TRIGGER.paymentStatusText%]** |
| 297 |
|
-: Eine Nachricht, die den zurück gelieferten Status näher beschreibt |
| 298 |
|
-; **[%$TRIGGER.paymentMethod%] {{version major="3" minor="5"}}{{/version}}** |
| 299 |
|
-: Parameter gibt Auskunft über das in der Bezahl-Transaktion angewendete Zahlverfahren |
|
286 |
+: Eine Nachricht, die den zurückgelieferten Status näher beschreibt |
| 300 |
300 |
|
| 301 |
301 |
{{id name="plugin_event_epay_error"/}} |
| 302 |
302 |
|
| 303 |
303 |
=== 2.3. Workflow-Ereignis //Bezahlung nicht erfolgreich// === |
| 304 |
304 |
|
| 305 |
|
-{{figure image="trigger_error.png"}} |
| 306 |
|
-Workflow-Ereignis bei nicht erfolgreicher Bezahlung |
| 307 |
|
-{{/figure}} |
| 308 |
|
- |
| 309 |
309 |
Eine Workflow-Verarbeitungskette mit diesem Ereignis wird immer dann ausgeführt, wenn eine Rückleitung aus dem ePay-BL Portal erfolgte |
| 310 |
310 |
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). |
| 311 |
311 |
Das Ereignis stellt folgende Werte bereit, die per Platzhalter in nachfolgenden Aktionen ausgewertet werden können: |
| ... |
... |
@@ -326,10 +326,6 @@ |
| 326 |
326 |
: Eine Nachricht, die den zurückgelieferten Status näher beschreibt |
| 327 |
327 |
; **[%$TRIGGER.paypageUrl%]** |
| 328 |
328 |
: URL zur Paypage mit der aktuellen Transaktionsnummer. Damit ist ein nochmaliges Aufrufen und Bezahlen der offenen Transaktion möglich. |
| 329 |
|
-; **[%$TRIGGER.paymentMethod%]** {{version major="3" minor="5"}}{{/version}} |
| 330 |
|
-: Parameter gibt Auskunft über das in der Bezahl-Transaktion angewendete Zahlverfahren |
| 331 |
|
-; **[%$TRIGGER.paymentVerifyUrl%] {{version major="3" minor="5"}}{{/version}}** |
| 332 |
|
-: 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 |
| 333 |
333 |
|
| 334 |
334 |
== 3. Ergebnisanzeige == |
| 335 |
335 |
|
| ... |
... |
@@ -347,36 +347,6 @@ |
| 347 |
347 |
|
| 348 |
348 |
== Versionshistorie == |
| 349 |
349 |
|
| 350 |
|
-=== 3.5.0 === |
| 351 |
|
- |
| 352 |
|
-* Erweiterungen: EPayment-Verifikation-Aktion (V6) um 'Zahlverfahren' erweitert. |
| 353 |
|
-Trigger (Workflow V7) um genutztes 'Zahlverfahren' innerhalb der Rückgabewerte erweitert. |
| 354 |
|
-Error-Trigger (Workflow V7) um 'PaymentVerifyUrl' erweitert. Dieser Parameter kann zum nochmaligen Aufruf der Verifizierung einer Bezahlung genutzt werden. |
| 355 |
|
-* Erweiterung AKDB ePay Setup: Eingabemöglichkeit für Daten des anzubindenden ePayment-Mandanten; Zusätzlicher Hinweis auf freizugebende URLs (notwendige Firewall-Freigaben) |
| 356 |
|
- |
| 357 |
|
-=== 3.4.3 === |
| 358 |
|
- |
| 359 |
|
-* 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. |
| 360 |
|
- |
| 361 |
|
-=== 3.4.2 === |
| 362 |
|
- |
| 363 |
|
-* Fehlerbehebung: ein Anzeige-Fehler bei der Berechnung des Gesamtpreises für einen EPayment-Bestellartikel wurde behoben |
| 364 |
|
-* Fehlerbehebung: Aufgrund von Fehlern beim Decodieren und Entschlüsseln von URL-Parametern, wurde die Verschlüsselungs-Routine angepasst. |
| 365 |
|
- |
| 366 |
|
-=== 3.4.1 === |
| 367 |
|
- |
| 368 |
|
-* Fehlerbehebung EPayment Bestellartikel: Die Werte der widget-internen HTML-Elemente sind bei einer Zwischenspeicherung nicht berücksichtigt worden. Dies wurde behoben. |
| 369 |
|
- |
| 370 |
|
-=== 3.4.0 === |
| 371 |
|
- |
| 372 |
|
-* Erweiterung AKDB ePay Setup: Ein Verbindungstest ist jetzt auch ohne Konfiguration eines AKDB-Mandanten möglich. |
| 373 |
|
-* Anpassung EPayment Bestellartikel: HTML-Elemente innerhalb des Widgets um 'data-' Präfix erweitert |
| 374 |
|
-* Fehlerbehebung: Session-Replacer werden bei Verarbeitung der Workflow-Ereignisse berücksichtigt. |
| 375 |
|
- |
| 376 |
|
-=== 3.3.1 === |
| 377 |
|
- |
| 378 |
|
-* 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. |
| 379 |
|
- |
| 380 |
380 |
=== 3.3.0 === |
| 381 |
381 |
|
| 382 |
382 |
* Plugin benötigt mindestens {{formcycle/}} in der Version {{version major="7" patch="9"}}{{/version}} |
