Moet ik INSTRUMENT_DECLINED opnieuw proberen?

Bij het afrekenen, opnieuw starten zodat de koper een andere betaalmethode kan kiezen, zoals PayPal aanbeveelt. Voor abonnementen geven gespreide herhaalpogingen de kaart of het saldo van de koper tijd om te herstellen, aangezien PayPal geen reden noemt die herstel uitsluit.

Wordt met INSTRUMENT_DECLINED de PayPal-rekening van de koper geblokkeerd?

Nee. Het gaat om de specifieke kaart of bankrekening die ze hebben gekozen. PayPal gebruikt andere fouten, zoals PAYER_ACCOUNT_LOCKED_OR_CLOSED, voor accountproblemen.

PayPal · Afwijzingscodes

Wat betekent de PayPal INSTRUMENT_DECLINED fout?

Gecontroleerd op 31 oktober 2026

De INSTRUMENT_DECLINED fout van PayPal betekent dat de betaalmethode die de koper koos, een kaart of bankrekening in hun PayPal-portemonnee, werd geweigerd door de processor of bank, of niet kan worden gebruikt voor deze betaling. PayPal noemt oorzaken zoals een verkeerd factuuradres, een kaart die de limiet heeft overschreden, of een weigering door de bank. De oplossing is om de betaling opnieuw te starten zodat de koper een andere betaalmethode kan kiezen.

PayPal beschrijving: Het gepresenteerde betaalinstrument werd geweigerd door de processor of bank, of kan niet worden gebruikt voor deze betaling.
Type: Zachte weigering
Wie weigerde: De processor of bank achter de PayPal betaalmethode
Opnieuw proberen: Ja, een paar dagen later; wissel van methode als het zich herhaalt
Actie van de koper: Kies een andere kaart of bankrekening in PayPal en betaal opnieuw
Actie van de winkelier: Start de betaling opnieuw zodat de koper een andere bron kan kiezen
PlatformDTC verlenging (Smart retry): PayPal ladder: tot 7 pogingen, met minstens 3 dagen ertussen, gericht op de betaaldag

Wat PlatformDTC doet

PlatformDTC behandelt INSTRUMENT_DECLINED als een algemene PayPal weigering. Met Smart retry ingeschakeld, volgt een PayPal abonnementsverlenging die op deze manier wordt geweigerd de langere PayPal ladder: tot 7 pogingen, elk minstens 3 dagen na de vorige, verplaatst naar de volgende betaaldag van de abonnee als deze binnen een week valt, binnen een periode van minstens 24 dagen. Als de herhaalpogingen op zijn, wordt het abonnement als achterstallig beschouwd, niet geannuleerd. Bij PayPal kaartbetalingen wordt elke processor code die PlatformDTC niet toewijst ook geregistreerd als INSTRUMENT_DECLINED, waarbij de ruwe code behouden blijft.

Waarom het gebeurt

PayPal geeft dit terug wanneer de betaalmethode van de betaler faalt: de kaart of bankrekening in hun PayPal-portemonnee zei 'nee'. De handleiding voor betaalfouten van PayPal noemt een onjuist factuuradres, een transactie boven de kaartlimiet, en een weigering door de kaartuitgever als voorbeelden.

Wat de koper kan doen

Ga terug naar PayPal en kies een andere kaart, bankrekening of uw PayPal-saldo.

Of controleer het factuuradres en de limiet van de kaart, probeer het dan opnieuw.

Wat de winkel kan doen

Start de betaalstroom opnieuw zodat de koper de betaalopties van PayPal opnieuw ziet; toon niet alleen een foutmelding.

Bij verlengingen, verdeel herhaalpogingen over meerdere dagen; het saldo van de koper kan herstellen tegen de betaaldag.

Voor ontwikkelaars

Wanneer u afschrijft vanaf uw server en de Orders API INSTRUMENT_DECLINED teruggeeft (in details[0].issue van de foutmelding), start de betaling opnieuw: roep in de JavaScript SDK actions.restart() aan binnen onApprove. PayPal zegt dat opnieuw starten vereist is als u de Orders API rechtstreeks vanaf uw server aanroept.

Als u afschrijft met actions.order.capture() in de browser, start het script van PayPal de checkout-stroom automatisch opnieuw en vraagt de betaler om een andere betaalmethode te kiezen.

Veelgestelde vragen

Moet ik INSTRUMENT_DECLINED opnieuw proberen?: Bij het afrekenen, opnieuw starten zodat de koper een andere betaalmethode kan kiezen, zoals PayPal aanbeveelt. Voor abonnementen geven gespreide herhaalpogingen de kaart of het saldo van de koper tijd om te herstellen, aangezien PayPal geen reden noemt die herstel uitsluit.
Wordt met INSTRUMENT_DECLINED de PayPal-rekening van de koper geblokkeerd?: Nee. Het gaat om de specifieke kaart of bankrekening die ze hebben gekozen. PayPal gebruikt andere fouten, zoals PAYER_ACCOUNT_LOCKED_OR_CLOSED, voor accountproblemen.