Sollte ich INSTRUMENT_DECLINED wiederholen?

Beim Checkout neu starten, damit der Käufer eine andere Zahlungsquelle wählen kann, wie PayPal empfiehlt. Bei Abonnements geben verteilte Wiederholungsversuche der Karte oder dem Guthaben des Käufers Zeit zur Erholung, da PayPal keinen Grund nennt, der eine Erholung ausschließt.

Ist INSTRUMENT_DECLINED eine Blockierung des PayPal-Kontos des Käufers?

Nein. Es geht um die spezifische Karte oder Bank, die sie ausgewählt haben. PayPal verwendet andere Fehler, wie PAYER_ACCOUNT_LOCKED_OR_CLOSED, für Kontoprobleme.

PayPal · Ablehnungscodes

Was bedeutet der PayPal INSTRUMENT_DECLINED Fehler?

Geprüft am 31. Oktober 2026

PayPals INSTRUMENT_DECLINED Fehler bedeutet, dass die vom Käufer gewählte Zahlungsquelle, eine Karte oder ein Bankkonto in seinem PayPal-Wallet, vom Prozessor oder der Bank abgelehnt wurde oder nicht für diese Zahlung verwendet werden kann. PayPal nennt Ursachen wie eine falsche Rechnungsadresse, eine Karte über ihrem Limit oder eine Bankablehnung. Die Lösung besteht darin, die Zahlung neu zu starten, damit der Käufer eine andere Zahlungsquelle auswählen kann.

PayPal Beschreibung: Das vorgelegte Instrument wurde entweder vom Prozessor oder der Bank abgelehnt, oder es kann nicht für diese Zahlung verwendet werden.
Typ: Soft Decline
Wer abgelehnt hat: Der Prozessor oder die Bank hinter der PayPal-Zahlungsquelle
Wiederholen: Ja, ein paar Tage später; Methode wechseln, wenn es sich wiederholt
Käuferaktion: Wählen Sie eine andere Karte oder Bank in PayPal und zahlen Sie erneut
Händleraktion: Starten Sie die Zahlung neu, damit der Käufer eine andere Quelle auswählen kann
PlatformDTC Verlängerung (Smart retry): PayPal-Leiter: bis zu 7 Versuche, im Abstand von 3+ Tagen, auf den Zahltag ausgerichtet

Was PlatformDTC macht

PlatformDTC behandelt INSTRUMENT_DECLINED als eine generische PayPal-Ablehnung. Wenn Smart retry aktiviert ist, durchläuft eine auf diese Weise abgelehnte PayPal-Abonnementverlängerung die längere PayPal-Leiter: bis zu 7 Versuche, jeder mindestens 3 Tage nach dem letzten, verschoben auf den nächsten Zahltag des Abonnenten, wenn dieser innerhalb einer Woche liegt, innerhalb eines Zeitfensters von mindestens 24 Tagen. Wenn die Wiederholungsversuche aufgebraucht sind, wird das Abonnement als überfällig gehalten, nicht storniert. Bei PayPal-Kartenzahlungen wird jeder Prozessorcode, den PlatformDTC nicht zuordnet, ebenfalls als INSTRUMENT_DECLINED erfasst, wobei der Rohcode beibehalten wird.

Warum es passiert

PayPal gibt dies zurück, wenn die Zahlungsquelle des Zahlers fehlschlägt: Die Karte oder Bank in ihrem PayPal-Wallet hat abgelehnt. PayPals Leitfaden für Zahlungsfehler listet eine falsche Rechnungsadresse, eine Transaktion über dem Kartenlimit und eine Ablehnung durch den Kartenaussteller als Beispiele auf.

Was der Käufer tun kann

Gehen Sie zurück zu PayPal und wählen Sie eine andere Karte, ein anderes Bankkonto oder Ihr PayPal-Guthaben.

Oder überprüfen Sie die Rechnungsadresse und das Limit der Karte und versuchen Sie es dann erneut.

Was der Shop tun kann

Starten Sie den Zahlungsfluss neu, damit der Käufer die PayPal-Zahlungsoptionen erneut sieht; zeigen Sie nicht nur einen Fehler an.

Bei Verlängerungen Wiederholungsversuche über Tage verteilen; das Guthaben des Käufers kann sich bis zum Zahltag erholen.

Für Entwickler

Wenn Sie von Ihrem Server erfassen und die Orders API INSTRUMENT_DECLINED zurückgibt (in `details[0].issue` des Fehlerkörpers), starten Sie die Zahlung neu: Rufen Sie im JavaScript SDK `actions.restart()` innerhalb von `onApprove` auf. PayPal sagt, dass ein Neustart erforderlich ist, wenn Sie die Orders API direkt von Ihrem Server aufrufen.

Wenn Sie mit `actions.order.capture()` im Browser erfassen, startet PayPals Skript den Checkout-Fluss automatisch neu und fordert den Zahler auf, eine andere Zahlungsquelle auszuwählen.

Häufige Fragen

Sollte ich INSTRUMENT_DECLINED wiederholen?: Beim Checkout neu starten, damit der Käufer eine andere Zahlungsquelle wählen kann, wie PayPal empfiehlt. Bei Abonnements geben verteilte Wiederholungsversuche der Karte oder dem Guthaben des Käufers Zeit zur Erholung, da PayPal keinen Grund nennt, der eine Erholung ausschließt.
Ist INSTRUMENT_DECLINED eine Blockierung des PayPal-Kontos des Käufers?: Nein. Es geht um die spezifische Karte oder Bank, die sie ausgewählt haben. PayPal verwendet andere Fehler, wie PAYER_ACCOUNT_LOCKED_OR_CLOSED, für Kontoprobleme.