PayPal

Die Integration von PayPal ist über 2 Wege möglich, mit unterschiedlichen Funktionsumfängen:

PayPal Billing Agreements

Bei der Verwendung von PayPal Billing Agreements werden die Zahlungsdaten des Kunden bei PayPal hinterlegt und können für zukünftige Zahlungen verwendet werden. Hierbei handelt es sich um eine Art "Zahlungseinzugsermächtigung" die der Kunde bei PayPal hinterlegt.

Der Vorteil ist, dass die Zahlungsdetails nicht erneut eingegeben werden müssen und Zahlungen vollständig automatisiert abgewickelt werden können.

Für "Paypal Billing Agreements" oder auch "Paypal Reference Transactions" muss vorab ein PayPal Business Account existieren, und dieser für diese Art von Zahlungen freigeschaltet werden.

Beantragung

Um "PayPal Reference Transactions" zu beantragen, gibt es mehrere Möglichkieten:

• Telefonisch: Kontaktiere das lokale PayPal-Support-Help-Center und frage nach einem Spezialisten, der das PayPal Business Konto für "PayPal Reference Transaction" freischalten kann. Beharre auf "PayPal Reference Transactions" den gegebenfalls könntest du zu "PayPal Subscriptions" vermittelt werden, was nicht das richtige ist.
• E-Mail: Kontaktiere den PayPal-Support per E-Mail, und bitte um Freischaltung für "PayPal Reference Transaction". Solltest du im Anschluss eine automatische Antwort erhalten, antworte ggfs. auf diese, damit dein Support-Fall eröffnet wird. Andernfalls könnte es sein, dass dein Fall nicht bearbeitet wird.

Paypal Standard

Bei der Verwendung von PayPal "Standard" wird dem Kunden bei Erhalt der Rechnung ein Link zur PayPal-Website angezeigt, auf der er die Zahlungsdetails eingeben kann. Hierbei muss der Kunde bei jeder Rechnung die Zahlung eigenständig authorisieren.

Aus diesem Grund empfehlen wir die Verwendung von PayPal Billing Agreements wenn möglich.

Voraussetzungen

Um PayPal mit deinem Fynn Tenant Account zu verknüpfen, brauchst du als Erstes einen Account bei PayPal. Anschließend logge dich mit deinem Account bei developer.paypal.com ein.

PayPal REST API App

REST API App erstellen

Um eine neue REST-API App für Fynn zu erstellen, klicke auf der linken Seite unter Dashboard auf "My Apps & Credentials". Auf dieser Seite kannst Du REST API Apps für unsere Sandbox oder für den Produktionsbetrieb erstellen.

Um eine Live-App zu erstellen, wähle bitte "Live" im oberen Menü aus und vergebe der Anwendung einen Namen, wie bspw. Fynn.

Auf der oberen Seite stehen deine Zugangsdaten in Form von Client ID und Screct. Teile diese Daten bitte mit keinem anderen!

REST API App Einstellungen

In der zweiten Box müssen folgende Features aktiviert sein:

• Payouts
• Subscriptions
• Customer disputes
• Transaction search

PayPal Webhook

Der Webhook wird benötigt, damit Zahlungen automatisch als bezahlt markiert werden können. Mit einem klick auf "Add Webhook", kann ein neuer Webhook für Fynn angelegt werden. Nachdem anlegen, erhältst du von PayPal eine Webhook ID diese muss am Ende in Fynn hinterlegt werden.

Webhook Url

Deine Webhook Url für Fynn ist deine API-Domain, bspw. {username}.coreapi.io. Die Vollständige Webhook Url ist somit:

https://{username}.coreapi.io/payment/webhook/paypal_rest

Event types

Bitte aktiviere folgende Checkboxen:

• All Events

PayPal Zugangsdaten hinterlegen

Die Client ID und Secret aus der neu angelegten PayPal REST APP müssen zusammen mit der Webhook ID in Fynn eingetragen werden. In den Einstellungen → Zahlungsverarbeitung → PayPal, können diese Daten hinterlegt werden.

Sandbox

Wenn Du PayPal im Sandbox testen möchtest, kannst Du einfach die Checkbox aktivieren. Bitte achte darauf, dass Du hierzu im PayPal Developer Portal auch eine Sandbox REST App anlegen und dessen Zugangsdaten verwenden musst.

Branding

PayPal biete die Möglichkeit noch weitere Einstellungen am Branding vorzunehmen. Hier können headerImageUrl, logoImageUrl und borderColor gesetzt werden. Das ausgewählte Logo sollte maximal 750x90 Pixel groß sein.

Buchhaltung

Das Buchungskonto ist für die spätere Kontierung wichtig, bitte trage hier das entsprechende Konto aus deiner Buchhaltung ein. Wenn Du Dir bei diesem Schritt nicht sicher bist, wende dich bitte an deinen Steuerberater.