Payments

mention Payments ruft Ihre PayPal-Zahlungen ab und übergibt sie als Kontoauszug an die mention Warenwirtschaft. Dort ordnet die PayPal-Automatik jede Zahlung dem passenden Beleg zu. Außerdem zahlt mention Payments Zahlungsaufträge aus der Warenwirtschaft über PayPal aus.

Das Programm hat zwei Teile. In der Anwendung Mention Payments legen Sie Konten an und sehen, was passiert ist. Die eigentliche Arbeit erledigt der Hintergrunddienst Mention Payments Daemon. Er läuft als Windows-Dienst, auch wenn niemand am Rechner angemeldet ist, und startet die Abrufe nach Zeitplan. Ohne laufenden Dienst passiert nichts.

Voraussetzungen

• Windows in der 64-Bit-Version, für die Installation mit Administratorrechten
• eine installierte mention Warenwirtschaft, deren SQL Server vom Rechner aus erreichbar ist
• eine Lizenz für mention Payments. Jedes PayPal-Konto belegt einen Platz der Lizenz.
• ein Benutzer der mention Warenwirtschaft, dem mindestens ein Mandant zugeordnet ist
• ein PayPal-Geschäftskonto mit einer REST-App, siehe Zugangsdaten bei PayPal anlegen
• Internetzugang zu PayPal und zum Lizenzserver von mention

Installation

Führen Sie das Installationspaket Mention.Payments-<Version>-win.msi aus. Es installiert mention Payments für alle Benutzer des Rechners, richtet den Hintergrunddienst mit automatischem Start ein und legt die Verknüpfung Mention Payments an. Starten Sie das Programm immer über diese Verknüpfung.

Nach der Anmeldung prüft mention Payments, ob eine neue Version bereitsteht. Gibt es eine, fragt das Programm nach. Mit Jetzt aktualisieren hält es den Hintergrunddienst kurz an, installiert die neue Version und startet den Dienst wieder. Während der Aktualisierung ruft mention Payments keine Transaktionen ab. Mit Später fragt es beim nächsten Start erneut.

Erster Start

Warenwirtschaft auswählen

Beim ersten Start fragt mention Payments nach dem Installationsordner der mention Warenwirtschaft. Gemeint ist der Ordner mit der Datei dspath.dbf. Das Ordnersymbol neben dem Feld öffnet die Ordnerauswahl von Windows.

Abb.: Installationsordner der Warenwirtschaft auswählen

Nach einem Klick auf Speichern prüft mention Payments die Verbindung zur Datenbank und legt dort die Tabellen an, die es braucht. Danach startet die Anwendung neu. Der Ordner gilt für alle Benutzer des Rechners und für den Hintergrunddienst. Sie wählen ihn also nur einmal.

Lizenz aktivieren

Findet mention Payments in der Warenwirtschaft noch keinen Lizenzschlüssel, erscheint Lizenz aktivieren. Tragen Sie den Lizenzschlüssel ein, den Sie von mention erhalten haben, und klicken Sie auf Speichern. Die Anwendung startet danach neu.

Abb.: Lizenzschlüssel eintragen

Anmelden

Melden Sie sich mit Benutzername und Passwort der mention Warenwirtschaft an. mention Payments verlangt die Anmeldung bei jedem Start.

Abb.: Anmeldung

Sind Sie mehreren Mandanten zugeordnet, wählen Sie danach den Mandanten und klicken auf Auswählen. Ein Doppelklick auf die Zeile tut dasselbe. Mit nur einem Mandanten entfällt dieser Schritt. mention Payments zeigt immer nur die Konten des gewählten Mandanten.

Abb.: Mandant auswählen

Die Übersicht

Nach der Anmeldung sehen Sie die Übersicht Ihrer Konten. Beim ersten Start ist sie leer.

Abb.: Übersicht ohne Konten

Schaltfläche	Funktion
Aktualisieren	Lädt die Konten neu. Die Übersicht aktualisiert sich außerdem alle 45 Sekunden von selbst.
Dienst	Öffnet die Steuerung des Hintergrunddienstes. Ein grüner Punkt heißt, dass der Dienst läuft.
Einstellungen	Öffnet die globalen Einstellungen.
Neu	Legt ein neues Konto an.

PayPal-Konto einrichten

Ein Konto in mention Payments gehört zu genau einem PayPal-Geschäftskonto. Bis die ersten Zahlungen in der Warenwirtschaft ankommen, sind vier Schritte nötig. Sie legen bei PayPal eine App an, legen in mention Payments das Konto an, tragen die Zugangsdaten ein und stellen einen Zeitplan ein.

Zugangsdaten bei PayPal anlegen

mention Payments greift über die REST-Schnittstelle von PayPal auf Ihr Konto zu. Dafür brauchen Sie eine Client ID und ein Secret.

1. Melden Sie sich unter developer.paypal.com mit Ihrem PayPal-Geschäftskonto am Dashboard an.
2. Öffnen Sie Apps & Credentials und stellen Sie oben auf Live. Unter Sandbox finden Sie die Testumgebung von PayPal mit eigenen Apps und eigenen Zugangsdaten.
3. Legen Sie mit Create App eine App an.
4. Achten Sie darauf, dass in den Einstellungen der App die Funktion Transaction Search eingeschaltet ist. Ohne sie darf mention Payments keine Transaktionen abrufen. Wenn Sie Zahlungsaufträge über PayPal auszahlen wollen, schalten Sie auch Payouts ein.
5. Kopieren Sie Client ID und Secret der App.

Konto anlegen

Klicken Sie in der Übersicht auf Neu. Geben Sie dem Konto einen Namen, zum Beispiel den Namen Ihres Shops, und wählen Sie als Provider PayPal. Klicken Sie dann auf Speichern.

Abb.: Neues Konto anlegen

Das Konto erscheint als Karte in der Übersicht. Unten links zeigt die Karte den Status des letzten Laufs, bei einem neuen Konto Noch keine Läufe. Später steht dort zum Beispiel Fehlerfrei, Fehlgeschlagen oder Läuft.

Abb.: Übersicht mit einem Konto

Jedes Konto belegt einen Platz Ihrer Lizenz. Ist kein Platz mehr frei, lässt sich kein weiteres Konto anlegen.

Zugangsdaten eintragen

Klicken Sie auf die Karte oder auf das Zahnrad. Das Konto öffnet sich in einem eigenen Fenster mit den Reitern Einstellungen, Pipelines und Transaktionen.

Auf dem Reiter Einstellungen sind alle Felder zunächst gesperrt. Oben rechts liegen drei Symbole. Der Stift schaltet die Bearbeitung ein, das Kreuz verwirft Ihre Änderungen und die Diskette speichert sie. Bereiche mit geänderten Werten markiert mention Payments mit Ungespeicherte Änderungen.

Abb.: Zugangsdaten eintragen und Kontoauszug-Export einschalten

1. Klicken Sie auf den Stift.
2. Wählen Sie unter Umgebung den Eintrag Live. Neue Konten stehen auf Sandbox, der Testumgebung von PayPal.
3. Tragen Sie Client ID und Secret Ihrer PayPal-App ein.
4. Schalten Sie unter Kontoauszug-Export (KAEINLXML) den Schalter Aktiviert ein. Bei neuen Konten ist er aus, und solange er aus ist, kommt in der Warenwirtschaft nichts an.
5. Klicken Sie auf die Diskette.

mention Payments speichert das Secret verschlüsselt. Nach dem Speichern bleibt das Feld leer, obwohl das Secret hinterlegt ist. Sandbox und Live haben getrennte Zugangsdaten. Wenn Sie die Umgebung wechseln, bleiben die Zugangsdaten der anderen Umgebung erhalten.

Alle Einstellungen eines Kontos

Abb.: Reiter Einstellungen eines Kontos

Einstellung	Bedeutung
Mention-Benutzer	Mit diesem Benutzer meldet sich mention Payments bei der Warenwirtschaft an. Vorbelegt ist der Benutzer, der das Konto angelegt hat.
Umgebung	Sandbox zum Testen, Live für echte Zahlungen.
Client ID und Secret	Die Zugangsdaten Ihrer PayPal-App.
Aktiviert	Übergibt die Transaktionen als Kontoauszug an die Warenwirtschaft. Ist der Export aus, bleibt auch der Pending Check untätig.
Backfill-Tage	Steuert, ob der Pending Check Transaktionen nachträglich exportiert, deren Kontoauszug fehlt. Mit 0 schalten Sie das ab.
Buchungskonto-Override	Mit Automatik (kein Override) entscheidet die Warenwirtschaft, gegen welches Bankkonto sie bucht. Wählen Sie ein Bankkonto des Mandanten, bucht sie immer gegen dieses Konto.
Log-Level	Wie ausführlich mention Payments die Abläufe dieses Kontos protokolliert. Systemstandard verwenden übernimmt den Wert aus den globalen Einstellungen.
Fehler direkt an Mention senden	Schickt Fehler dieses Kontos automatisch an mention. Systemstandard verwenden übernimmt den globalen Wert.

Ganz unten entfernt Konto löschen das Konto. mention Payments löscht dabei auch alle Läufe und alle abgerufenen Transaktionen des Kontos, und das lässt sich nicht rückgängig machen. Vorher fragt das Programm noch einmal nach. Solange eine Pipeline des Kontos läuft, ist die Schaltfläche gesperrt.

Zeitplan festlegen

Ein neues Konto ruft noch nichts von selbst ab, weil Transaction Sync und Pending Check keinen Zeitplan haben. Auf dem Reiter Pipelines steht dann Angehalten · kein Intervall konfiguriert. Diesen Schritt vergisst man leicht.

1. Öffnen Sie den Reiter Pipelines und klicken Sie auf PayPal Transaction Sync.
2. Wechseln Sie oben auf Einstellungen und klicken Sie auf den Stift.
3. Tragen Sie unter Intervall ein, wie oft die Pipeline laufen soll, zum Beispiel alle 15 Minuten.
4. Klicken Sie auf die Diskette.

Abb.: Zeitplan für PayPal Transaction Sync

Richten Sie PayPal Pending Check genauso ein. Dort genügt ein längeres Intervall, zum Beispiel eine Stunde.

Die übrigen Felder brauchen Sie nur in besonderen Fällen.

• Wochentage beschränkt die Läufe auf bestimmte Tage. Ohne Auswahl läuft die Pipeline jeden Tag.
• Pausenfenster legt eine Zeitspanne fest, in der die Pipeline nicht startet, etwa während der nächtlichen Datensicherung.
• Erster Lauf bestimmt, wie viele Tage der allererste Abruf zurückreicht. Vorgabe sind 30 Tage. Liegen in der Warenwirtschaft schon PayPal-Kontoauszüge aus einer früheren PayPal-Schnittstelle, setzt mention Payments beim letzten vorhandenen Kontoauszug an und holt nichts doppelt.

Pipelines

Die Abläufe eines Kontos heißen in mention Payments Pipelines. Der Reiter Pipelines zeigt für jede Pipeline den letzten Lauf und den Zeitplan.

Abb.: Reiter Pipelines mit Status und Zeitplan

Pipeline	Aufgabe	Start
PayPal Transaction Sync	Ruft die neuen Transaktionen seit dem letzten Lauf ab und übergibt sie als Kontoauszug an die Warenwirtschaft.	nach Zeitplan oder von Hand
PayPal Pending Check	Fragt ausstehende Transaktionen erneut bei PayPal ab und übernimmt den neuen Status. Exportiert außerdem Transaktionen, deren Kontoauszug fehlt.	nach Zeitplan oder von Hand
PayPal Mass Payment	Zahlt die offenen Zahlungsaufträge aus der Warenwirtschaft über PayPal aus. Gehört zu einem Auftrag eine frühere PayPal-Zahlung, erstattet mention Payments diese Zahlung. Sonst überweist es den Betrag als PayPal-Auszahlung.	aus der Warenwirtschaft oder von Hand
PayPal DoRevision	Ruft die Transaktionen der letzten 7 Tage erneut ab, ergänzt fehlende Angaben wie E-Mail-Adresse, Rechnungs-ID oder Gebühr und übergibt geänderte Transaktionen erneut.	nur von Hand
PayPal Run Cleanup	Löscht alte Läufe und ihre Protokolle.	täglich

Run Cleanup hebt erfolgreiche Läufe 30 Tage auf, höchstens 100 pro Pipeline, und fehlgeschlagene Läufe 90 Tage. Den neuesten Lauf jeder Pipeline löscht es nie. Die Fristen ändern Sie in den Einstellungen der Pipeline PayPal Run Cleanup unter Aufbewahrung.

Pipeline von Hand starten

Klicken Sie auf eine Pipeline. Oben rechts liegen drei Schaltflächen. Der Kreispfeil aktualisiert die Ansicht. Das Dreieck heißt Jetzt ausführen und startet sofort einen Lauf. Das Quadrat heißt Abbrechen und beendet einen laufenden Lauf.

Beides funktioniert nur, wenn der Hintergrunddienst läuft. Jede Pipeline hat höchstens einen Lauf zur Zeit. Solange einer läuft, ist Jetzt ausführen gesperrt.

Läufe und Protokoll

Unter Läufe stehen alle Läufe der Pipeline, der neueste oben. Mit Status und Zeitraum filtern Sie die Liste.

Abb.: Läufe von PayPal Transaction Sync

Ein Klick auf einen Lauf zeigt links seine einzelnen Schritte. Wählen Sie einen Schritt aus, erscheint rechts sein Protokoll. Das Symbol über dem Protokoll kopiert es in die Zwischenablage, praktisch für eine Anfrage an den Support. Ist ein Lauf fehlgeschlagen, schickt Fehler an Mention senden den Fehler direkt an mention.

Abb.: Schritte und Protokoll eines Laufs

Transaktionen

Der Reiter Transaktionen zeigt die abgerufenen PayPal-Transaktionen des Kontos, die neueste oben. Beim Öffnen sehen Sie die letzten 30 Tage.

Abb.: Transaktionsliste mit Details der ausgewählten Transaktion

• Das Suchfeld oben rechts findet Transaktionen über die Transaktions-ID oder über Name oder E-Mail-Adresse des Zahlers.
• Der Trichter an der Spalte Datum wählt einen anderen Zeitraum. Mit Zeitraum ignorieren sehen Sie alle Transaktionen.
• Der Trichter an der Spalte Status filtert nach Abgeschlossen, Ausstehend, Abgelehnt, Storniert und Abgebrochen.

Klicken Sie auf eine Transaktion, zeigt der untere Bereich ihre Details. Dazu gehören der Zahler, Gebühr und Nettobetrag, die Rechnungs-ID sowie PayPal-Angaben wie Zahlungsmittel und Käuferschutz. Das Symbol rechts neben dem Datum kopiert die Transaktions-ID.

Was in der Warenwirtschaft passiert

mention Payments bucht nicht selbst. Es schreibt jede Transaktion als Kontoauszug-Datensatz in die Tabelle KAEINLXML der Warenwirtschaft. Die PayPal-Automatik der mention Warenwirtschaft liest diese Datensätze ein und sucht den passenden Beleg. Dafür vergleicht sie unter anderem die PayPal-Transaktions-ID mit der externen Referenz und der Zahlungsreferenz des Belegs, die E-Mail-Adresse des Käufers und die Rechnungs-ID.

Ist eine Transaktion noch ausstehend oder wurde sie abgelehnt, bucht die Warenwirtschaft sie nicht und vermerkt nur einen Hinweis am Beleg. Den späteren Status holt der Pending Check.

Globale Einstellungen

Die Schaltfläche Einstellungen in der Übersicht öffnet die Einstellungen, die für alle Konten gelten. Auch hier schaltet der Stift die Bearbeitung ein und die Diskette speichert.

Abb.: Globale Einstellungen

Einstellung	Bedeutung	Vorgabe
Standardsprache	Sprache der Oberfläche, Deutsch oder Englisch. Die neue Sprache gilt überall erst nach einem Neustart von mention Payments.	Deutsch
Log-Level	Wie ausführlich mention Payments protokolliert, in den Stufen Information, Warnung und Fehler. Ein Konto kann einen eigenen Wert haben.	Information
Fehler direkt an Mention senden	Schickt Fehler automatisch an mention. Der Support sieht sie dann, ohne dass Sie ein Protokoll schicken müssen. Ein Konto kann einen eigenen Wert haben.	Aus

Häufige Probleme

Hintergrunddienst nicht installiert oder angehalten

Abb.: Hinweis in der Übersicht, wenn der Hintergrunddienst fehlt

Ohne laufenden Hintergrunddienst startet keine Pipeline, weder nach Zeitplan noch von Hand. Der Punkt an Dienst ist dann rot oder grau. Klicken Sie auf Dienst verwalten oder in der Leiste auf Dienst.

Abb.: Steuerung des Hintergrunddienstes

• Steht dort Nicht installiert, klicken Sie auf Registrieren. mention Payments richtet den Dienst mit automatischem Start ein.
• Steht dort Angehalten, klicken Sie auf Starten.

Meldet mention Payments Zugriff verweigert, starten Sie mention Payments als Administrator und registrieren den Dienst erneut. Meldet es, dass der Dienst nicht gefunden wurde, installieren Sie mention Payments neu.

Es kommen keine Transaktionen an

Prüfen Sie der Reihe nach:

1. Läuft der Hintergrunddienst? Der Punkt an Dienst in der Übersicht muss grün sein.
2. Hat PayPal Transaction Sync einen Zeitplan? Bei Angehalten · kein Intervall konfiguriert fehlt das Intervall, siehe Zeitplan festlegen.
3. Ist Aktiviert unter Kontoauszug-Export (KAEINLXML) eingeschaltet? Ohne Export landen die Transaktionen nur in mention Payments und nicht in der Warenwirtschaft.
4. Passen Umgebung und Zugangsdaten zusammen? Ein Live-Konto braucht Client ID und Secret der Live-App. Das Protokoll des letzten Laufs zeigt, ob PayPal die Anmeldung abgelehnt hat.

Ein Konto zeigt Keine Lizenz

Sie haben mehr Konten angelegt, als Ihre Lizenz Plätze hat. Die Plätze gelten für die ganze Installation über alle Mandanten hinweg, und die ältesten Konten bekommen sie zuerst. Für Konten ohne Lizenz laufen keine Pipelines, ihre Daten bleiben aber sichtbar. Löschen Sie ein Konto, das Sie nicht mehr brauchen, oder erweitern Sie Ihre Lizenz bei mention.

Ein neues Konto lässt sich nicht speichern

No licenses remaining for this provider type heißt, dass kein Lizenzplatz mehr frei ist. An account with the name ... already exists heißt, dass es schon ein Konto mit diesem Namen gibt.

Sammelzahlung findet kein Konto

Für Zahlungsaufträge aus der Warenwirtschaft nimmt mention Payments das Live-Konto des Mandanten, und nur wenn es keines gibt, das Sandbox-Konto. Gibt es mehrere Konten mit derselben Umgebung, bricht der Lauf mit einem Fehler ab. Legen Sie daher pro Mandant nur ein Live-Konto an, wenn Sie Zahlungsaufträge über PayPal auszahlen.

Lizenzprüfung fehlgeschlagen

mention Payments prüft die Lizenz bei jedem Start beim Lizenzserver von mention. Ist der Server nicht erreichbar, arbeitet es bis zu 30 Tage mit der zuletzt geprüften Lizenz weiter. Danach, oder wenn noch kein Lizenzschlüssel hinterlegt ist, erscheint Keine zwischengespeicherte Lizenz verfügbar. Prüfen Sie die Internetverbindung und klicken Sie auf Erneut versuchen.

Für Payments ist keine Lizenz verfügbar bedeutet, dass Ihre Lizenz mention Payments nicht enthält oder abgelaufen ist. Wenden Sie sich in dem Fall an mention.

Kein gültiger dsmain-Installationsordner

Im gewählten Ordner liegt keine dspath.dbf. Wählen Sie den Ordner, in dem die mention Warenwirtschaft installiert ist.

Die Anmeldung schlägt fehl

Bei Benutzername oder Passwort ist falsch prüfen Sie Ihre Zugangsdaten der Warenwirtschaft. Dem Benutzer ist kein Mandant zugeordnet heißt, dass Ihr Benutzer in der Warenwirtschaft keinem Mandanten zugeordnet ist. Das richtet Ihr Administrator in der Warenwirtschaft ein. Dieser Benutzername ist eine Gruppe, kein Login erscheint, wenn Sie den Namen einer Benutzergruppe statt eines Benutzers eingeben.

Protokolldateien für den Support

Fragt der Support nach Protokolldateien, schicken Sie den Inhalt dieser beiden Ordner. Die Anwendung schreibt ihre Protokolle nach %LOCALAPPDATA%\Mention.Payments\Logs, der Hintergrunddienst nach %ProgramData%\Mention.Payments\Logs.