Inhalt

Damit das ePayment in FORMCYCLE eingerichtet werden kann, muss zuvor ein Vertrag mit einem ePayBL Anbieter geschlossen werden.

Ist bereits ein Vertrag über das ePayment mit dem ePayBL Anbieter vorhanden, so kann dieser herangezogen werden und mit dem Schritt der initialen Installation fortgesetzt werden.

Voraussetzungen

• Es wurde ein Vertrag über das ePayment mit einem ePayBL Anbieter geschlossen und die notwendigen Vertragsdaten liegen vor.
• Für die Anbindung muss zusätzlich ein Zertifikat für den Zugriff auf den Payment-Webservice vorhanden sein sowie ggf. IP und Port des Proxy.
  • Sollte bereits das Live-System vom AKDB Bürgerkonto-Service / Postkorb angebunden sein, so kann dieses Zertifikat für den Zugriff verwendet werden.
• Eine Verbindung zum Plugin-Store kann aufgebaut werden.

Installation

Das Plugin muss unter System installiert werden!

• Anmeldung als sadmin am FORMCYCLE-System.
• Unter Systemeinstellungen zum Menüpunkt Plugins navigieren und öffnen Sie den Plugin-Store.
• Suchen Sie nun nach ePayBL und installieren Sie das Plugin.
• Falls Sie bereits die Version 4.0.x installiert haben, können Sie genau so Ihr Plugin aktualisieren.
• Jetzt ist ein neuer Menüpunkt ePayBL Setup vorhanden, welcher aufgerufen werden muss.
  

  Hinweis: Sollte der Menüpunkt nicht sofort ersichtlich sein, ist ein Abmelden und anschließendes Anmelden als sadmin notwendig.

ePayBL Setup

Um die Workflow-Aktion des Plugins verwenden zu können, müssen zuerst in der ePayBL Setup Verwaltungsoberfläche Ihre Vertragsdaten, Zertifkat und Provider hinterlegt werden. 

Zuerst können als sadmin Daten eingetragen werden, die systemweit gelten. In einem Mandant sind diese Daten als Platzhalter ersichtlich und können (für diesen Mandant) überschrieben werden. Da das ePayBL Setup komplettiert werden muss, sind alle anderen Eingabefelder nun Pflichtfelder.

URL des Providers

• Die URL der anzubindenen Umgebung. Default-Wert wird als Platzhalter angezeigt.
• Für die Anbindung ePayBL-Systeme der AKDB muss hier https://infra-pre.buergerserviceportal.de für das Testsytem und https://epay.akdb.de für das Livesystem eingetragen werden.

Zeit (in Minuten) für Ausführung eines Server Notification Jobs nach dessen Registrierung (ab Plugin-Version 5.4.2)

• Hier kann die Zeit (in Minuten) für Ausführung eines Server-Notification-Jobs, nach dessen Registrierung, hinterlegt werden. 
• Der Notification-Job wird bei einer Server-to-Server Kommunikation registriert und ermöglicht die Workflow-Ausführung auch wenn der Nutzer die Rückleitung von der PayPage zu formcycle zuvor abgebrochen hat, beispielsweise durch Schließen des Browsers. 
• Die Server-to-Server Kommunikation muss durch die angebundene ePayBL-Version unterstützt werden. Ob dies der Fall ist, können Sie bei ihrem jeweiligen ePayBL Anbieter erfragen.

Mandant-Nummer

• Die Mandant-Nummer ist den ePayBL Vertragsdaten zu entnehmen. Default-Wert wird als Platzhalter angezeigt.

Bewirtschafter-Nummer

• Die Bewirtschafter-Nummer ist den ePayBL Vertragsdaten zu entnehmen. Default-Wert wird als Platzhalter angezeigt.

Haushaltsstelle

• Die Haushaltsstelle ist den ePayBL Vertragsdaten zu entnehmen. Default-Wert wird als Platzhalter angezeigt.

Objekt-Nummer

• Die Objekt-Nummer ist den ePayBL Vertragsdaten zu entnehmen. Default-Wert wird als Platzhalter angezeigt.

Kennzeichen-Mahnverfahren

• Das Kennzeichen-Mahnverfahren ist den ePayBL Vertragsdaten zu entnehmen. Default-Wert wird als Platzhalter angezeigt.

Fälligkeit in

• Der Fälligkeitszeitraum ist frei wählbar. Default-Wert wird als Platzhalter angezeigt.
• Setzt sich aus einem Wert und einer Einheit zusammen (Tage, Stunden oder Minuten).

Verwendungszweck

• Der Buchungstext ist frei wählbar. Default-Wert wird als Platzhalter angezeigt.
• Eingabe muss dem Pattern ^[\w\-\./+\ @,\:\&\'\?\#{}\(\)\[\]\u00C0-\u017F\u1E9E]*$ entsprechen
  

Unterstütze Zahlverfahren (nur noch bei alten Plugin-Version < 5.1.0)

• Eingrenzung der Zahlverfahren nötig. Diese Option wurde mit Plugin-Version 5.1.0 entfernt. In neueren Plugin-Versionen werden Zahlverfahren automatisch über die REST-API ermittelt.

Zertifikat

• Dieses muss im Format p12 sein. Name des Default-Zertifikats wird angezeigt.

Passwort

• Passwort zum entschlüsseln des Zertifikats.

Hostname oder IP des zu verwenden Proxy-Servers

• Der Hostname oder die IP. Default-Wert wird als Platzhalter angezeigt.

Port

• Der Port zum Proxy-Host. Default-Wert wird als Platzhalter angezeigt.

Sollte ein Proxy-Server auch für die Kommunikation von anderen Web-Diensten notwendig sein, so kann auch ein system-weiter Proxy-Server konfiguriert werden.

Hinweise zur Erreichbarkeit notwendiger System-URLs
Bitte konfigurieren Sie gegebenenfalls ihre Firewall hinsichtlich der Erreichbarkeit der nachfolgenden URL(s).

Folgende URL(s) müssen von Extern erreichbar sein, damit eine Rückmeldung vom ePayBL-Portal korrekt verarbeitet werden kann:
 
https://<Domain-Adresse des Master-Servers>/formcycle/plugin (Master-Server)
ODER
https://<Domain-Adresse des Frontend-Servers>/frontend-server/plugin (Frontend-Server)
Die URL der anzubindenden Umgebung muss vom FORMCYCLE Master-Server aus erreichbar sein.