Payments: Unterschied zwischen den Versionen

Aus mention ERP Wiki
Verweis auf die Einrichtung der Warenwirtschaft ergänzt
Übersicht: Statusleiste mit Dienst und Version statt Dienst-Schaltfläche; Protokollordner unter mentionERP (#1167)
 
(5 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 10: Zeile 10:
* ein Benutzer der mention Warenwirtschaft, dem mindestens ein Mandant zugeordnet ist
* ein Benutzer der mention Warenwirtschaft, dem mindestens ein Mandant zugeordnet ist
* ein PayPal-Geschäftskonto mit einer REST-App, siehe [[#Zugangsdaten bei PayPal anlegen|Zugangsdaten bei PayPal anlegen]]
* ein PayPal-Geschäftskonto mit einer REST-App, siehe [[#Zugangsdaten bei PayPal anlegen|Zugangsdaten bei PayPal anlegen]]
* Internetzugang zu PayPal und zum Lizenzserver von mention


== Installation ==
== Installation ==
Zeile 59: Zeile 58:
|-
|-
| '''Aktualisieren''' || Lädt die Konten neu. Die Übersicht aktualisiert sich außerdem alle 45 Sekunden von selbst.
| '''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 [[#Globale Einstellungen|globalen Einstellungen]].
| '''Einstellungen''' || Öffnet die [[#Globale Einstellungen|globalen Einstellungen]].
|-
|-
| '''Neu''' || Legt ein neues Konto an.
| '''Neu''' || Legt ein neues Konto an.
|}
Unten in der Übersicht liegt die Statusleiste. Sie zeigt, ob der Hintergrunddienst läuft und welche Version installiert ist.
{| class="wikitable"
! Eintrag !! Funktion
|-
| '''Dienst''' || Zeigt den Zustand des Hintergrunddienstes, zum Beispiel '''Dienst: Läuft''', '''Dienst: Angehalten''' oder '''Dienst: Nicht installiert'''. Ein Klick öffnet die Steuerung des Hintergrunddienstes.
|-
| '''Version''' || Zeigt die installierte Version. Ein Klick öffnet das Fenster '''Info''' mit dem Installationsordner, den Ordnern der Protokolle, den Lizenzen und dem Stand der Aktualisierungen.
|}
|}


Zeile 114: Zeile 121:
=== Alle Einstellungen eines Kontos ===
=== Alle Einstellungen eines Kontos ===


[[Datei:Payments_Konto_Einstellungen.png|780px|Alle Einstellungen eines Kontos]]<br />
Der Reiter '''Einstellungen''' ist in fünf Bereiche gegliedert. Sie sind hier in derselben Reihenfolge beschrieben wie im Programm. Die Spalte '''Vorgabe''' nennt den Wert, mit dem ein neues Konto startet.
''Abb.: Reiter Einstellungen eines Kontos''
 
==== Konto ====
 
[[Datei:Payments_Konto_Einstellungen_Konto.png|780px|Bereich Konto]]<br />
''Abb.: Bereich Konto''
 
'''Name''' und '''Provider''' zeigt mention Payments hier nur an, ändern lassen sie sich nicht.


{| class="wikitable"
{| class="wikitable"
! Einstellung !! Bedeutung
! Einstellung !! Bedeutung !! Vorgabe
|-
|-
| '''Mention-Benutzer''' || Mit diesem Benutzer meldet sich mention Payments bei der Warenwirtschaft an. Vorbelegt ist der Benutzer, der das Konto angelegt hat.
| '''Mention-Benutzer''' || Mit diesem Benutzer meldet sich mention Payments bei der Warenwirtschaft an. || Der Benutzer, der das Konto angelegt hat
|}
 
==== Authentifizierung ====
 
[[Datei:Payments_Konto_Einstellungen_Authentifizierung.png|780px|Bereich Authentifizierung]]<br />
''Abb.: Bereich Authentifizierung''
 
Wie Sie die Zugangsdaten bei PayPal anlegen und eintragen, steht unter [[#Zugangsdaten bei PayPal anlegen|Zugangsdaten bei PayPal anlegen]] und [[#Zugangsdaten eintragen|Zugangsdaten eintragen]].
 
{| class="wikitable"
! Einstellung !! Bedeutung !! Vorgabe
|-
|-
| '''Umgebung''' || '''Sandbox''' zum Testen, '''Live''' für echte Zahlungen.
| '''Umgebung''' || '''Sandbox''' zum Testen, '''Live''' für echte Zahlungen. || Sandbox
|-
|-
| '''Client ID''' und '''Secret''' || Die Zugangsdaten Ihrer PayPal-App.
| '''Client ID''' und '''Secret''' || Die Zugangsdaten Ihrer PayPal-App. Sandbox und Live haben jeweils eigene. || leer
|}
 
==== Kontoauszug-Export (KAEINLXML) ====
 
[[Datei:Payments_Konto_Einstellungen_Kontoauszug_Export.png|780px|Bereich Kontoauszug-Export (KAEINLXML)]]<br />
''Abb.: Bereich Kontoauszug-Export (KAEINLXML)''
 
Dieser Bereich legt fest, ob und wie mention Payments die Transaktionen als Kontoauszug an die Warenwirtschaft übergibt.
 
{| class="wikitable"
! Einstellung !! Bedeutung !! Vorgabe
|-
|-
| '''Aktiviert''' || Übergibt die Transaktionen als Kontoauszug an die Warenwirtschaft. Ist der Export aus, bleibt auch der Pending Check untätig.
| '''Aktiviert''' || Übergibt die Transaktionen als Kontoauszug an die Warenwirtschaft. Ist der Export aus, bleibt auch der Pending Check untätig. || Aus
|-
|-
| '''Backfill-Tage''' || Steuert, ob der Pending Check Transaktionen nachträglich exportiert, deren Kontoauszug fehlt. Mit 0 schalten Sie das ab.
| '''Backfill-Tage''' || Wie viele Tage rückwirkend der Pending Check nach Transaktionen sucht, deren Kontoauszug fehlt, und sie nachträglich exportiert. Mit 0 schalten Sie das ab. || 7
|-
|-
| '''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.
| '''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. || Automatik (kein Override)
|}
 
==== Protokollierung ====
 
[[Datei:Payments_Konto_Einstellungen_Protokollierung.png|780px|Bereich Protokollierung]]<br />
''Abb.: Bereich Protokollierung''
 
Beide Einstellungen gibt es auch in den [[#Globale Einstellungen|globalen Einstellungen]]. Mit '''Systemstandard verwenden''' übernimmt das Konto den globalen Wert, jede andere Auswahl gilt nur für dieses Konto.
 
{| class="wikitable"
! Einstellung !! Bedeutung !! Vorgabe
|-
|-
| '''Log-Level''' || Wie ausführlich mention Payments die Abläufe dieses Kontos protokolliert. '''Systemstandard verwenden''' übernimmt den Wert aus den globalen Einstellungen.
| '''Log-Level''' || Wie ausführlich mention Payments die Abläufe dieses Kontos protokolliert. || Systemstandard verwenden
|-
|-
| '''Fehler direkt an Mention senden''' || Schickt Fehler dieses Kontos automatisch an mention. '''Systemstandard verwenden''' übernimmt den globalen Wert.
| '''Fehler direkt an Mention senden''' || Schickt Fehler dieses Kontos automatisch an mention. || Systemstandard verwenden
|}
|}


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.
==== Konto löschen ====
 
[[Datei:Payments_Konto_Einstellungen_Loeschen.png|780px|Bereich Konto löschen]]<br />
''Abb.: Bereich Konto löschen''
 
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.
 
* Vor dem Löschen fragt das Programm noch einmal nach und nennt, wie viele Läufe und Transaktionen betroffen sind.
* Solange eine Pipeline des Kontos läuft, ist die Schaltfläche gesperrt.


=== Zeitplan festlegen ===
=== Zeitplan festlegen ===
Zeile 203: Zeile 257:


Der Reiter '''Transaktionen''' zeigt die abgerufenen PayPal-Transaktionen des Kontos, die neueste oben. Beim Öffnen sehen Sie die letzten 30 Tage.
Der Reiter '''Transaktionen''' zeigt die abgerufenen PayPal-Transaktionen des Kontos, die neueste oben. Beim Öffnen sehen Sie die letzten 30 Tage.
'''PayPal stellt Transaktionen bis zu drei Stunden verzögert bereit.''' Eine Zahlung, die Sie in Ihrem PayPal-Konto schon sehen, fehlt deshalb unter Umständen noch in mention Payments und in der Warenwirtschaft. Diese Verzögerung entsteht bei PayPal, und mention Payments kann sie nicht verkürzen. Sie müssen nichts tun, denn ein späterer Lauf von '''PayPal Transaction Sync''' holt solche Transaktionen von selbst ab. Fehlt eine Transaktion nach mehr als drei Stunden immer noch, gehen Sie vor wie unter [[#Es kommen keine Transaktionen an|Es kommen keine Transaktionen an]] beschrieben.


[[Datei:Payments_Transaktionen_Beispiel.png|780px|Reiter Transaktionen]]<br />
[[Datei:Payments_Transaktionen_Beispiel.png|780px|Reiter Transaktionen]]<br />
Zeile 292: Zeile 348:
''Abb.: Hinweis in der Übersicht, wenn der Hintergrunddienst fehlt''
''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'''.
Ohne laufenden Hintergrunddienst startet keine Pipeline, weder nach Zeitplan noch von Hand. In der Statusleiste steht dann '''Dienst: Nicht installiert''' oder '''Dienst: Angehalten'''. Klicken Sie auf '''Dienst verwalten''' oder in der Statusleiste auf den Eintrag '''Dienst'''.


[[Datei:Payments_Dienst_Fenster.png|Steuerung des Hintergrunddienstes]]<br />
[[Datei:Payments_Dienst_Fenster.png|Steuerung des Hintergrunddienstes]]<br />
Zeile 306: Zeile 362:
Prüfen Sie der Reihe nach:
Prüfen Sie der Reihe nach:


# Läuft der Hintergrunddienst? Der Punkt an '''Dienst''' in der Übersicht muss grün sein.
# Ist die Zahlung jünger als drei Stunden? PayPal stellt Transaktionen bis zu drei Stunden verzögert bereit, siehe [[#Transaktionen|Transaktionen]]. Warten Sie in diesem Fall ab.
# Läuft der Hintergrunddienst? In der Statusleiste der Übersicht muss '''Dienst: Läuft''' stehen.
# Hat '''PayPal Transaction Sync''' einen Zeitplan? Bei '''Angehalten · kein Intervall konfiguriert''' fehlt das Intervall, siehe [[#Zeitplan festlegen|Zeitplan festlegen]].
# Hat '''PayPal Transaction Sync''' einen Zeitplan? Bei '''Angehalten · kein Intervall konfiguriert''' fehlt das Intervall, siehe [[#Zeitplan festlegen|Zeitplan festlegen]].
# Ist '''Aktiviert''' unter '''Kontoauszug-Export (KAEINLXML)''' eingeschaltet? Ohne Export landen die Transaktionen nur in mention Payments und nicht in der Warenwirtschaft.
# Ist '''Aktiviert''' unter '''Kontoauszug-Export (KAEINLXML)''' eingeschaltet? Ohne Export landen die Transaktionen nur in mention Payments und nicht in der Warenwirtschaft.
Zeile 340: Zeile 397:
=== Protokolldateien für den Support ===
=== Protokolldateien für den Support ===


Fragt der Support nach Protokolldateien, schicken Sie den Inhalt dieser beiden Ordner. Die Anwendung schreibt ihre Protokolle nach <code>%LOCALAPPDATA%\Mention.Payments\Logs</code>, der Hintergrunddienst nach <code>%ProgramData%\Mention.Payments\Logs</code>.
Fragt der Support nach Protokolldateien, schicken Sie den Inhalt dieser beiden Ordner. Die Anwendung schreibt ihre Protokolle nach <code>%LOCALAPPDATA%\mentionERP\Mention.Payments\Logs</code>, der Hintergrunddienst nach <code>%ProgramData%\mentionERP\Mention.Payments\Logs</code>. Beide Ordner öffnen Sie auch im Fenster '''Info'''. Es erscheint nach einem Klick auf die Version in der Statusleiste.

Aktuelle Version vom 28. September 2026, 13:38 Uhr

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

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. Das Ordnersymbol neben dem Feld öffnet die Ordnerauswahl von Windows.

Installationsordner der Warenwirtschaft auswählen
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.

Lizenzschlüssel eintragen
Abb.: Lizenzschlüssel eintragen

Anmelden

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

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

Mandant auswählen
Abb.: Mandant auswählen

Die Übersicht

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

Leere Übersicht nach dem ersten Start
Abb.: Übersicht ohne Konten

Schaltfläche Funktion
Aktualisieren Lädt die Konten neu. Die Übersicht aktualisiert sich außerdem alle 45 Sekunden von selbst.
Einstellungen Öffnet die globalen Einstellungen.
Neu Legt ein neues Konto an.

Unten in der Übersicht liegt die Statusleiste. Sie zeigt, ob der Hintergrunddienst läuft und welche Version installiert ist.

Eintrag Funktion
Dienst Zeigt den Zustand des Hintergrunddienstes, zum Beispiel Dienst: Läuft, Dienst: Angehalten oder Dienst: Nicht installiert. Ein Klick öffnet die Steuerung des Hintergrunddienstes.
Version Zeigt die installierte Version. Ein Klick öffnet das Fenster Info mit dem Installationsordner, den Ordnern der Protokolle, den Lizenzen und dem Stand der Aktualisierungen.

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. Außerdem muss die Warenwirtschaft einmal eingerichtet sein, siehe Warenwirtschaft und Finance.

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.

Dialog Neues Konto
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.

Übersicht mit dem neuen Konto
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.

Kontoeinstellungen in Bearbeitung
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

Der Reiter Einstellungen ist in fünf Bereiche gegliedert. Sie sind hier in derselben Reihenfolge beschrieben wie im Programm. Die Spalte Vorgabe nennt den Wert, mit dem ein neues Konto startet.

Konto

Bereich Konto
Abb.: Bereich Konto

Name und Provider zeigt mention Payments hier nur an, ändern lassen sie sich nicht.

Einstellung Bedeutung Vorgabe
Mention-Benutzer Mit diesem Benutzer meldet sich mention Payments bei der Warenwirtschaft an. Der Benutzer, der das Konto angelegt hat

Authentifizierung

Bereich Authentifizierung
Abb.: Bereich Authentifizierung

Wie Sie die Zugangsdaten bei PayPal anlegen und eintragen, steht unter Zugangsdaten bei PayPal anlegen und Zugangsdaten eintragen.

Einstellung Bedeutung Vorgabe
Umgebung Sandbox zum Testen, Live für echte Zahlungen. Sandbox
Client ID und Secret Die Zugangsdaten Ihrer PayPal-App. Sandbox und Live haben jeweils eigene. leer

Kontoauszug-Export (KAEINLXML)

Bereich Kontoauszug-Export (KAEINLXML)
Abb.: Bereich Kontoauszug-Export (KAEINLXML)

Dieser Bereich legt fest, ob und wie mention Payments die Transaktionen als Kontoauszug an die Warenwirtschaft übergibt.

Einstellung Bedeutung Vorgabe
Aktiviert Übergibt die Transaktionen als Kontoauszug an die Warenwirtschaft. Ist der Export aus, bleibt auch der Pending Check untätig. Aus
Backfill-Tage Wie viele Tage rückwirkend der Pending Check nach Transaktionen sucht, deren Kontoauszug fehlt, und sie nachträglich exportiert. Mit 0 schalten Sie das ab. 7
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. Automatik (kein Override)

Protokollierung

Bereich Protokollierung
Abb.: Bereich Protokollierung

Beide Einstellungen gibt es auch in den globalen Einstellungen. Mit Systemstandard verwenden übernimmt das Konto den globalen Wert, jede andere Auswahl gilt nur für dieses Konto.

Einstellung Bedeutung Vorgabe
Log-Level Wie ausführlich mention Payments die Abläufe dieses Kontos protokolliert. Systemstandard verwenden
Fehler direkt an Mention senden Schickt Fehler dieses Kontos automatisch an mention. Systemstandard verwenden

Konto löschen

Bereich Konto löschen
Abb.: Bereich Konto löschen

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.

  • Vor dem Löschen fragt das Programm noch einmal nach und nennt, wie viele Läufe und Transaktionen betroffen sind.
  • 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.

Zeitplan einer Pipeline
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.

Reiter Pipelines
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.

Läufe einer Pipeline
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.

Protokoll eines Laufs
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.

PayPal stellt Transaktionen bis zu drei Stunden verzögert bereit. Eine Zahlung, die Sie in Ihrem PayPal-Konto schon sehen, fehlt deshalb unter Umständen noch in mention Payments und in der Warenwirtschaft. Diese Verzögerung entsteht bei PayPal, und mention Payments kann sie nicht verkürzen. Sie müssen nichts tun, denn ein späterer Lauf von PayPal Transaction Sync holt solche Transaktionen von selbst ab. Fehlt eine Transaktion nach mehr als drei Stunden immer noch, gehen Sie vor wie unter Es kommen keine Transaktionen an beschrieben.

Reiter Transaktionen
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.

Warenwirtschaft und Finance

mention Payments bucht nicht selbst. Es schreibt jede Transaktion als Kontoauszug-Datensatz in die Tabelle KAEINLXML der Warenwirtschaft, im selben Format wie der frühere mention PayPal Connector. Die PayPal-Automatik der mention Warenwirtschaft liest diese Datensätze ein und ordnet jede Zahlung einem Beleg zu. Die gebuchten Zahlungen übernehmen Sie danach nach Finance.

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.

Haben Sie bisher den mention PayPal Connector eingesetzt, sind Warenwirtschaft und Finance schon eingerichtet. Ändern müssen Sie dann nur das Programm für Rückzahlungen, siehe Rückzahlungen über PayPal.

Voreinstellungen in der Warenwirtschaft

Damit die Warenwirtschaft die Kontoauszüge von mention Payments verarbeitet, schalten Sie zwei Optionen ein. Das gilt für jeden Mandanten, für den mention Payments Konten hat.

  1. Öffnen Sie in der Warenwirtschaft (dsmain.exe) Voreinstellungen → Mandanten → Voreinstellungen Verkauf... und wechseln Sie auf den Reiter Buchh. 2.
  2. Wählen Sie bei Daten zur Bearbeitung speichern den Eintrag alle.
  3. Schalten Sie Separates Einlesen/Bearbeiten von Kontoauszügen ein.

Kontoauszüge automatisch einlesen

Die PayPal-Automatik starten Sie in der Warenwirtschaft unter Bearbeiten → offene Posten → Kontoauszüge → Kontoauszüge einlesen Automatik.... Unter Intervall legen Sie fest, nach wie vielen Minuten die Automatik die neuen Kontoauszüge von mention Payments einliest.

Die Automatik ordnet jede Zahlung nach diesen Kriterien einem Beleg zu, in dieser Reihenfolge:

  1. Transaktions-ID und Betrag. Die Automatik sucht die Transaktions-ID in den Feldern Zahlungsreferenznummer, externe Referenz 1–3, Kunden-Bestellnummer und Bezugnahme 2 des Belegs.
  2. Rechnungs-ID und Betrag. Die Automatik sucht die Rechnungs-ID in den Feldern externe Referenz 1–3.
  3. E-Mail-Adresse des Käufers und Betrag.

Die zugeordneten und gebuchten Zahlungen sehen Sie unter Bearbeitung → Offene Posten → Zahlungseingangsbelege.

Rückzahlungen über PayPal

Rückzahlungen zu Kunden-Gutschriften kann die Warenwirtschaft über PayPal auszahlen. Dafür ist eine Zusatzlizenz erforderlich. Die Warenwirtschaft übergibt die Zahlungsaufträge an mention Payments, und die Pipeline PayPal Mass Payment zahlt sie aus.

Hinterlegen Sie dafür in den Stammdaten des Mandanten auf der Registerkarte Banken das Programm Mention.Payments.Daemon.Host.exe. Bei einer Standardinstallation liegt es unter C:\Program Files\Mention.Payments\current\Mention.Payments.Daemon.Host.exe. Haben Sie bisher den mention PayPal Connector eingesetzt, ersetzen Sie dort die PayPal-Connector.exe. Die Auszahlung startet nur, wenn der Hintergrunddienst läuft.

Ist im Beleg die Transaktionsnummer der ursprünglichen PayPal-Zahlung gespeichert, erstattet mention Payments genau diese Zahlung. Das gilt auch für Überzahlungen, solange die Bestellung noch nicht gelöscht ist, zu der die Zahlung ursprünglich gespeichert war. Andere Überzahlungen zahlt mention Payments ohne Bezug als PayPal-Auszahlung zurück. Welches Konto mention Payments für die Auszahlung nimmt, steht unter Sammelzahlung findet kein Konto.

Zahlungen nach Finance übernehmen

Die gebuchten Zahlungen importieren Sie anschließend nach Finance (dsfina.exe), zum Beispiel am nächsten Tag. Vor dem ersten Import hinterlegen Sie in Finance unter Voreinstellungen → Konten ein Konto für die PayPal-Gebühren.

Der Import läuft im selben Dialog wie der Import der Rechnungen aus der Warenwirtschaft.

  1. Öffnen Sie Bearbeiten → Import → Buchungen.
  2. Wählen Sie als Importart Zahlungen Debitoren PayPal-Automatik.
  3. Geben Sie Periode, Buchungsdatum und Stapel an wie beim Rechnungsimport.
  4. Verarbeiten Sie den Stapel. Erst danach erscheinen die Zahlungen auf den Konten.

Haben Sie den Stapel versehentlich gelöscht, wiederholen Sie den Import für denselben Zeitraum. Der wiederholte Import bucht allerdings auch Zahlungen noch einmal, die schon verarbeitet wurden.

Nicht zugeordnete Zahlungen buchen

Zahlungen, die die Automatik keinem Beleg zuordnen konnte, ordnen Sie in Finance von Hand zu. Öffnen Sie dazu Bearbeitung → Import → Kontoauszüge... → gespeicherte KA bearbeiten und wählen Sie unter neue Importart den Eintrag PayPal-Mention. Wie alle anderen Zahlungen landen diese Zahlungen erst nach dem Verarbeiten in der Warenwirtschaft.

Lesen Sie PayPal-Zahlungen nicht zusätzlich von Hand ein, solange die Automatik sie einliest. Stapel, die Finance in die Warenwirtschaft exportiert hat, lassen sich nicht zurück nach Finance importieren. Umgekehrt schreibt Finance Zahlungen, die in der Warenwirtschaft gebucht und nach Finance importiert wurden, beim Verarbeiten des Stapels nicht noch einmal in die Warenwirtschaft.

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.

Globale Einstellungen
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

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

Ohne laufenden Hintergrunddienst startet keine Pipeline, weder nach Zeitplan noch von Hand. In der Statusleiste steht dann Dienst: Nicht installiert oder Dienst: Angehalten. Klicken Sie auf Dienst verwalten oder in der Statusleiste auf den Eintrag Dienst.

Steuerung des Hintergrunddienstes
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. Ist die Zahlung jünger als drei Stunden? PayPal stellt Transaktionen bis zu drei Stunden verzögert bereit, siehe Transaktionen. Warten Sie in diesem Fall ab.
  2. Läuft der Hintergrunddienst? In der Statusleiste der Übersicht muss Dienst: Läuft stehen.
  3. Hat PayPal Transaction Sync einen Zeitplan? Bei Angehalten · kein Intervall konfiguriert fehlt das Intervall, siehe Zeitplan festlegen.
  4. Ist Aktiviert unter Kontoauszug-Export (KAEINLXML) eingeschaltet? Ohne Export landen die Transaktionen nur in mention Payments und nicht in der Warenwirtschaft.
  5. 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.
  6. Kommen die Kontoauszüge in der Warenwirtschaft an, werden aber keinem Beleg zugeordnet? Prüfen Sie die Voreinstellungen in der Warenwirtschaft und ob die Automatik unter Kontoauszüge einlesen Automatik... läuft.

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

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.

Protokolldateien für den Support

Fragt der Support nach Protokolldateien, schicken Sie den Inhalt dieser beiden Ordner. Die Anwendung schreibt ihre Protokolle nach %LOCALAPPDATA%\mentionERP\Mention.Payments\Logs, der Hintergrunddienst nach %ProgramData%\mentionERP\Mention.Payments\Logs. Beide Ordner öffnen Sie auch im Fenster Info. Es erscheint nach einem Klick auf die Version in der Statusleiste.