PayPal-Zahlungslink und -Button – Tipps zur Fehlerbehebung
Ich erhalte eine Fehlermeldung und der Button wird nicht auf meiner Website angezeigt.
- Überprüfen Sie, ob Ihre Internetverbindung funktioniert.
- Besuchen Sie andere Seiten auf Ihrer Website und überprüfen Sie, ob sie korrekt geladen werden.
- Gehen Sie zur Seite "PayPal-Buttons" und überprüfen Sie Folgendes:
- Wird der Button unter "Gespeicherte Buttons" angezeigt?
- Wählen Sie Bearbeiten aus und stellen Sie sicher, dass der Button-Code mit dem auf Ihrer Website übereinstimmt.
- Klicken Sie mit der rechten Maustaste auf Ihre Produktseite (wo Sie den Button-Code eingefügt haben) und klicken Sie auf Prüfen. Gehen Sie zur Registerkarte "Konsole" (diese wird oben angezeigt). Möglicherweise werden CSP-Fehler angezeigt.
Wenn Sie eine Content Security Policy bereitgestellt haben, werden möglicherweise CSP-Fehler wie die folgenden angezeigt (Beispiel-CSP-Fehler):
- Das Laden des Skripts "https://www.paypal.com/sdk/js**" wurde abgelehnt, da es gegen die folgende Vorgabe der Content Security Policy verstößt: "default-src 'self'". Beachten Sie, dass "script-src-elem" nicht explizit gesetzt wurde, daher wird "default-src" als Fallback verwendet.
- Eine Verbindung zu "https://www.paypal.com/**" wurde abgelehnt, da sie gegen die folgende Vorgabe der Content Security Policy verstößt: "default-src 'self'". Beachten Sie, dass "connect-src" nicht explizit gesetzt wurde, daher wird "default-src" als Fallback verwendet.
- Inline-Skript konnte nicht ausgeführt werden, da es gegen die folgende Vorgabe der Content Security Policy verstößt: "script-src https://*.PayPal.com". Um die Inline-Ausführung zu aktivieren, ist entweder das Schlüsselwort "unsafe-inline", ein Hash ("sha256-WYDWDPwB8j2VePYrqy38aHPcJLsasO//lnXymmxscUk=") oder eine Nonce ("nonce-...") erforderlich.
- Das Bild "https://tracking.qa.paypal.com/webapps/tracking/ts?**'" konnte nicht geladen werden, weil es gegen die folgende Vorgabe der Content Security Policy verstößt: "default-src 'self'". Beachten Sie, dass "img-src" nicht explizit gesetzt wurde, daher wird "default-src" als Fallback verwendet.
- Das Framing von "https://www.paypal.com/" wurde abgelehnt, da es gegen die folgende Vorgabe der Content Security Policy verstößt: "default-src 'self'". Beachten Sie, dass "frame-src" nicht explizit gesetzt wurde, daher wird "default-src" als Fallback verwendet.
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 Kundenservice-PIN 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:
- Gehen Sie zur Seite mit PayPal-Buttons.
- Klicken Sie neben dem gespeicherten Button auf Öffnen und wählen Sie Bearbeiten aus.
- 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¤cy=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.
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:
- Gehen Sie zu Ihren Kontoeinstellungen.
- Wählen Sie Benachrichtigungen und Sofortige Zahlungsbenachrichtigungen aus.
- Klicken Sie auf Link aktualisieren.
So aktivieren Sie die IPN-Einstellungen:
- Fügen Sie die URL des IPN-Handlers hinzu, und wählen Sie IPN-Nachrichten empfangen (Aktiviert) aus.
- Klicken Sie auf Speichern.
Behandeln von IPN in Ihrem Servercode:
- Wenn Zahlungslink- und Button-Transaktionen abgeschlossen sind, ruft PayPal IPN die in Schritt 2 konfigurierte Benachrichtigungs-URL auf.
Zugriff auf IPN-Verlauf:
Referenzen
Einführung: https://developer.paypal.com/api/nvp-soap/ipn/IPNIntro/
Stellen Sie sicher, dass Sie die richtige IPN-URL im Servercode verwenden
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" 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=jp_JP
Beispiel:
<script src="……¤cy=USD&locale.x=jp_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 ein und ersetzen Sie die HostedButton_ID mit der tatsächlichen Button-ID.
<style> #paypal-container-<HostedButton_ID> {
#paypal-form-fields-container-<HostedButton_ID> {
#price-label {
display: none !important;
}
}
}
</style>
-
desc-label (für Produktname) -
price-label (für Preis)
style> #paypal-container-
<style>
#paypal-container-<HostedButton_ID>
{
#paypal-form-fields-container-<HostedButton_ID>
{
display: none !important;
}
}
</style>
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:
- Melden Sie sich mit den Anmeldedaten Ihres Händlerkontos beim Developer Dashboard an.
- Schalten Sie auf "Live" um.
- Klicken Sie auf Apps und Anmeldeinformationen.
- Scrollen Sie nach unten, und wählen Sie Webhooks verwalten aus.
- 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.
- 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"