PayPal-Konto unter orgaMAX einrichten (REST API)

Wie binden Sie die neue, bessere PayPal Schnittstelle an orgaMAX an? Dieser FAQ Eintrag zeigt es.

Ab jetzt orgaMAX unterstützt orgaMAX auch die sogenannte REST Schnittstelle für den Abruf Ihrer PayPal Umsätze. Diese bietet im Gegensatz zu der bisher verwendeten, sogenannten SOAP-Schnittstelle, folgende Vorteile für Sie:

  • höhere Geschwindigkeit beim Abruf
  • ständige Weiterentwicklung der Schnittstelle, dadurch...
  • mehr Sicherheit

Dieser Eintrag zeigt, wie Sie die neue PayPal Schnittstelle mit orgaMAX nutzen.

PayPal soll zum ersten Mal an orgaMAX angebunden werden

PayPal wurde bereits angebunden und soll auf die neue REST Schnittstelle umgestellt werden

Wie komme ich an die Zugangsdaten?

Besonderheiten im Vergleich zur alten Schnittstelle (Handhabung von PayPal-Gebühren)

PayPal wurde bereits angebunden und soll auf die neue REST Schnittstelle umgestellt werden

Haben Sie bereits in der Vergangenheit Ihren PayPal Account an orgaMAX angebunden? In diesem Fall erhalten Sie beim Abruf Ihrer Umsätze folgendes Fenster:

image16

Klicken Sie auf Jetzt starten, um den Assistenten zu öffnen. Die weitere Einrichtung ist hier beschrieben.

Alternativ können Sie ein bestehendes PayPal Konto auch in den Einstellungen der Bankverbindungen umstellen. Begeben Sie sich dazu unter Finanzen -> Zahlungen Bank/Kasse -> Weitere Funktionen (am unteren Bildschirmrand) -> Einstellungen Bankverbindung und klicken auf die drei Punkte... (die weitere Einrichtung ist ebenfalls hier beschrieben):

image15

Sollte dieser Schritt bei Ihnen fehlen, steht bei Ihnen vermutlich noch ein Update aus. Für Nutzer der orgaMAX Cloud wird dies in den kommenden Tagen automatisch aufgespielt. Ansonsten finden Sie die Updateprüfung über den Menüpunkt Hilfe -> Online-Update.

PayPal per REST API neu einrichten

Die Einrichtung Ihres PayPal-Kontos geschieht in orgaMAX im Bereich der Bankverbindungen. Diesen finden Sie unter Finanzen -> Zahlungen Bank/Kasse -> Weitere Funktionen (am unteren Bildschirmrand) -> Einstellungen Bankverbindung

image5

Klicken Sie hier auf + Neue Verbindung.

image6

Wählen Sie im nächsten Schritt PayPal aus und klicken auf Weiter.

image7

Sie sehen nun folgenden Dialog:

image8

Lesen Sie die Informationen kurz durch und klicken auf Weiter.

Sollte dieser Schritt bei Ihnen fehlen, steht bei Ihnen vermutlich noch ein Update aus. Für Nutzer der orgaMAX Cloud wird dies in den kommenden Tagen automatisch aufgespielt. Ansonsten finden Sie die Updateprüfung über den Menüpunkt Hilfe -> Online-Update.

Im nächsten Schritt werden Ihre Zugangsdaten für die Anbindung an PayPal (per REST Schnittstelle) benötigt. Hierzu sind einmalig ein paar vorbereitende Schritte nötig, die wir uns im nächsten Schritt anschauen.

image3

Stellen Sie in diesem Fenster sicher, dass der Haken bei PIN / Passwort speichern (mandantenbezogen) gesetzt ist. Lassen Sie nun den Einrichtungsdialog von orgaMAX im Hintergrund einfach geöffnet, damit Sie die passenden Daten im Anschluss ganz einfach eintragen können.

Zugang zur PayPal REST API einrichten

Um PayPal per REST Schnittstelle (auch API genannt) an orgaMAX anbinden zu können, muss dafür einmalig ein Zugang zur sogenannten PayPal REST API eingerichtet werden. Dabei erhalten Sie auch die Zugangsdaten, die für orgaMAX benötigt werden.

  1. Loggen Sie sich auf https://developer.paypal.com/developer/applications mit Ihren PayPal Anmeldedaten (Benutzername) ein.
  2. Loggen Sie sich nun falls nötig mit Ihren PayPal Zugangsdaten ein. Sie befinden sich jetzt im Bereich Dashboard -> My Apps & Credentials. Stellen Sie hier den Regler auf Live um.
    image10
  3. Erstellen Sie eine Applikation, indem Sie den Button Create App betätigen.
    image11
  4. Geben Sie Ihrer Applikation einen Namen wie zum Beispiel orgaMAX und bestätigen Sie auch hier Ihre Eingabe über den Button Create App. Sonderzeichen und Umlaute sind hier nicht möglich.
    image12
  5. Überprüfen Sie im nächsten Schritt die Detailangaben und kopieren Sie anschließend Ihre Emailadresse (den PayPal account), die Client-ID sowie das Secret in den Assistenten unter orgaMAX. Das Secret wird angezeigt, wenn Sie auf den Link Show klicken.
    image13
  6. Aktivieren Sie unten auf der Seite Transaction Search (Buchungen abrufen) und speichern Sie dies (Save-Button).
    image14

Weitere Hinweise:

Die Freischaltung durch PayPal kann bis zu 24 Stunden dauern. Erst nachdem diese erfolgt ist, kann der Zugang eingerichtet werden. Verwenden Sie diese Anmeldedaten, um einen Zugang zu PayPal im Programm einzurichten. 

Die so eingerichtete Applikation kann in multiplen Produkten zugleich verwendet werden, sofern diese den REST Zugang unterstützen. Es ist also nicht erforderlich, für jede Onlinebanking Software eine eigene Applikation zu erzeugen, es sei denn Sie wünschen dieses ausdrücklich.

Sobald die Emailadresse (der PayPal account), die Client-ID sowie das Secret im Einrichtungsassistenten für PayPal unter orgaMAX hinterlegt sind, können Sie den Assistenten zu Ende hin durchführen. Nachdem Sie die Kontoeinrichtung abgeschlossen haben und Ihre Firmeneinstellungen wieder geschlossen haben, können Sie im Bereich Finanzen -> Zahlungen Bank / Kasse auf Ihr PayPal-Konto zugreifen und die Umsätze abrufen. Beachten Sie bitte die oben genannte Dauer für die einmalige Freischaltung von bis zu 24 Stunden.

Besonderheiten im Vergleich zur alten Schnittstelle (Handhabung von PayPal-Gebühren)

Im Vergleich zur bisherigen Schnittstelle, der SOAP-API, bietet die neue Schnittstelle ständige Weiterentwicklung und mehr Leistung.

Eine Änderung gibt es unter orgaMAX bei der Handhabung der Gebühren. Diese wurden zuvor  zusätzlich zur eigentlichen Zahlung als eigenständige Buchung aufgelistet. Dies ist nun nicht mehr der Fall. Unter orgaMAX wird nun nur noch die bereits um die Gebühren reduziert Zahlung gelistet. Öffnen Sie die Zahlung mit dem Zuordnungs-Assistenten per Doppelklick, wird Ihnen die Gebühr automatisch zur Zuordnung vorgeschlagen. Wählen Sie hier das Konto für Bankgebühren (im Normalfall Konto 4970). Um welches es sich genau handelt, können Sie im Menüpunkt Stammdaten -> Finanzbuchhaltung -> Standard-FiBu-Konten... einsehen (als Konto beim Punkt Bankgebühren).

image17