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 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 Verbindungen

Um die Workflow-Aktion des Plugins verwenden zu können, muss zuerst in der ePayBL Verwaltungsoberfläche eine Verbindung angelegt werden. Diese enthält die Pflichtangaben Namen und URL sowie ePayBL Daten und Zertifikat.

Name

• Der Name wird in der Auswahlmöglichkeit der Workflow-Aktion angezeigt.

URL des Providers

• Die URL der anzubindenen Umgebung.
• 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.

Bewirtschafter-Nummer

• Die Bewirtschafter-Nummer ist den ePayBL Vertragsdaten zu entnehmen.

Haushaltsstelle (nur in Plugin Version < 5.6.0)

• Die Haushaltsstelle ist den ePayBL Vertragsdaten zu entnehmen.

Objekt-Nummer (nur in Plugin Version < 5.6.0)

• Die Objekt-Nummer ist den ePayBL Vertragsdaten zu entnehmen.

Kennzeichen-Mahnverfahren

• Das Kennzeichen-Mahnverfahren ist den ePayBL Vertragsdaten zu entnehmen.

Fälligkeit in

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

Verwendungszweck

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

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.