PayPal-Zahlungslinks und -Buttons – Tipps zur Fehlerbehebung

Ich erhalte eine Fehlermeldung und der Button wird nicht auf meiner Website angezeigt.

1. Überprüfen Sie, ob Ihre Internetverbindung funktioniert.
2. Rufen Sie andere Seiten Ihrer Website auf und überprüfen Sie, ob sie korrekt geladen werden.
3. Rufen Sie die Seite mit den PayPal-Buttons auf und überprüfen Sie Folgendes:
   * Wird der Button unter "Gespeicherte Buttons" angezeigt?
   * Wählen Sie Bearbeiten und stellen Sie sicher, dass der Code des Buttons mit dem Inhalt auf Ihrer Website übereinstimmt.
4. Klicken Sie mit der rechten Maustaste auf Ihre Produktseite (wo Sie die Button-Code eingefügt haben) und klicken Sie auf "Prüfen". Gehen Sie zur Registerkarte "Konsole" (diese wird oben angezeigt). Sie sehen womöglich CSP-Fehler. Wenn Sie eine Richtlinie zur Inhaltssicherheit bereitgestellt haben, werden möglicherweise CSP-Fehler angezeigt, z.B. (Beispiel-CSP-Fehler):

• Das Laden des Skripts ‘https://www.paypal.com/sdk/js**’ wurde abgelehnt, da es gegen die folgende Anweisung der Inhaltssicherheitsrichtlinie verstößt: "default-src 'self'". Beachten Sie, dass 'script-src-elem' nicht ausdrücklich festgelegt wurde und daher 'default-src' als Fallback verwendet wird.
• Das Herstellen einer Verbindung zu 'https://www.paypal.com/**' wurde abgelehnt, da es gegen die folgende Anweisung der Inhaltssicherheitsrichtlinie verstößt: "default-src 'self'". Beachten Sie, dass 'connect-src' nicht ausdrücklich festgelegt wurde und daher 'default-src' als Fallback verwendet wird.
• Das Ausführen des Inline-Skripts wurde abgelehnt, da es gegen die folgende Anweisung der Inhaltssicherheitsrichtlinie verstößt: "script-src https://*.paypal.com". Um die Inline-Ausführung zu aktivieren, ist entweder das Stichwort 'unsafe-inline', ein Hash ('sha256-WYDWDPwB8j2VePYrqy38aHPcJLsasO//lnXymmxscUk=') oder eine Nonce ('nonce-...') erforderlich.
• Das Laden des Bildes 'https://tracking.qa.paypal.com/webapps/tracking/ts?**' wurde abgelehnt, da es gegen die folgende Anweisung der Inhaltssicherheitsrichtlinie verstößt: "default-src 'self'". Beachten Sie, dass 'img-src' nicht ausdrücklich festgelegt wurde und daher 'default-src' als Fallback verwendet wird.
• Das Framing von 'https://www.paypal.com/' wurde abgelehnt, da es gegen die folgende Anweisung der Inhaltssicherheitsrichtlinie verstößt: "default-src 'self'". Beachten Sie, dass 'frame-src' nicht ausdrücklich festgelegt wurde und daher 'default-src' als Fallback verwendet wird.

Sie können versuchen, Folgendes hinzuzufügen, um einen der oben genannten Fehler zu beheben:

Option 1 (HTML): Wenn Ihre Kundenservice-PIN in einer HTML-Datei konfiguriert ist, verwenden Sie den folgenden Code, um Ihren CSP-Code zu ersetzen

<meta http-equiv="Content-Security-Policy" content="default-src 'self';
script-src 'unsafe-inline' https://*.paypal.com https://*.paypalobjects.com;
style-src 'unsafe-inline' https://*.paypal.com; connect-src
https://*.paypal.com; frame-src https://*.paypal.com; img-src
https://*.paypal.com https://*.paypalobjects.com">

Option 2 (serverseitig): Wenn Ihre CSP serverseitig konfiguriert ist, verwenden Sie den folgenden Code, um Ihren CSP-Code zu ersetzen

Content-Security-Policy: script-src 'unsafe-inline' https://*.paypal.com https://*.paypalobjects.com
Content-Security-Policy: style-src 'unsafe-inline' https://*.paypal.com
Content-Security-Policy: connect-src https://*.paypal.com
Content-Security-Policy: frame-src https://*.paypal.com
Content-Security-Policy: img-src https://*.paypal.com https://*.paypalobjects.com

Wie ändere ich das Layout/die Größe/die Farbe des Produktnamens/des Produktpreises/der  Produktmenge?

So ändern Sie Layout/Größe/Farbe des Produktnamens/Preis/Menge auf der PayPal-Website:

1. Gehen Sie zur Seite mit PayPal-Buttons.
2. Klicken Sie neben dem gespeicherten Button auf Öffnen und wählen Sie Bearbeiten aus.
3. Klicken Sie auf Buttons anpassen und nehmen Sie die erforderlichen Änderungen vor.

Ich habe Produktinformationen bearbeitet (Name, Betrag oder Sonstiges); muss ich

den Button-Code erneut kopieren/einfügen?

Nein, wir beziehen alle Informationen vom PayPal-Server. Sobald Sie die Änderungen in Ihrem Konto gespeichert haben, müssen Sie die kopierte und eingefügte Button-ID Ihrer Website nicht mehr aktualisieren. 

Hinweis: Wenn Sie den Währungscode auf Ihrem Produkt ändern,  müssen Sie Ihren Zahlungsbutton aktualisieren.

Ich sehe eine Client-ID im Code. Was bedeutet das?

Die Client-ID ist die Kunden-ID des Händlers, die Teil Ihres Kontos ist. Sie sollten sie nicht bearbeiten. Verwenden Sie sie so, wie es im Button-Code angeboten wird.

Ich habe mehrere Buttons hinzugefügt, aber keiner wird auf meiner Webseite angezeigt.

In folgenden Fällen können auf derselben Webseite nicht mehrere Buttons verwendet werden:

• Wenn Sie dieselbe Button-ID mehrmals auf derselben Webseite kopiert/eingefügt haben, wird nur der erste Button angezeigt. Sie können dieselbe Button-ID nicht mehrmals wiederholen.
• Wenn Sie verschiedene Button-IDs kopiert/eingefügt haben, aber mit anderen Währungen auf derselben Webseite, wird nur der erste Button angezeigt. Fremdwährungen können nicht über Buttons auf derselben Webseite hinzugefügt werden.
• Wenn Sie verschiedene Button-IDs kopiert/eingefügt haben und Ihre Internetverbindung langsam ist, stellen Sie sicher, dass das Skript-Tag mit der Client-ID nur einmal hinzugefügt wird. Die Skriptzeile sieht wie folgt aus:
  

  • <Skript src="https://www.paypal.com/sdk/js?client-id=XYZ&components=hosted-buttons&enable-funding=venmo&currency=USD"></script> 

Ich habe ein Premier-PayPal-Konto und sehe keine Zahlungslinks und -Buttons als

Option.

Diese Funktion ist nur für geschäftliche PayPal-Konten verfügbar. Um diese Funktion zu nutzen, ändern Sie Ihr Konto oder erstellen Sie ein Geschäftskonto.

Wie teste ich diese Erfahrung auf PayPal Sandbox?

Die Zahlungslinks und -Buttons können in der Sandbox getestet werden.

Mein Kunde hat mir mitgeteilt, dass nicht alle Zahlungsmethoden angezeigt werden.

Zahlungsmethoden wie PayPal, Später bezahlen und Venmo hängen von der Berechtigung im jeweiligen Land ab.

Die Inlineerweiterung "Kredit/Debit" wird auf meiner Seite nicht vollständig

angezeigt.

Stellen Sie sicher, dass die Breite und Höhe des übergeordneten Containers so festgelegt sind, dass sie die Inlineerweiterung ermöglichen. Weitere Informationen finden Sie in der Dokumentation/im Support Ihrer Hosting-Plattform.

Unterstützen Zahlungslinks und -Buttons IPN (Sofortige Zahlungsbestätigung)?

Ja. Führen Sie die folgenden Schritte aus, um IPN einzurichten und zu aktivieren.

So finden Sie die Einrichtung von IPN in PayPal:

1. Gehen Sie zu Ihren Kontoeinstellungen.
2. Wählen Sie Benachrichtigungen und Sofortige Zahlungsbenachrichtigungen aus.
3. Klicken Sie auf Link aktualisieren.

So aktivieren Sie die IPN-Einstellungen:

1. Fügen Sie die URL des IPN-Handlers hinzu, und wählen Sie IPN-Nachrichten empfangen (Aktiviert) aus.
2. Klicken Sie auf Speichern.

IPN in Ihrem Servercode verarbeiten:

• Wenn Zahlungslink- und Button-Transaktionen abgeschlossen sind, ruft PayPal IPN die in Schritt 2 konfigurierte Benachrichtigungs-URL auf.

Zugriff auf den IPN-Verlauf:

• https://www.sandbox.paypal.com/merchantnotification/ipn/history
• https://www.paypal.com/merchantnotification/ipn/history

Referenzen

Einführung: https://developer.paypal.com/api/nvp-soap/ipn/IPNIntro/

Stellen Sie sicher, dass Sie die richtige IPN-URL im Servercode verwenden

• Sandbox https://www.sandbox.paypal.com/cgi-bin/webscr
• Live https://www.paypal.com/cgi-bin/webscr

Beispiele für verschiedene Sprachen GitHub - paypal/ipn-code-samples

Welche Informationen über den

Kauf sendet PayPal, wenn ein Kunde auf die Weiterleitungsseite geleitet wird? Unterstützen Zahlungslinks und -Buttons PDT (Übertragung der Zahlungsdaten)?

Welche Variablen werden unterstützt?

Ja, wir unterstützen PDT-Variablen, wie hier dokumentiert. Sie erhalten PDT, wenn Sie die Einstellung für die automatische Rückleitung während der Konfiguration für Zahlungslink und -Button aktivieren. 

Unterstützen Zahlungslinks und -Buttons ein Gebietsschema, wenn es manuell vom

Händler im Button-Code oder Zahlungslink hinzugefügt wurde?

Standardmäßig verwenden Zahlungslinks und -Buttons die Browsereinstellungen des Kunden, um den entsprechenden Button-Code und den Zahlungslink anzuzeigen.

Händler können dies nur für den Zahlungslink- und -Button-Code überschreiben, indem sie "locale.x=fr_FR and country.x=" als Abfrageparameter anhängen. Die Liste der unterstützten Codes für Gebietsschemata finden Sie hier. Texte, die ein Händler während der Konfiguration eingibt, werden nicht übersetzt.

Beispiel: https://www.paypal.com/ncp/payment/F3YMU2ZGT49XX?locale.x=ja_JP&country.x=JP

Beispiel: 

<script src="……..¤cy=USD&locale.x=ja_JP&country.x=JP"></script> 

Ist es möglich, einige der Etiketten auszublenden, die aus dem Code der Zahlungslinks und

-Buttons stammen?

Wir verstehen, dass Sie möglicherweise eine andere visuelle Einrichtung auf Ihrer Website haben, wir empfehlen jedoch nicht, den von uns bereitgestellten Button-Code auszublenden. 

Wenn Sie ihn auf Ihrer Website ausblenden, ändert sich nichts an der Art und Weise, wie die Transaktion verarbeitet wird. Für die Transaktion wird weiterhin die Konfiguration Ihrer gehosteten Button-ID verwendet. 

Sie können den Text um Buttons herum teilweise oder vollständig ausblenden, sobald Sie einen Button-Typ verwenden, für den keine Kundeneingabe erforderlich ist. Wenn Ihr Kunde beispielsweise die Auswahlliste für die Menge oder mehrere Artikel auswählen muss und Sie diese Eingabeelemente ausgeblendet haben, schlägt die Transaktion fehl. 

Hier ist ein Beispiel dafür, wie Sie den Preis eines Artikels ausblenden können:

Fügen Sie dieses Skript unter Ihrem Button-Code hinzu und ersetzen Sie die <HostedButton_ID> durch die tatsächliche Button-ID.

Ist es möglich, meine Zahlungslinks und -Buttons zu überschreiben, um den "Versand aus

Einstellungen" zu verwenden?

Zahlungslinks und -Buttons berücksichtigen keine Massenüberschreibung des Versands aus den Kontoeinstellungen, auch bekannt als die folgende Einstellung aus den Versandeinstellungen.

Ich habe die Währung meines Buttons geändert, aber er wird auf der Website nicht aktualisiert

angezeigt.

Wenn Sie die Währung eines Buttons ändern, nachdem Sie ihn bereits auf Ihrer Website eingefügt haben, müssen Sie den Button-Code erneut auf Ihrer Website kopieren und einfügen. 

Ich kann "Versand aus Einstellungen verwenden" und "Steuer aus

Einstellungen verwenden" nicht auswählen, wenn ich "Lieferadresse nicht erfassen" auswähle.

Die Auswahl von Versand und Steuern in den Einstellungen richtet sich nach der Postleitzahl und/oder dem Land des Kunden. Wenn Sie "Lieferadresse nicht erfassen" auswählen, erhalten Sie nicht die Lieferadresse des Kunden, um die Berechnung von Versand und Steuern in den Einstellungen zu ermöglichen. Wir empfehlen Ihnen, andere Optionen aus den Dropdown-Menüs "Versandgebühr" und "Steuersatz" zu verwenden.

Unterstützen Zahlungslinks und -Buttons Webhooks?

Ja. So aktivieren Sie Webhooks:

1. Melden Sie sich mit den Anmeldedaten Ihres Händlerkontos beim Developer Dashboard an.
2. Schalten Sie auf "Live" um.
3. Klicken Sie auf Apps und Anmeldeinformationen.
4. Scrollen Sie nach unten, und wählen Sie Webhooks verwalten aus.
5. Sie können jetzt eine Webhook-URL für Live hinzufügen. Wenn Sie Webhooks für Sandbox hinzufügen möchten, bleiben Sie auf dieser Seite und wechseln Sie von Live zu Sandbox in der oberen rechten Ecke.
6. Fügen Sie Ihre Webhooks-Callback-URL hinzu, wählen Sie alle Ereignisse oder Checkouts, Zahlungsereignisse, die von PayPal bei ausgewählten Ereignissen aufgerufen werden, abhängig von Ihrer NVP- oder SOAP-API-Implementierung. Rufen Sie die PayPal NVP/SOAP-API für Webhook-Informationen auf.

Beispiel für eine Webhook-Antwort:

"id": "WH-12D11567VE3425924-2G120938U32719946", 
"event_version": "1.0", 
"create_time": "2024-09-14T15:55:58.043Z", 
"resource_type": "capture", 
"resource_version": "2.0", 
"event_type": "PAYMENT.CAPTURE.COMPLETED", 
"summary": "Zahlung über 128,88 USD abgeschlossen", 
"resource": { 
"supplementary_data": { 
"related_ids": { 
"order_id": "8LM68409BR5528307" 
} 
], 
"id": "7KK30254642170736", 
"status": "COMPLETED"