====== Hibiscus: Paypal ====== {{:support:paypal:paypal-large.png |}} Paypal bietet eine REST-basierte [[https://developer.paypal.com/api/rest/|Webservice-Schnittstelle]], die vom Plugin "hibiscus.paypal" verwendet wird. Die folgende Anleitung beschreibt die Installation und Einrichtung des Plugins. **Hinweis: Die Paypal REST-Schnittstelle unterstützt nur Business-Konten.** Unter https://www.paypal.com/myaccount/settings/ findest du jedoch einen Link https://www.paypal.com/DE/merchantsignup/router mit der Bezeichnung "Auf Geschäftskonto hochstufen", mit der ein Privat-Konto kostenlos auf ein Business-Konto umgestellt werden kann. ====== Schritt 1: Business-Konto aktivieren ====== Falls das Paypal-Konto noch nicht als Business-Konto bzw. Geschäftskonto eingerichtet ist, führe die folgenden Schritte aus: - Melde dich auf https://paypal.com an - Klicke oben auf das Zahnrad-Symbol (links neben "AUSLOGGEN"). - Klicke im Absatz "Kontoeinstellungen" auf "Auf Geschäftskonto hochstufen" - Folge den Anweisungen des Assistenten - Wähle "Geschäftskonto eröffnen", um *zusätzlich* zum existierenden privaten Paypal-Konto ein Geschäftskonto einzurichten. Du benötigst hierfür eine zweite Mailadresse - Wähle alternativ "Konto hochstufen", um das existierende private Paypal-Konto auf ein Geschäftskonto umzustellen. ====== Schritt 2: API-Zugangsdaten erstellen ====== Öffne https://developer.paypal.com - stelle sicher, dass du angemeldet bist und klicke auf "Get API Credentials" - Stelle sicher, dass die Zugangsdaten nicht für "Sandbox" (das ist das Testsystem) erstellt werden sondern für "Live" (das ist das System mit den echten Daten). Klicke ggf. auf "Live" - Klicke anschließend auf "Create App" - Vergib einen frei gewählten Namen für die App. Zum Beispiel "Hibiscus" - Klicke auf "Create App" - Klicke anschließend links in der Navigation auf "My Apps & Credentials" ... - ... und danach auf "Live". Die neu erstellte App sollte nun angezeigt werden. - Klicke auf den Namen der App, um die Zugangsdaten anzuzeigen. - Kopiere den Wert im Feld "Client ID". Der Wert wird später in Hibiscus als "API Client-ID" benötigt. Beachte, dass der Text ggf. umgebrochen angezeigt wird. Kopiere in dem Fall auch den Rest auf der zweiten Zeile und stelle sicher, dass die Client-ID anschließend keine Zeilenumbrüche oder Leerzeichen enthält. - Klicke im Feld "Secret" auf "show", um das API-Secret anzuzeigen. Kopiere den Text ebenfalls. Er wird später in Hibiscus als "API Secret" benötigt. Achte auch hier wieder auf Zeilenumbrüche - Stelle sicher, dass der Status des Secret "Enabled" ist. Ist dies nicht der Fall, klicke auf das Symbol "..." in der Spalte "Action" und aktiviere das Secret. - Scrolle auf der Seite nach unten zum Absatz "Live App Settings". Aktiviere die Option "Transaction Search" - klicke danach auf "Save". {{:support:paypal:paypal-setup-02.png?600|}} {{:support:paypal:paypal-setup-03.png?600|}} {{:support:paypal:paypal-setup-04.png?600|}} {{:support:paypal:paypal-setup-05.png?600|}} {{:support:paypal:paypal-setup-06.png?600|}} {{:support:paypal:paypal-setup-07.png?600|}} **Es kann eine gewisse Zeit dauern, bis der API-Token von Paypal freigeschaltet wird. Es kann also etwas Geduld erforderlich sein, wenn die Abfrage mit dem frisch erstellten Token erst mal mit Authentifizierungsproblemen abgelehnt wird.** ====== Schritt 3: Hibiscus-Addon installieren ====== - Starte Hibiscus. - Klicke oben im Menü auf "Datei->Plugins online suchen...". - Klicke auf den Reiter "Verfügbare Plugins". - Klicke im Absatz "hibiscus.paypal" auf den Button "Installieren...". - Bestätige die Sicherheitsabfragen und starte Hibiscus neu. {{:support:paypal:paypal-install-01.png?600|}} ====== Schritt 4: Hibiscus-Addon konfigurieren ====== - Starte Hibiscus. - Klicke links in der Navigation im Absatz "Start->Hibiscus" auf "Konten", um die Liste der Konten zu öffnen. - Klicke auf den Button "Konto manuell anlegen". - Gib im Feld "Bezeichnung des Kontos" einen beliebigen Text ein, z.Bsp.: "Paypal". - Gib im Feld "Kontoinhaber" deinen Namen ein. - Klicke auf den Reiter "Zugangsdaten". - Befülle die Pflichtfelder Kundenkennung, Kontonummer und Bankleitzahl mit beliebigen Werten. Der Inhalt der Felder wird nicht benötigt. Z.Bsp.: * Kundenkennung: 1234567890 * Kontonummer: 1234567890 * BLZ: 12345678 - Aktiviere **nicht** die Option "Offline-Konto" - Wähle in der Auswahlbox "Zugangsweg" die Option "Paypal". - Klicke auf "Speichern". - Hierbei erscheint ein Fenster, welches dich auffordert, die Konfiguration des Kontos zu vervollständigen. Klicke auf "Ja" und folge den Anweisungen des Assistenten. - Die BIC von Paypal wird automatisch vervollständigt. Klicke auf "Weiter". - Gib die "API Client-ID" aus "Schritt 2: API-Zugangsdaten erstellen" ein. Beachte dabei, keine Leerzeichen oder Zeilenumbrüche einzufügen. - Klicke auf "Weiter". - Gib das "API Secret" aus "Schritt 2: API-Zugangsdaten erstellen" ein. Achte hier ebenfalls darauf, keine Leerzeichen oder Zeilenumbrüche einzufügen. - Klicke auf "Fertigstellen" - Die Einrichtung ist abgeschlossen. Du kannst nun die Umsätze und Salden abrufen oder die Synchronisierungsoptionen konfigurieren. Das Paypal-Addon unterstützt derzeit nur das Abrufen der Salden und Umsätze. {{:support:paypal:paypal-setup-01.png?600|}} {{:support:paypal:paypal-setup-08.png?600|}} {{:support:paypal:paypal-setup-09.png?600|}} {{:support:paypal:paypal-setup-10.png?600|}} {{:support:paypal:paypal-setup-11.png?600|}} {{:support:paypal:paypal-setup-12.png?600|}} ====== Fertig ====== Das Konto kann nun wie gewohnt synchronisiert werden. Falls du mehrere Paypal-Konten besitzt, kannst du die Anleitung für jedes Konto wiederholen. Du kannst den Assistenten zur Einrichtung des Paypal-Zugangs später jederzeit erneut starten, indem du mit der rechten Maustaste auf Konto klickst und im Kontextmenü die Option "Paypal-Einrichtung starten..." wählst. Darüber hinaus kannst du die "API Client-ID" sowie das "API Secret" jederzeit in den Synchronisierungsoptionen des Kontos einsehen und ändern.