| ... |
... |
@@ -3,7 +3,7 @@ |
| 3 |
3 |
{{info}} |
| 4 |
4 |
**Achtung:** |
| 5 |
5 |
Seit Plugin-Version {{version major="4" minor="0" patch="0"}}{{/version}} ist ein Anbindung an von der AKDB unabhängigen Anbietern möglich. Alte AKDB spezifische Plugin-Versionen sind [[**unter diesem Link **>>url:https://customer.formcycle.eu/index.php/apps/files/?dir=/FORMCYCLE%20-%20Plugins%20Customer/AKDB%3A%20EPayment%20plugin%20(plugin-bundle-akdb-epayment)&fileid=2674||rel="noopener noreferrer" target="_blank"]] (Anmeldung erforderlich) zu finden. |
| 6 |
|
-**Es wird eine minor Version folgen, welche die Migration von alten Plugin-Versionen erleichtert.** |
|
6 |
+Bezahlvorgänge, welche in einer früheren Version abgebrochen wurden, können nicht in der Plugin-Version {{version major="4" minor="0" patch="0"}}{{/version}} abgeschlossen werden. |
| 7 |
7 |
{{/info}} |
| 8 |
8 |
|
| 9 |
9 |
{{content/}} |
| ... |
... |
@@ -203,7 +203,7 @@ |
| 203 |
203 |
|
| 204 |
204 |
{{/panel}} |
| 205 |
205 |
|
| 206 |
|
-{{panel title="Konfiguration AKDB ePayment-Mandant" fullwidth="true" initial="visible" triggerable="true"}} |
|
206 |
+{{panel title="Konfiguration ePayBL ePayment-Mandant" fullwidth="true" initial="visible" triggerable="true"}} |
| 207 |
207 |
|
| 208 |
208 |
{{figure image="plugin_init_config_akdb_mandant.png"}} |
| 209 |
209 |
Konfiguration ePayBL EPayment-Mandant |
| ... |
... |
@@ -216,15 +216,15 @@ |
| 216 |
216 |
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. |
| 217 |
217 |
|
| 218 |
218 |
; Mandant-Nummer |
| 219 |
|
-: AKDB-Mandantennummer des aufrufenden eShops (FORMCYCLE) (Wird durch ePay-BL-System vorgegeben) |
|
219 |
+: ePayBL-Mandantennummer des aufrufenden eShops (FORMCYCLE) (Wird durch ePayBL-System vorgegeben) |
| 220 |
220 |
; Bewirtschafter-Nummer |
| 221 |
|
-: Bewirtschafternummer (Wird durch ePay-BL-System vorgegeben) |
|
221 |
+: Bewirtschafternummer (Wird durch ePayBL-System vorgegeben) |
| 222 |
222 |
; Haushaltsstelle |
| 223 |
|
-: Nummer der Haushaltsstelle, welcher die Buchung zugeordnet werden soll. (Wird durch ePay-BL-System vorgegeben) |
|
223 |
+: Nummer der Haushaltsstelle, welcher die Buchung zugeordnet werden soll. (Wird durch ePayBL-System vorgegeben) |
| 224 |
224 |
; Objektnummer |
| 225 |
|
-: Dient der internen Verbuchung im EPayment-System. (Wird durch ePay-BL-System vorgegeben) |
|
225 |
+: Dient der internen Verbuchung im EPayment-System. (Wird durch ePayBL-System vorgegeben) |
| 226 |
226 |
; Kennzeichen-Mahnverfahren |
| 227 |
|
-: Einstellung für das Kennzeichen in einem Mahnverfahren. (Mögliche Werte werden durch ePay-BL-System vorgegeben) |
|
227 |
+: Einstellung für das Kennzeichen in einem Mahnverfahren. (Mögliche Werte werden durch ePayBL-System vorgegeben) |
| 228 |
228 |
; Fälligkeitszeitraum |
| 229 |
229 |
: Einstellung für die Berechnung des Fälligkeitszeitraumes der Zahlung (Dauer in Tagen). |
| 230 |
230 |
|
| ... |
... |
@@ -269,19 +269,19 @@ |
| 269 |
269 |
; [%$[Name der Aktion].RESULT.Gesamtbetrag%] |
| 270 |
270 |
: Der in der Zahlungstransaktion ausgewiesene zu zahlende Geldbetrag. Angabe in Euro |
| 271 |
271 |
; [%$[Name der Aktion].RESULT.Kassenzeichen%] |
| 272 |
|
-: Das aktuelle Kassenzeichen unter dem die Zahlungstransaktion im ePay-BL Portal geführt wird. |
|
272 |
+: Das aktuelle Kassenzeichen unter dem die Zahlungstransaktion im ePayBL Portal geführt wird. |
| 273 |
273 |
; [%$[Name der Aktion].RESULT.UrlToPaypage%] |
| 274 |
|
-: Die URL zur Bezahlseite auf Seiten von ePay-BL, wo die Bezahlung der aktuellen Transaktion durchgeführt werden kann. |
|
274 |
+: Die URL zur Bezahlseite auf Seiten von ePayBL, wo die Bezahlung der aktuellen Transaktion durchgeführt werden kann. |
| 275 |
275 |
|
| 276 |
276 |
__Fehlercodes__ |
| 277 |
277 |
|
| 278 |
278 |
; NO_ORDER_DATA |
| 279 |
|
-: 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 |
+: Fehlercode, wenn zur Laufzeit keine Bestellpositionen übermittelt wurden. Diese kann beispielweise auftreten, wenn der Formular-Nutzer beispielsweise keine Artikel zum Bestellen ausgewählt hatte. |
| 280 |
280 |
; SRV_NOT_AVIALABLE |
| 281 |
|
-: Fehlercode, wenn der ePay-BL Service nicht verfügbar ist. |
|
281 |
+: Fehlercode, wenn der ePayBL Service nicht verfügbar ist. |
| 282 |
282 |
; SRV_METHOD_ERROR |
| 283 |
|
-: Fehlercode, wenn eine ePay-BL Webservice-Methode einen Fehler lieferte. Bei Auftreten von solchen Fehlertypen sollte das |
| 284 |
|
-{{formcycle/}} interne Fehler-Protokoll für eine tiefere Analyse einbezogen werden. |
|
283 |
+: Fehlercode, wenn eine ePayBL Webservice-Methode einen Fehler lieferte. Bei Auftreten von solchen Fehlertypen sollte das |
|
284 |
+{{formcycle/}} interne Fehler-Protokoll für eine tiefere Analyse einbezogen werden. |
| 285 |
285 |
; INTERNAL_ERROR |
| 286 |
286 |
: Fehlercode für einen nicht nähere beschriebenen Fehler. Bei Auftreten von solchen Fehlertypen sollte das |
| 287 |
287 |
{{formcycle/}} interne Fehler-Protokoll für eine tiefere Analyse einbezogen werden. |
| ... |
... |
@@ -293,12 +293,12 @@ |
| 293 |
293 |
Workflow-Ereignis bei erfolgreicher Bezahlung |
| 294 |
294 |
{{/figure}} |
| 295 |
295 |
|
| 296 |
|
-Eine Workflow-Verarbeitungskette mit diesem Ereignis wird ausgeführt, wenn eine Rückleitung aus dem ePay-BL Portal erfolgt |
|
296 |
+Eine Workflow-Verarbeitungskette mit diesem Ereignis wird ausgeführt, wenn eine Rückleitung aus dem ePayBL Portal erfolgt |
| 297 |
297 |
und die Bezahlung erfolgreich durchgeführt wurde. Pro Formular-Vorgang kann dieses Ereignis genau einmal eintreten. |
| 298 |
298 |
Das Ereignis stellt dabei folgende Werte bereit, die per Platzhalter in nachfolgenden Aktionen ausgewertet werden können: |
| 299 |
299 |
|
| 300 |
300 |
; **[%$TRIGGER.paymentStatus%]** |
| 301 |
|
-: Bezeichnung des Status, wie er vom ePay-BL Portal zurück geliefert wird. (Möglicher Wert: INAKTIV) |
|
301 |
+: Bezeichnung des Status, wie er vom ePayBL Portal zurück geliefert wird. (Möglicher Wert: INAKTIV) |
| 302 |
302 |
; **[%$TRIGGER.paymentStatusText%]** |
| 303 |
303 |
: Eine Nachricht, die den zurück gelieferten Status näher beschreibt |
| 304 |
304 |
; **[%$TRIGGER.paymentMethod%] {{version major="3" minor="5"}}{{/version}}** |
| ... |
... |
@@ -312,14 +312,14 @@ |
| 312 |
312 |
Workflow-Ereignis bei nicht erfolgreicher Bezahlung |
| 313 |
313 |
{{/figure}} |
| 314 |
314 |
|
| 315 |
|
-Eine Workflow-Verarbeitungskette mit diesem Ereignis wird immer dann ausgeführt, wenn eine Rückleitung aus dem ePay-BL Portal erfolgte |
| 316 |
|
-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). |
|
315 |
+Eine Workflow-Verarbeitungskette mit diesem Ereignis wird immer dann ausgeführt, wenn eine Rückleitung aus dem ePayBL Portal erfolgte |
|
316 |
+und die Bezahlung nicht durchgeführt wurde. Pro Formular-Vorgang kann dieses Ereignis mehrfach eintreten (Bei Fehlern im ePayBL Portal oder bei Abbruch des Bezahlvorgangs durch den Nutzer). |
| 317 |
317 |
Das Ereignis stellt folgende Werte bereit, die per Platzhalter in nachfolgenden Aktionen ausgewertet werden können: |
| 318 |
318 |
|
| 319 |
319 |
; **[%$TRIGGER.paymentStatus%]** |
| 320 |
|
-: Bezeichnung des Status, wie er vom ePay-BL Portal zurückgeliefert wird. |
|
320 |
+: Bezeichnung des Status, wie er vom ePayBL Portal zurückgeliefert wird. |
| 321 |
321 |
: Folgende Werte sind möglich: |
| 322 |
|
-: **AKTIV**: Die Bezahlung über die PayPage ist noch nicht erfolgt (z.B. weil der Nutzer den Bezahlvorgang auf Seiten von ePay-BL abgebrochen hat). |
|
322 |
+: **AKTIV**: Die Bezahlung über die PayPage ist noch nicht erfolgt (z.B. weil der Nutzer den Bezahlvorgang auf Seiten von ePayBL abgebrochen hat). |
| 323 |
323 |
: **MANDANT_NICHT_GEFUNDEN**: Der Mandant wurde im ePayment-System nicht gefunden. |
| 324 |
324 |
: **MANDANT_INAKTIV**: Der Mandant ist im ePayment-System derzeit als inaktiv gekennzeichnet. |
| 325 |
325 |
: **VERBINDUNG_OHNE_HTTPS**: Die Verbindung zum Webservice erfolgte nicht über HTTPS mit Client-Zertifikaten. |
| ... |
... |
@@ -342,9 +342,9 @@ |
| 342 |
342 |
Die Anzeige des Ergebnisses bzw. des Status einer Bezahl-Transaktion erfolgt standardmäßig mittels einer extra Abschluss-Seite. |
| 343 |
343 |
Dafür stellt das Plugin 3 HTML-Templates bereit: |
| 344 |
344 |
|
| 345 |
|
-* **AKDB ePayment Bezahlung Erfolg**: Standard-Template für Anzeige bei erfolgreich abgeschlossener Bezahlung. |
| 346 |
|
-* **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. |
| 347 |
|
-* **AKDB ePayment Fehler**: Standard-Template für Anzeige bei allgemeinen technischen Fehlern. Der genaue Fehler wird mittels enthaltener Platzhalter ausgewiesen. |
|
345 |
+* **ePayBL ePayment Bezahlung Erfolg**: Standard-Template für Anzeige bei erfolgreich abgeschlossener Bezahlung. |
|
346 |
+* **ePayBL 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. |
|
347 |
+* **ePayBL ePayment Fehler**: Standard-Template für Anzeige bei allgemeinen technischen Fehlern. Der genaue Fehler wird mittels enthaltener Platzhalter ausgewiesen. |
| 348 |
348 |
|
| 349 |
349 |
{{info}} |
| 350 |
350 |
Die durch das Plugin bereitgestellten HTML-Templates können bearbeitet werden. Änderungen haben dabei auf alle Formulare mit Bezahl-Workflow Auswirkungen, wenn Sie diese Standard-Templates nutzen. |
| ... |
... |
@@ -353,85 +353,12 @@ |
| 353 |
353 |
|
| 354 |
354 |
== Versionshistorie == |
| 355 |
355 |
|
| 356 |
|
-=== 3.6.0 === |
|
356 |
+=== 4.0.0 === |
| 357 |
357 |
|
| 358 |
|
-* Erweiterung AKDB ePay Setup: Konfigurationsmöglichkeit für Proxy-Server-Einstellungen |
| 359 |
|
-* 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. |
|
358 |
+**//Re-Release des AKDB: ePayment Plugins als ePayBL: ePayment//** |
| 360 |
360 |
|
| 361 |
|
-=== 3.5.1 === |
| 362 |
|
- |
| 363 |
|
-* 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. |
| 364 |
|
- |
| 365 |
|
-=== 3.5.0 === |
| 366 |
|
- |
| 367 |
|
-* Erweiterungen: EPayment-Verifikation-Aktion (V6) um 'Zahlverfahren' erweitert. |
| 368 |
|
-Trigger (Workflow V7) um genutztes 'Zahlverfahren' innerhalb der Rückgabewerte erweitert. |
| 369 |
|
-Error-Trigger (Workflow V7) um 'PaymentVerifyUrl' erweitert. Dieser Parameter kann zum nochmaligen Aufruf der Verifizierung einer Bezahlung genutzt werden. |
| 370 |
|
-* Erweiterung AKDB ePay Setup: Eingabemöglichkeit für Daten des anzubindenden ePayment-Mandanten; Zusätzlicher Hinweis auf freizugebende URLs (notwendige Firewall-Freigaben) |
| 371 |
|
- |
| 372 |
|
-=== 3.4.3 === |
| 373 |
|
- |
| 374 |
|
-* 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. |
| 375 |
|
- |
| 376 |
|
-=== 3.4.2 === |
| 377 |
|
- |
| 378 |
|
-* Fehlerbehebung: ein Anzeige-Fehler bei der Berechnung des Gesamtpreises für einen EPayment-Bestellartikel wurde behoben |
| 379 |
|
-* Fehlerbehebung: Aufgrund von Fehlern beim Decodieren und Entschlüsseln von URL-Parametern, wurde die Verschlüsselungs-Routine angepasst. |
| 380 |
|
- |
| 381 |
|
-=== 3.4.1 === |
| 382 |
|
- |
| 383 |
|
-* Fehlerbehebung EPayment Bestellartikel: Die Werte der widget-internen HTML-Elemente sind bei einer Zwischenspeicherung nicht berücksichtigt worden. Dies wurde behoben. |
| 384 |
|
- |
| 385 |
|
-=== 3.4.0 === |
| 386 |
|
- |
| 387 |
|
-* Erweiterung AKDB ePay Setup: Ein Verbindungstest ist jetzt auch ohne Konfiguration eines AKDB-Mandanten möglich. |
| 388 |
|
-* Anpassung EPayment Bestellartikel: HTML-Elemente innerhalb des Widgets um 'data-' Präfix erweitert |
| 389 |
|
-* Fehlerbehebung: Session-Replacer werden bei Verarbeitung der Workflow-Ereignisse berücksichtigt. |
| 390 |
|
- |
| 391 |
|
-=== 3.3.1 === |
| 392 |
|
- |
| 393 |
|
-* 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. |
| 394 |
|
- |
| 395 |
|
-=== 3.3.0 === |
| 396 |
|
- |
| 397 |
|
-* Plugin benötigt mindestens {{formcycle/}} in der Version {{version major="7" patch="9"}}{{/version}} |
| 398 |
|
-* Erweiterung Workflow-Aktion //Bestellung übermitteln//: Möglichkeit für serverseitige Definition von Bestellpositionen |
| 399 |
|
-* Einführung AKDB ePay Setup: Je nach Umgebung (Test oder Live) werden die korrekten URL's zum WS-Endpoint und zur PayPage hinterlegt. Weiterhin kann das Zertifikat für die Anbindung des ePay-Live Systems hinterlegt werden. |
| 400 |
|
- |
| 401 |
|
-=== 3.2.0 === |
| 402 |
|
- |
| 403 |
|
-* Erweiterung EPayment Bestellartikel: Am Element ist der Gesamtpreis (Anzahl * Einzelpreis) als verstecktes Element verfügbar. Dieser kann über die CSS-Klasse 'CXOrderItemTotalPrice' eingeblendet werden. |
| 404 |
|
-* Erweiterung Anzahl-Eingabe-Element am EPayment Bestellartikel: Bei einer direkten Werteingabe wird diese sofort gegen die definierte untere und obere Wertgrenze validiert. |
| 405 |
|
- |
| 406 |
|
-=== 3.1.4 === |
| 407 |
|
- |
| 408 |
|
-* Formatierung des Rückgabewertes für den Gesamtbetrag auf #0,00 € |
| 409 |
|
- |
| 410 |
|
-=== 3.1.3 === |
| 411 |
|
- |
| 412 |
|
-* Fehlerbehebung: Es wurden Problem behoben, welche beim Öffnen von EPayment-Formularen im Designe aufgetreten sind. |
| 413 |
|
- |
| 414 |
|
-=== 3.1.2 === |
| 415 |
|
- |
| 416 |
|
-* Neuer Pluginparameter *epayment.webservice.timeout* zum Konfigurieren des Timeouts zum Webservice in Sekunden. |
| 417 |
|
- |
| 418 |
|
-=== 3.1.1 === |
| 419 |
|
- |
| 420 |
|
-* Fehlerbehebung: Bei EPayment-Artikel Objekt werden bei fehlenden Werten, Defaultwerte angenommen. |
| 421 |
|
- |
| 422 |
|
-=== 3.1.0 === |
| 423 |
|
- |
| 424 |
|
-* Neue Eigenschaften am EPayment-Artikel Objekte hinzugefügt: |
| 425 |
|
-** Pflicht-Artikel: Ein Artikel kann als Pflicht definiert werden und wird dadurch automatisch der Bestellung hinzugefügt, egal ob dieser durch Manipulation vor dem Absenden aus der Bestellung entfernt wurde |
| 426 |
|
-** Maximale Bestellmenge: Die durch den Nutzer maximal auswählbare Bestellmenge lässt sich begrenzen |
| 427 |
|
- |
| 428 |
|
-=== 3.0.1 === |
| 429 |
|
- |
| 430 |
|
-* Plugin benötigt mindestens {{formcycle/}} in der Version {{version major="7" minor="0" patch="1"}}{{/version}} |
| 431 |
|
-** Anpassungen der Validierungen im Designer für EPayment-Artikel Objekte |
| 432 |
|
- |
| 433 |
|
-=== 3.0.0 === |
| 434 |
|
- |
| 435 |
|
-* Plugin benötigt mindestens {{formcycle/}} in der Version {{version major="7" minor="0" patch="0"}}{{/version}} |
| 436 |
|
-** Neue Workflow-Aktion für Initialisierung der Bezahl-Transaktion |
| 437 |
|
-** Einführung Ereignisse für Absenden der Bestellung, sowie Verifizierung der erfolgreichen / nicht erfolgreichen Bezahltransaktion |
|
360 |
+* Wechsel von der SOAP Schnittstelle zu REST. Dadurch ist immer ein Zertifikat und Passwort notwendig sowie die Angabe der Zahlverfahren. |
|
361 |
+* Umstellung von AKDB spezifischer ePayBL Umgebung zu einer freien Festlegung der anzubindenden Umgebung. |
|
362 |
+* Umbennung aller Vorkommnisse von AKDB zu ePayBL. |
|
363 |
+* Umstellung auf System-Plugin. |
|
364 |
+* Überarbeitung der Konfigurationsoberfläche. |
