Passa al contenuto principale
Supporto OCLC

Dokumentation für ePayBL (ab V11.0)

  1. Ultimo aggiornamento
  2. Salva come PDF

Dokumentation für den Bezahldienstleister ePayBL

Allgemeines 

ePayBL ist ein Bezahldienstanbieter ähnlich den bereits integrierten Anbietern ePay21, PayOne und GiroSolotion. Die Bibliothek kann ihren Lesern ermöglichen, online zu bezahlen, um einen zusätzlichen Service anzubieten und das eigene Bargeldaufkommen zu reduzieren. Zudem ist dieser Service ein Beitrag zur E-Government-Verordnung, da es bundesweit geplant ist, zentrale E-Government-Funktionen anzubieten.

Das kostenpflichtige Modul ePayBL für OPEN bietet folgende Funktionen:

  • Eine Integration der Bezahlfunktionen

  • von ePayBL in das Leserkonto von OPEN: der angemeldete Benutzer erhält die Möglichkeit, offene Gebühren nach Angabe der gewünschten Zahlungsart über den Anbieter ePayBL zu bezahlen.

  • Die Abwicklung des Bezahlvorgangs erfolgt ausschließlich über die ePayBL - Webseiten. Von OPEN wird lediglich der Bezahlauftrag an ePayBL weitergegeben.

  • Nach Bestätigung einer eingeleiteten Transaktion von ePayBL wird der Zahlvorgang automatisch nach BIBLIOTHECAnext übernommen. Die Zahlungen werden im System als EC-Zahlung ausgewiesen und können über die bestehenden BIBLIOTHECAnext-Standardfunktionen ermittelt und ausgewertet werden.

  • Nach erfolgreicher Übergabe einer Transaktion (von OPEN nach ePayBL) wird dem Leser in OPEN eine Meldung angezeigt, welche die erfolgreiche Zahlung bestätigt.

Das vorliegende Dokument beschreibt die Nutzung der Zahlungs-Plattform ePayBL über OPEN und alle dafür notwenigen Einstellungen in OPEN und BIBLIOTHECAnext. Die hier beschriebenen Funktionen sind im Test und im Live-Betrieb verfügbar. Bitte beachten Sie, dass Sie zur Nutzung der Testfunktionalitäten separat einen Testzugang bei ePayBL beantragen müssen.

Benötigte Informationen von ePayBL

Die folgenden Informationen benötigen Sie von ePayBL und erhalten Sie von Ihrem jeweiligen Ansprechpartner dort, um diese anschließend in OPEN einzutragen (siehe Kapitel Konfiguration in OPEN):

  • Endpoint-Url

  • Mandant Nummer

  • Bewirtschafternummer

  • Buchungsliste Mahnverfahren

  • Haushaltsstelle

  • Objekt Nummer

  • Key Store File

  • Key Store Passwort

Konfiguration in OPEN

In OPEN müssen Sie folgende Einstellungen treffen, damit das Bezahlen über ePayBL funktioniert. Sie finden diese unter: Verwalten > OCLC OPEN > OCLC.OPEN.PL.DNN.SettingsModule >OPEN.PatronAccountModule > MeinKonto > Bezahlfunktion Einstellungen.

  1. Wählen Sie unter Bezahlanbieter verwenden den Anbieter ePayBL.

  2. Wenn die Bezahlfunktion zunächst getestet werden soll, aktivieren Sie die Option Testmodus aktiv. Im Testmodus fallen keine Gebühren über den Bezahldienstanbieter an und BIBLIOTHECAnext-Gebühren sind als Testgebühren gekennzeichnet.

  3. Tragen Sie im Falle des Testmodus eine Ausweisnummer eines Testnutzers ein, mit dem die Bezahlfunktion getestet wird. Dieser Nutzer hat in OPEN Zugriff auf die Bezahlung mit ePayBL. Alle anderen Benutzer sehen die Bezahlfunktion nicht. Bitte beachten Sie, dass diese Einstellungen nur für OPEN und BIBLIOTHECAnext gelten, eine weitere Konfiguration auf Seiten ePayBLs ist notwendig.

  4. Lassen Sie dieses Feld leer: IP-Range Ihres Gateways/ Proxy

  5. Tragen Sie einen Verwendungszweck ein. Als Platzhalter stehen Ihnen „Ausweisnummer“, „Benutzernr.“ und „Betrag“ zur Verfügung. Der gesamte Text darf beim Bezahldienstanbieter ePayBL sollte max. 18 Zeichen lang sein. Der konfigurierte Text erscheint im Cockpit des Bezahldienstanbieters, dem Kontoauszug des Kunden und auch auf der Webseite, die zur Bestätigung der Zahlung angezeigt wird.
    Die zulässigen Zeichen sind in Abstimmung mit den von der Bundesbank für SEPA-Zahlungen zugelassenen Zeichen:

  • a b c d e f g h i j k l m n o p q r s t u v w x y z
  • A B C D E F G H I J K L M N O P Q R S T U V W X Y Z
  • 0 1 2 3 4 5 6 7 8 9
  • +-_#/:
  • sowie das Leerzeichen (Space)

  1. Übertragen Sie folgende Daten von ePayBL in die dafür vorgesehenen Felder in OPEN:

  • Endpoint-Url

  • Mandant Nummer

  • Bewirtschafternummer

  • Buchungsliste Mahnverfahren

  • Haushaltsstelle

  • Objekt Nummer

  • Key Store File

  • Key Store Passwort

  1. Aktivieren Sie die Bezahlfunktion. Die Option bei Bezahlfunktion aktiviert muss zur Nutzung aktiviert werden, sowohl im Testmodus als auch in der produktiven Anwendung.

  2. Speichern Sie die Änderungen.

OPEN-epayBL-1.png

Durchführung von Zahlungen im Leserkonto

In BIBLIOTHECAnext gelangen Sie in der Verbuchung über das Menü Recherche > Zahlungsaufträge über OPEN zu den Zahlaufträgen.

OPEN-epayBL-2.png

Im Fenster Zahlaufträge über OPEN erhalten Sie eine Übersicht über alle Zahlaufträge zu einer Ausweisnummer. Per Doppelklick auf einen Zahlauftrag gelangen Sie in die Details zu diesem Auftrag.

 Hinweis: Da die Zahlart vom Benutzer in ePayBL gewählt wird, ist der Wert der Zahlart in BIBLIOTHECAnext immer Unknown.

OPEN-epayBL-3.png

Hier erhalten Sie eine Übersicht der Zahlungen des Lesers und des Zahlungsstatus. Ganz oben finden Sie folgende Angaben:

  • Referenznummer: Diese Nummer wird bei jedem Bezahlversuch von OPEN generiert und identifiziert einen Zahlauftrag

  • Status (Erläuterung siehe unten im Text)

  • Kennung

  • Zahlung zugeordnet

  • Zahlart

  • Modus: Angabe ob Test- oder Echtbetrieb

  • Benutzer

  • Benutzernummer

  • Ausweisnummer

Folgende Status werden verwendet:

  • Created (erstellt): wird initial von OPEN gesetzt.

  • CreatedAtProvider: Der Bezahldienstanbieter hat die Anfrage für eine neue Bezahl-Transaktion erhalten und dies gegenüer OPEN bestätigt. Wird durch den Bezahldienstanbieter gesetzt (z. B. ePayBL).

  • Paid (Bezahlt): Kennzeichnet einen erfolgreichen Abschluss seitens ePayBL

  • CancelledByBib (Stornierung durch BIBLIOTHECAnext): Wird bei manueller Sperrung des Auftrags in BIBLIOTHECAnext gesetzt.

  • Failed (fehlgeschlagen): Wird bei einem Fehler (z.B. Abbruch oder Timeout) von ePayBL gesetzt.

OPEN-epayBL-4.png

Wenn Sie auf die Schaltfläche Auftrag abschließen klicken, öffnet sich ein Fenster mit einer Sicherheitsabfrage: „Dem Zahlungsauftrag ist keine Zahlung im Gebührenjournal zugeordnet. Sind Sie sicher, dass Sie den Zahlauftrag abschließen wollen?“. Falls ja, führen Sie anschließend die Buchung der Zahlung manuell durch.

Wenn Sie Ja klicken, öffnet sich ein weiteres Fenster mit einem Hinweis: „Beachten Sie, dass es bei manchen Zahlarten längere Zeit dauert, bis ein Zahlungsauftrag vom Bezahldienstanbieter als 'Paid' gemeldet wird (siehe Legende). Möchten Sie dennoch fortfahren?“ Klicken Sie wieder auf Ja, wird der Status manuell auf Paid (bezahlt) gesetzt. Ihre Kennung wird eingetragen und ein Zeitstempel wird gesetzt. Außerdem wird ein Historieneintrag generiert, so dass diese Aktion nachvollziehbar ist.

Wenn Sie auf die Schaltfläche Auftrag stornieren klicken, wird der Zahlungsauftrag storniert.

Fehlerfall Referenznummer in BIBLIOTHECAnext

Falls es zu einem Fehler mit einer Referenznummer kommen sollte, gehen Sie bitte folgende Schritte durch, um die Fehlerursache zu finden:

Mögliche Fehlerursachen können sein:

  • Der Kunde startet eine Zahlung über ePayBL (z.B. Vorkasse) und überweist nicht.

  • Der Server ist nicht erreichbar.

Suchen Sie in BIBLIOTHECAnext nach den Fehlerursachen:

  • Suchen Sie nach der Transaktionsnummern über Ausweisnummer / Benutzernummer (Verbuchung). Abhängig von der Lizenz werden die Punkte im Menü angezeigt.

  • Hier werden Ihnen alle Detail-Informationen zum Zahlungsauftrag angezeigt.

  • Hier sehen Sie eine Historie des Zahlungsauftrags.

  • Prüfen Sie, ob eine verknüpfte Zahlungsbuchung in BIBLIOTHECAnext vorhanden ist

Übersicht der Zahlaufträge in BIBLIOTHECAnext

In BIBLIOTHECAnext gelangen Sie in der Verbuchung über das Menü Recherche > Zahlungsaufträge über OPEN zu den Zahlaufträgen.

OPEN-epayBL-5.png

Dort erhalten Sie eine Übersicht zu Zahlaufträgen aus dem ePayment in OPEN. Die Liste ist transaktions- bzw. nutzerbezogen, sprich Sie können sich über die Suchfelder Referenznr, Ausweisnr und Benutzernr die entsprechenden Transaktionen anzeigen lassen.

OPEN-epayBL-6.png

 Hinweis: Da die Auswahl der Zahlart (wie PayPal, Debit usw.) vom Benutzer nicht in OPEN, sondern in einem ePay21-Dialog vorgenommen wird, haben die aus OPEN kommenden Einträge zunächst den Status „Created“ bzw. „CreatedAtProvider“ und die Zahlart „Unknown“. Sobald die Zahlungsbestätigung von ePay21 über die ePayment-Schnittstelle zurückkommt, erfolgt ein weiterer Eintrag in den Zahlaufträgen, welcher den Status „Paid“ trägt und nun auch die vom Benutzer gewählte Zahlart aufführt.

Pro Transaktion wird in der Übersicht der aktuellste Status, sprich der letzte Eintrag angezeigt. Für den ganzen Verlauf klicken Sie bitte doppelt auf die entsprechende Zeile. Damit gelangen Sie in die Detailinformation dieses Zahlauftrags.

OPEN-epayBL-7.png

In der Detailansicht einer Transaktion finden Sie oben im Kopf des Fensters folgende Angaben:

  • Referenznummer: Diese Nummer wird bei jedem Bezahlversuch von OPEN generiert und identifiziert einen Zahlauftrag

  • Status (Erläuterung siehe unten im Text)

  • Kennung (Mitarbeiterkennung, z.B. Stornos oder manuellem Abschluss)

  • Zahlung zugeordnet (es liegt ein Zahlungseintrag im Gebührenjournal des Lesers vor)

  • Zahlart: siehe Dokumentation Ihres Bezahlanbieters. Wird keine Zahlart vom Anbieter übermittelt, ist „Unknown“ eingetragen.

  • Modus: Angabe, ob Test- oder Echtbetrieb

  • Benutzer: Nachname, Vorname

  • Benutzernummer

  • Ausweisnummer

Folgende Status werden verwendet:

  • Created (erstellt): wird initial von OPEN gesetzt.

  • CreatedAtProvider: Der Bezahldienstanbieter hat die Anfrage für eine neue Bezahl-Transaktion erhalten und dies gegenüer OPEN bestätigt. Wird durch den Bezahldienstanbieter gesetzt (z. B. ePay21).

  • Paid (bezahlt): Zahlungserfolgsmeldung des Bezahldienstanbieters; kennzeichnet einen erfolgreichen Abschluss seitens ePay21.

  • Underpaid: Bei unvollständiger Zahlung (Bezahldienstanbieter).

  • Cancelation: Zahlvorgang resultierte in einer Rückbelastung (z. B. im Fall von Lastschrift, wenn das Konto nicht gedeckt ist. Gesetzt durch den Bezahldienstanbieter).

  • CancelledByBib (Stornierung durch Bibliothek): Wird bei manueller Stornierung des Auftrags in BIBLIOTHECAnext gesetzt.

  • Failed (fehlgeschlagen): Wird bei einem Fehler (z.B. Abbruch oder Timeout) von ePay21 gesetzt.

Auftrag stornieren

Die Schaltfläche Auftrag stornieren wird benötigt, wenn bspw. bei einer Test- oder Fehlbuchung keine Fehlerbeschreibung vom Bezahlanbieter zu OPEN bzw. BIBLIOTHECAnext gelangt ist. Damit diese (Fehl)buchung nicht weiter auf ihrem alten Status wie „Created“ oder „CreatedAtProvider“ in der Übersicht stehenbleibt, wird manuell storniert. Die Bibliothek kann damit einen Statuswechsel dieses Zahlauftrags in der Übersicht bewirken, ohne Auswirkung auf den Zahlauftrag beim Bezahlanbieter oder auf das Gebührenjournal des Benutzer.

Der Status manuell stornierter Zahlaufträge erhalt den Status „CancelledByBib“, zusammen mit dem Eintrag der Mitarbeiterkennung des Stornierenden und dass dieser Vorgang über BIBLIOTHECA ausgeführt wurde.

 Wichtig: Trifft nach dem Stornieren doch noch eine „Paid“-Information vom Bezahlanbieter ein, erfolgt kein automatischer Zahlungseintrag im Gebührenjournal des Benutzers.

Auftrag abschließen und verbuchen

Es gibt Fälle, bei denen keine „Paid“ (bezahlt) Information vom Zahlanbeiter nach OPEN bzw. BIBLIOTHECAnext gelangt. Der Benutzer hat zwar online bezahlt und im Portal des Bezahlanbieters liegt nachweislich ein erfolgreich abgeschlossener Zahlungseingang vor, aber in der Übersicht der „Zahlaufträge über OPEN“ ist kein „Paid“-Eintrag zu sehen und damit auch kein diesbezüglicher Zahlungseintrag im Gebührenjournal des Benutzers in BIBLIOTHECAnext verbucht. Die bezahlte Gebühr ist damit trotz Online-Zahlung in BIBLIOTHECAnext weiter offen.

Die meisten „Paid“ Informationen gelangen innerhalb weniger Sekunden oder Minuten nach BIBLIOTHECAnext; manche können aber auch ein paar wenige Tage benötigen. Liegt auch nach ca. 9 Tagen Wartezeit keine „Paid“ Information in der Übersicht „Zahlaufträge über OPEN“ vor, hat die Bibliothek die Möglichkeit, den Zahlauftrag mit der Schaltfläche Auftrag abschließen und verbuchen von Hand zu schließen. Damit wird von BIBLIOTHECAnext sowohl ein „Paid“-Eintrag in der Übersicht generiert, als auch ein Zahlungseintrag im Gebührenjournal des Benutzers vorgenommen. Beide Einträge sind mit der Kennung des abschließenden Mitarbeiters verbucht.

Auswertung unbarer Zahlungen in BIBLIOTHECAnext

Zahlungen in BIBLIOTHECAnext werden primär zwischen „Barzahlung“ und „unbaren Zahlungen“ unterschieden. Diese Trennung ist sowohl in der Kasse, als auch in den Auswertung Zahlungen vorhanden. In letzteren erkennen Sie alle unbaren Zahlungen anhand des Kassenzeichens "E" (Spalte "ECash" zeigt E=unbare Einnahmen und T=Bareinnahmen von der Theke).

"ECash" steht in BIBLIOTHECAnext für alle unbaren Einnahmen, zu denen folgende Zahlwege gehören:

  • Zahlungen über die ePayment-Schnittstelle (gebucht unter der Zweigstelle WEB und Kennung WEB)

  • unbare Zahlungen mit der Option "ECash" aus dem Zahlfenster von BIBLIOTHECAnext (gebucht unter der Zweigstelle des Arbeitsplatzes, an dem die Buchung stattgefunden hat sowie der Mitarbeiterkennung, die diese Buchung durchgeführt hat),

  • SEPA-Lastschriften aus unserem Lastschriftmodul (erkennbar an der Gebührenart "Lastschrift")

  • Einnahmen aus Kassenautomaten und Selbstverbuchern mit Zahlfunktion, die über unsere SIP2-Schnittstelle direkt an BIBLIOTHECAnext angebunden sind (auch diese können über die Client-Einstellungen einer eindeutigen Zweigstelle und/oder Kennung zugeordnet werden, die dann für die Auswertung genutzt werden können).

In BIBLIOTHECAnext finden Sie unbare Zahlungen sowohl im Gebührenjournal des Lesers, als auch in der Kasse (als Teil der o.g. unbaren "ECash"-Einnahmen) sowie über die Ausleihe / Abschluss / Auswertung Zahlungen durch Auswahl der entsprechenden Zweigstelle und/oder Kennung.

 Tipp: Möchten Sie in den Auswertung Zahlungen konkret die ePayment-Zahlungen aus OPEN abfragen, rufen Sie diese über die Zweigstellenauswahl=WEB ab. Fügen Sie bei Bedarf das Kürzel WEB Ihrem Zweigstellenregister unter Einstellungen / Registerpflege / Werte hinzu. Nach Neustart des Hauptmoduls steht WEB im Zweigstellenregister für Abfragen zur Verfügung.

 Hinweis: Die Mitarbeiter-Kennung der unbaren Zahlungen aus der ePayment-Schnittstelle ist ebenfalls "WEB", sollte aber nicht zu Ihrer Kennungsverwaltung hinzugefügt werden, wenn es nicht zwingend für Ihre Auswertung benötigt wird. Grund: In Kennungen werden ausgeschiedene Mitarbeiter gelöscht und ihre Eintragungen in den verschiedenen Tabellen (wie Gebühren und Zahlungen) vom System automatisch anonymisiert. Wird dann versehentlich auch die Zweigstelle WEB gelöscht (weil dieser "Mitarbeiter" gerade keinem bekannt ist), können Ihre bis dato vorgenommenen ePayment-Zahlungen nicht mehr über WEB ausgewertet werden, weil die Kennung anonymisiert wurde. Wenn die WEB-Kennung dann nochmals hinzugefügt wird, sind die neuen Zahlungen ab da wieder per Kennung auswertbar. Die Zweigstelle WEB für die Auswertung zu verwenden ist also sicherer.

Weitere Informationen

  • Zertifikatsdatei: (Format *.p12), muss auf dem Server, auf dem OPEN installiert ist, abgelegt werden und in der Konfiguration von ePayBL angegeben werden.

     Wichtig: Der Network Service bzw. der "User", unter dem der DNN-Prozess (w3wp...) läuft, muss Zugriffsberechtigung auf diese Datei haben! Läuft der AppPool unter der Identity ApplicationPoolIdentity, dann müssen die User IIS_IUSRS und IIS AppPool\<name_open> auf die Datei berechtigt werden! Hierbei müssen ggf. auch Firewalls berücksichtigt werden.

  • Bei ePayBL nachgelagerten Systemen (SAP etc.) wird oft nach dem Kriterium Kassenzeichen/Buchungstext gesucht. Daher ist es ratsam, dem Buchungstext keine Leerzeichen mitzugeben.

  • Der Buchungstext entspricht dem Verwendungszweck und erscheint bei der Buchung auf der Paypage. Manche Paypages zeigen noch einen übergeordneten Verwendungszweck an. Dieser besteht dann aus dem Buchungstext der 1. Buchung.