Paypal Modul 2.0

Bemerkung

Diese Dokumentation ist nur für die neue PayPal Commerce Integration gültig

Composer Paket: aggrosoft/oxid-agpaypal

Für ältere Shop Installation und vorhandene Installationen prüfen Sie bitte die Dokumentation des Vorgänger Moduls

Installation

Siehe Installation

REST App anlegen

Legen Sie eine REST-App im PayPal Developer Center an.

Hierzu klicken Sie auf Live, anschließend Create App um eine neue App anzulegen. Den Namen der Applikation können Sie frei wählen. Kopieren Sie die Client ID und Client Secret in die entsprechende Eingabefelder der Modul Einstellungen.

Einstellungen

Die Moduleinstellungen werden wie gewohnt, im Oxid eShop Admin Bereich, unter Einstellungen ‣ Module ‣ Aggrosoft PayPal 2.0 ‣ Einstell. eingetragen.

Zugangsdaten

PayPal Händler E-Mail Adresse

Die E-Mail Addresse des PayPal Business Konto für die Zahlungen entgegen genommen werden sollen.

Rest Client ID / Rest Client Secret

Zugangsdaten die im Schritt „REST App anlegen“ erzeugt wurden.

Webhook Id

Sofern die Rest App Zugänge korrekt eingetragen wurden erzeugt das Modul automatisch den benötigten Webhook und trägt die ID ein. Ändern Sie diese ID nur wenn es hierfür einen technischen Grund gibt.

Einstellungen

PayPal Sandbox nutzen

Verbindet das Modul mit der PayPal Sandbox Umgebung, nutzen Sie diese Einstellung zusammen mit einer Sandbox App um das Modul zu testen.

Bemerkung

Wir raten dazu das Modul zunächst in einer Testumgebung mit Sandbox Zugangsdaten zu testen.

Bestellungen die nicht authorisiert werden konnten automatisch stornieren

Storniert Bestellungen bei denen die Authorisierung zurückgenommen wurde automatisch, dies kann der Fall sein bei Kreditkarten Betrug oder nachgelagerten Ablehnungen im Rechnungskauf.

Log Level

Bestimmt wie viele Informationen zur Kommunikation mit PayPal in der Datei logs/agpaypal.log abgelegt werden. Sie können zwischen Fehlern, allen Anfragen und keinem Logging wählen - im Live Betrieb sollte das Level maximal auf „Fehler“ stehen. Beachten Sie bitte dass die Log Datei nicht automatisch gelöscht oder bereinigt wird.

Zahlungsarten definieren

Das Modul generiert während der Installation keine Zahlungsarten, diese müssen von Ihnen angelegt werden. Legen Sie für jede gewünschte Zahlungsart (PayPal, Kreditkarte, Rechnung, IDEAL, EPS etc.) eine separate Zahlungsart an. (Siehe Oxid eShop Handbuch)

Legen Sie bei den Zahlungsarten im vom Modul erzeugten Feld PayPal Zahlungsmethode die gewünschte PayPal Zahlungsart.

Achtung

Um die PayPal Express Funktionen zu nutzen (Kauf direkt aus Detailseite/Warenkorb) muss eine Zahlungsart existieren bei der das Feld PayPal Zahlungsmethode mit dem Wert PayPal belegt ist.

Warnung

Achten Sie darauf die Zahlungsart mit den entsprechend von PayPal erlaubten Ländern zu verknüpfen - EPS ist zum Beispiel nur für Kunden aus Österreich verfügbar. Sollten Sie die Zahlungsart einem deutschen Kunden anbieten führt dies zu einer Fehlermeldung.

Bemerkung

Bestimmte Zahlungsarten müssen separat für Ihren PayPal Account freigeschalten werden (Kreditkarte, Rechnung) - wenden Sie sich bei Fragen hierzu an den PayPal Händler Support.

Rechnungskauf

Achtung

Wenn Sie „Rechnungskauf mit Ratepay/Rechnungskauf mit Ratepay“ als Zahlungsoption zu Ihrer Installation hinzufügen, müssen Sie diese Bedingungen anerkennen und akzeptieren und verstehen, dass sie Teil der PayPal-Nutzungsvereinbarung sind.

Käufer Länder

Verkäufer Länder

Mindesbetrag

Maximalbetrag

Rückerstattungen

Deutschland

Deutschland

5 EUR

2500 EUR

Innerhalb 180 Tage

Diese Integration ist nur in Deutschland für berechtigte Händler verfügbar.

  • Sie dürfen nur Waren im B2C-Modell verkaufen.

  • Sie müssen Bestellungen innerhalb von sieben Tagen nach der Transaktion versenden.

  • Sie müssen für die Annahme von Transaktionen mit dieser Zahlungsmethode zugelassen sein. PayPal wird Sie auffordern, eine gültige Umsatzsteuer-Identifikationsnummer gemäß den EU-Vorschriften anzugeben. Ohne eine gültige Umsatzsteuer-Identifikationsnummer für Ihr Unternehmen ist PayPal verpflichtet, zusätzliche Mehrwertsteuer auf die PayPal-Gebühren zu erheben.

    Beantragen Sie die Genehmigung zur Aktivierung von „Auf Rechnung bezahlen“, indem Sie diese Sandbox- und Live-Links besuchen:

  • Die Bezahlung digitaler oder virtueller Güter, einschließlich, aber nicht beschränkt auf jegliche Form von Gutscheinen, wie Geschenkgutscheine, Geschenkkarten und Bargeld-Codes, sowie jegliche Transaktionen, die nicht den PayPal-Nutzungsrichtlinien entsprechen, sind mit „Auf Rechnung bezahlen“ nicht gestattet.

Kreditkarte

Achtung

Für die Verwendung von Kredit- und Debitkarten muss Ihr Geschäftskonto von PayPal geprüft und genehmigt werden. Beantragen Sie die Genehmigung zur Aktivierung von Kreditkartenzahlungen, indem Sie diese Sandbox- und Live-Links besuchen:

Land

Kartenanbieter

Währungen

Australia

Mastercard,Visa,American Express (AUD only)

AUD, CAD, CHF, CZK, DKK, EUR, GBP, HKD, HUF, JPY, NOK, NZD, PLN, SEK, SGD, USD

Canada

Mastercard,Visa,American Express (CAD only),JCB (CAD only)

AUD, CAD, CHF, CZK, DKK, EUR, GBP, HKD, HUF, JPY, NOK, NZD, PLN, SEK, SGD, USD

France

Mastercard,Visa,American Express (EUR only),Carte Bancaire

AUD, CAD, CHF, CZK, DKK, EUR, GBP, HKD, HUF, JPY, NOK, NZD, PLN, SEK, SGD, USD

Germany

Mastercard,Visa,American Express (EUR only)

AUD, CAD, CHF, CZK, DKK, EUR, GBP, HKD, HUF, JPY, NOK, NZD, PLN, SEK, SGD, USD

Italy

Mastercard,Visa,American Express (EUR only)

AUD, CAD, CHF, CZK, DKK, EUR, GBP, HKD, HUF, JPY, NOK, NZD, PLN, SEK, SGD, USD

Spain

Mastercard,Visa,American Express (EUR only)

AUD, CAD, CHF, CZK, DKK, EUR, GBP, HKD, HUF, JPY, NOK, NZD, PLN, SEK, SGD, USD

United States

Mastercard,Visa,American Express (USD only),Discover (USD only)

AUD, CAD, EUR, GBP, JPY, USD

United Kingdom

Mastercard,Visa,American Express (GBP, USD only)

AUD, CAD, CHF, CZK, DKK, EUR, GBP, HKD, HUF, JPY, NOK, NZD, PLN, SEK, SGD, USD