Skip to main content
OCLC Support

Dokumentation für PayOne (ab OPEN V11.0)

  1. Letzte Aktualisierung
  2. Als PDF speichern

Allgemeines zu PAYONE

PAYONE ist ein Bezahldienstanbieter ähnlich den bereits integrierten Anbietern ePayBL, ePay21, heidelpay oder GiroCheckout. Sie haben das kostenpflichtige Modul PAYONE für OPEN erworben und damit folgende Funktionen:

  • Eine Integration der Bezahlfunktionen von PAYONE 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 PAYONE zu bezahlen.
  • Die in OPEN angebotenen PAYONE-Zahlungsarten können von Administratoren der Bibliothek im OPEN-Portal frei konfiguriert werden. Prinzipiell werden die folgenden von PAYONE angebotenen Zahlungsarten unterstützt: Lastschrift-, Kreditkarten- und e-Wallet-Zahlung wie PayPal und paydirekt.
  • Die Abwicklung des Bezahlvorgangs erfolgt ausschließlich über die PAYONE -Webseiten. Von OPEN wird lediglich der Bezahlauftrag an PAYONE weitergegeben.
  • Nach Bestätigung einer eingeleiteten Transaktion von PAYONE 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 PAYONE) wird dem Leser in OPEN eine Meldung angezeigt, welche die erfolgreiche Zahlung bestätigt.

Das vorliegende Dokument beschreibt die Nutzung der Zahlungsplattform PAYONE über OPEN und alle dafür notwendigen Einstellungen in PAYONE, OPEN und BIBLIOTHECAnext. Die hier beschriebenen Funktionen sind im Test und im Live-Betrieb verfügbar.

 Wichtig:  Wenn Sie Anfragen im Live-Betrieb durchführen, so werden diese bei Ausführung auch weitergeleitet - auch mit Testdaten. So können Kosten entstehen. Kontrollieren Sie daher stets, ob Sie sich im korrekten Modus befinden, bevor Sie Vorgänge anstoßen.

Führen Sie die notwendigen Einstellungen nacheinander so durch, wie in diesem Dokument beschrieben.

Konfiguration des Kunden-Accounts bei PAYONE

Rufen Sie das PAYONE-Portal auf, melden sich an und nehmen in Ihrem PAYONE-Kundenaccount folgende Einstellungen vor bzw. notieren die benötigten Daten:

  1. Notieren Sie sich die ID des Zahlungsportals (das ist die PAYONE Merchant Interface-ID).
  2. Tragen Sie die Absender-E-Mailadresse der Bibliothek ein. Ihre Leser bekommen Bestätigungs-E-Mails von dieser E-Mailadresse
  3. Wählen Sie als Verfahren Hashwert-Prüfung sha2-384 (empfohlen) aus.
  4. Tragen Sie bei Transaktionsstatus-URL die URL aus den OPEN-Settings ein (unter Bezahlfunktion > Einstellungen - über rechte Maustaste > Kontextmenü > Link kopieren).
  5. Beachten Sie bitte, dass Sie das klassische Frontend https://secure.pay1.de/frontend/ deaktivieren lassen müssen und das PAYONE Frontend hosted-iFrame https://frontend.pay1.de/frontend/v2/ aktiviert sein muss. Hierbei kann PAYONE Sie unterstützen.

API-Parameter

Notieren Sie sich die Merchant-ID (das ist die PAYONE Merchant Account ID) bzw. die Nummer, die bei Sub-Accounts angegeben wird. Diese Nummer müssen Sie später in der OPEN-Konfiguration eintragen (siehe Kapitel Konfiguration in OPEN).

 Hinweis: Bei Fragen zur Bedienung des PAYONE-Portals, wenden Sie sich bitte an Ihren Ansprechpartner bei PAYONE.

Nachvollziehbarkeit der Zahlung

Sie haben die Möglichkeit über den PAYONE-Account alle Transaktionen nach Excel zu exportieren, inkl. Kundenreferenznummer (der Parameter lautet „referenceid“).

  • Klicken Sie dazu im PAYONE-Account im Menü links auf Export > Zahlungsvorgänge.
  • In BIBLIOTHECAnext können Sie unter Verbuchung > Recherche ebenfalls nach Zahlungen über PAYONE suchen.
PAYONE-1.png
Abbildung 1: BIBLIOTHECAnext Fenster PAYONE-Zahlung

Konfiguration in OPEN

In OPEN müssen Sie folgende Einstellungen treffen, damit das Bezahlen über PAYONE funktioniert.

Sie finden diese unter: Administration / O-CLC.OPEN.PL.DNN.SettingsModule / OPEN.PatronAccountModule / MeinKonto 

 Gehen Sie wie folgt vor:

  1. Wählen Sie unter Bezahlanbieter verwenden den Anbieter Payone.
  2. Wenn die Bezahlfunktion zunächst getestet werden soll, aktivieren Sie die Option Testmodus. Im Testmodus fallen keine Gebühren über den Bezahldienstanbieter an und BIBLIOTHECAnext-Gebühren sind als Testgebühren gekennzeichnet. Die Option bei Bezahlfunktion aktiviert muss zur Nutzung aktiviert werden, sowohl im Testmodus als auch in der produktiven Anwendung.
  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 PAYONE. Alle anderen Benutzer sehen die Bezahlfunktion nicht.
  4. Falls Ihr OPEN über einen Proxy-Server erreichbar ist, tragen Sie die entsprechende IP-Range Ihres Gateways/Proxys in das dafür vorgesehene Feld ein.
  5. Tragen Sie einen Verwendungszweck ein. Als Platzhalter stehen Ihnen „Ausweisnummer“, „Benutzernr.“ und „Betrag“ zur Verfügung. Der gesamte Text darf beim Bezahldienstanbieter PAYONE max. 255 Zeichen lang sein. Der konfigurierte Text erscheint im Cockpit des PSPs, im 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. Füllen Sie die weiteren Felder aus:
  • PAYONE Key: Den Key des PAYONE Zahlungsportals finden Sie im PAYONE-Merchant-Interface unter Konfiguration > Zahlungsportale > Erweitert > Key
  • PAYONE Merchant Account ID: Übernehmen Sie die Account ID (AID) aus Ihrer PAYONE Merchant Interface Konfiguration. Falls Sie Sub-Accounts einsetzen, nehmen Sie die ID eines Sub-Account (siehe Abschnitt API-Parameter). 

    PAYONE-2.png
    Abbildung 2: Einstellungen für PAYONE (Bezahlfunktion Einstellungen) in OPEN
     
  • Die Host-URL ist bereits voreingestellt (nicht ändern)
  • Der IP-Range von PAYONE: Dieser Range wird von PAYONE zur Verfügung gestellt und sollte so übernommen werden. 
  • IP-Range Ihres Gateways/Proxys: Dieser Range sollte angegeben werden, wenn OPEN über einen Gateway oder Proxy erreicht wird. Lässt dieser alle Adressen durch, lassen Sie das Feld leer. Ansonsten geben Sie hier den Bereich an:

     Wichtig: Bitte beachten Sie das IP-Bereiche in dieser Schreibweise angegeben werden müssen: z. B. 1.2.3.0. 
    Ungültig sind Angaben wie z.B. 1.2.3.4 - 1.2.5.5 oder 1.2.3.4/22. 

  • Legen Sie den Mehrwertsteuers fest (Dezimal-Zahl möglich).

     Achtung:

    • Bitte übertragen Sie den in OPEN angezeigten URL-Transaktionsstatus per rechtem Mausklick / kopieren ins PAYONE-Portal > Konfiguration Zahlungsportale > Registerkarte Erweitert.

    Bitte beachten Sie, dass dies nur mit der externen URL funktioniert. Rufen Sie deshalb auch in Ihrer Bibliothek ihr OPEN auch mit der externen URL auf und kopieren Sie dann die Transaktionsstatus-URL.


    PAYONE-3.png
    Abbildung 3: Transaktionsstatus-URL (hier ausgegraut)
     

     Hinweis: Stellen Sie sicher, dass die in OPEN konfigurierte Währung für den Bezahldienst verwendet wird (siehe Abbildung 4). 


    PAYONE-4.png
    Abbildung 4: OPEN - Währung einstellen

Übersicht der Zahlaufträge in BIBLIOTHECAnext

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

PAYONE-5.png
Abbildung 5: Recherche > Zahlaufträge über OPEN

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

PAYONE-6.png
Abbildung 6: Fenster Zahlung über PAYONE in BIBLIOTHECAnext – Übersicht über Zahlaufträge zu einer Ausweisnr.

PAYONE-7.png
Abbildung 7: Details zu einem PAYONE Zahlungsauftrag


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 
  • Kennung
  • Zahlung zugeordnet
  • Zahlart
  • Modus: Angabe ob Test- oder Echtbetrieb
  • Benutzer
  • Benutzernummer
  • Ausweisnummer

Folgende Status werden verwendet:

  • Created (erstellt): wird initial von OPEN gesetzt
  • Appointed (erfolgreiche Initiierung des Zahlungsvorgangs): wird von PAYONE beim Start des Zahlungsvorgangs gesetzt
  • Paid (Bezahlt): Kennzeichnet einen erfolgreichen Abschluss seitens PAYONE
  • Underpaid (Zu wenig bezahlt): Bei unvollständiger Zahlung seitens PAYONE
  • Cancelation (Stornierung): Zahlungsvorgang resultierte in einer Rückbelastung (z.B. in dem Fall, dass das Konto nicht gedeckt ist), wird durch PAYONE gesetzt.
  • CancelledByBib (Stornierung durch BIBLIOTHECAnext):Wird bei manueller Sperrung des Auftrags in BIBLIOTHECAnext gesetzt.
  • Failed (fehlgeschlagen): Wird bei einem Fehler von PAYONE gesetzt

In BIBLIOTHECAnext werden folgende Zahlungsarten aufgeführt:

  • elv –  Lastschrift: SEPA-Lastschrift kann mehrere Tage dauern
  • cc – Kreditkarte: Zahlvorgang i.d.R. innerhalb von Minuten abgeschlossen
  • wlt – E-Wallet: Zahlvorgang i.d.R. innerhalb von Minuten abgeschlossen
  • sb – Sofort-Überweisung: Zahlvorgang i.d.R. innerhalb von Minuten abgeschlossen
  • vor – Vorkasse: Zahlvorgang kann mehrere Tage dauern
  • rec – Rechnung: Zahlvorgang kann mehrere Tage dauern

Wenn Sie auf die Schaltfläche Auftrag abschließen und verbuchen 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 von PAYONE 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.

Auftrag abschließen und verbuchen

Es gibt Fälle, bei denen keine „Paid“ (bezahlt) Information vom Zahlanbieter 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 BIBLIO-THECAnext 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 BIBLIOTHE-CAnext 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.

Fehlerfall Transaktionsnummer 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 PAYONE (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 auch eine Historie des Zahlungsauftrags.
  • Prüfen Sie, ob eine verknüpfte Zahlungsbuchung in BIBLIOTHECAnext vorhanden ist.

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 Auswertung 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 Zahlungswege 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 BIBLIOTHE-CAnext (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ön-nen).

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 sie 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.