Afwijzingscodes
PayPal weigeringscodes: wat elke code betekent en wat u kunt doen
Gecontroleerd op
PayPal meldt een mislukte betaling op twee manieren. Een kaartbetaling heeft een processorreactiecode, zoals 0500 DO_NOT_HONOR of 5120 INSUFFICIENT_FUNDS, ingesteld door de bank of processor. Elke PayPal-betaling kan ook mislukken met een Orders API-fout, zoals INSTRUMENT_DECLINED of PAYER_ACTION_REQUIRED. Elke pagina hieronder geeft de eigen betekenis van PayPal, wat de koper en de winkel kunnen doen, en wat PlatformDTC met die weigering doet.
| Code | Betekenis |
|---|---|
| 0100 | Referral: de bank van de kaart wil dat de kaarthouder contact opneemt voordat de betaling wordt goedgekeurd. |
| 0390 | Account niet gevonden: de bank heeft geen account dat overeenkomt met deze kaartgegevens. |
| 0500 | Niet honoreren: de bank van de kaart weigerde de betaling en gaf geen reden. |
| 0580 | Ongeautoriseerde transactie: de betaling is niet geautoriseerd voor deze kaart. |
| 0960 | Systeemstoring: een technische fout stopte de betaling, geen bankweigering. |
| 10BR | Uitgever geweigerd: de bank van de kaart heeft de betaling afgewezen. |
| 1310 | Ongeldig bedrag: het betalingsbedrag werd geweigerd als ongeldig. |
| 1320 | Ongeldige valutacode: de valuta van de betaling kan hier niet worden gebruikt. |
| 1330 | Ongeldige rekening: de rekening van de kaart is niet geldig voor betalingen. |
| 1380 | Ongeldige vervaldatum: de verzonden vervaldatum komt niet overeen met een geldige kaart. |
| 1382 | Ongeldige kaartverificatiecode: de beveiligingscode (CVV) is geweigerd. |
| 5100 | Generieke weigering: de kaart is geweigerd en er is geen reden opgegeven. |
| 5110 | CVV2-fout: de beveiligingscode van de kaart kwam niet overeen. |
| 5120 | Onvoldoende saldo: de kaart heeft niet genoeg geld of krediet voor deze betaling. |
| 5140 | Kaart gesloten: de rekening van de kaart is gesloten door de bank of kaarthouder. |
| 5150 | Kaart innemen, speciale voorwaarden: de bank wil dat deze kaart niet meer wordt gebruikt. |
| 5160 | Ongeautoriseerde gebruiker: de betalende persoon is niet geautoriseerd om deze kaart te gebruiken. |
| 5170 | AVS-fout: het factuuradres kwam niet overeen met de gegevens van de bank. |
| 5180 | Ongeldige of beperkte kaart: deze kaart kan niet worden gebruikt; PayPal zegt probeer een andere. |
| 5200 | Dubbele transactie: een overeenkomende betaling is al ingediend. |
| 5400 | Vervallen kaart: de kaart is voorbij de vervaldatum. |
| 5650 | SCA vereist: de bank heeft de kaarthouder nodig om de betaling te authenticeren. |
| 5700 | Transactie niet toegestaan: valt buiten de geaccepteerde bedrijfsactiviteiten voor deze kaart. |
| 5710 | Pogingen overschrijden limiet: te veel betaalpogingen met deze kaart. |
| 5910 | Uitgever niet beschikbaar, niet opnieuw te proberen: de bank kon niet worden bereikt en PayPal zegt niet opnieuw te proberen. |
| 5920 | Uitgever niet beschikbaar, opnieuw te proberen: de bank kon niet worden bereikt; probeer het later opnieuw. |
| 5930 | Kaart niet geactiveerd: de kaart is nog niet geactiveerd door de kaarthouder. |
| 5950 | Bijgewerkt account: een bijgewerkte kaart is uitgegeven, dus de oude gegevens werden geweigerd. |
| 6300 | Account niet bekend: de bank heeft geen gegevens van deze kaartrekening. |
| 7710 | Authenticatie mislukt: de 3-D Secure controle is niet geslaagd. |
| 8000 | Systeemfout van de processor: een technische storing bij de processor heeft de betaling gestopt. |
| 9100 | Geweigerd, probeer het opnieuw: een tijdelijke weigering; het advies van PayPal is om het opnieuw te proberen. |
| 9500 | Vermoedelijke fraude: de betaling werd gemarkeerd; PayPal zegt een andere kaart te gebruiken. |
| 9510 | Beveiligingsschending: de betaling overtrad een beveiligingsregel en werd geweigerd. |
| 9520 | Verloren of gestolen: de kaart is als verloren of gestolen gemeld; PayPal zegt een andere kaart te gebruiken. |
| 9530 | Vasthouden, callcenter: de winkelier moet het nummer op de achterkant van de kaart bellen. |
| 9540 | Geweigerde kaart: de kaart werd geweigerd voor deze betaling. |
| 00N7 | CVV2-fout, probeer opnieuw met CVV: de beveiligingscode is mislukt; probeer het opnieuw met de juiste. |
| PCVV | CVV-fout: de controle van de beveiligingscode van de kaart is mislukt. |
| PP06 | Account gesloten: een voorheen open account is nu gesloten. |
| PPRN | Herpoging niet toegestaan: een nieuwe poging voor deze betaling is niet toegestaan. |
| PPAB | Rekening geblokkeerd door uitgever: de bank van de kaart heeft de rekening geblokkeerd. |
| PPAD | Factuuradres: de betaling werd geweigerd vanwege het factuuradres. |
| PPAX | Bedrag overschreden: de betaling overschrijdt een limiet op de kaart of rekening. |
| PPCT | Kaarttype niet ondersteund: dit type kaart wordt niet geaccepteerd voor de betaling. |
| PPD3 | 3-D Secure fout: de kaartauthenticatiestap had een fout. |
| PPEF | Verlopen betaalmiddel: de kaart of rekening die is gebruikt om te betalen, is verlopen. |
| PPEL | Frequentielimiet overschreden: te veel betalingen in een periode met deze kaart. |
| PPEX | Vervaldatum: de betaling werd geweigerd vanwege de vervaldatum van de kaart. |
| PPFR | Beperkt betaalinstrument: de kaart of rekening heeft een beperking. |
| INSTRUMENT_DECLINED | Betaalinstrument geweigerd: de kaart of bankrekening in de PayPal van de koper werd geweigerd. |
| PAYER_ACTION_REQUIRED | Actie van de betaler vereist: de koper moet teruggaan naar PayPal om de betaling af te ronden. |
| PAYER_CANNOT_PAY | Betaler kan niet betalen: de PayPal-instellingen van deze koper en deze verkoper staan de betaling niet toe. |
| TRANSACTION_REFUSED | Transactie geweigerd: PayPal heeft het verzoek geweigerd zonder specifieke reden. |
| PAYEE_ACCOUNT_RESTRICTED | Payee account restricted: het PayPal-account van de verkoper is beperkt. |
| PAYER_ACCOUNT_LOCKED_OR_CLOSED | Payer account locked or closed: het PayPal-account van de koper kan niet worden gebruikt. |
| COMPLIANCE_VIOLATION | Nalevingsschending: PayPal heeft de betaling geweigerd op grond van naleving. |
| MAX_NUMBER_OF_PAYMENT_ATTEMPTS_EXCEEDED | Maximum aantal betalingspogingen overschreden: te veel pogingen voor deze bestelling. |
| CARD_EXPIRED | Kaart verlopen: de kaart die via PayPal is gebruikt, is verlopen. |
| CARD_TYPE_NOT_SUPPORTED | Kaarttype niet ondersteund: dit type kaart kan niet worden verwerkt; gebruik een andere. |
| AGREEMENT_ALREADY_CANCELLED | Overeenkomst al geannuleerd: de PayPal-factureringsovereenkomst van de koper is geannuleerd. |
| REDIRECT_PAYER_FOR_ALTERNATE_FUNDING | Omleiding voor alternatieve financiering: stuur de koper terug om een andere betaalmethode te kiezen. |
| TRANSACTION_BLOCKED_BY_PAYEE | Geblokkeerd door begunstigde: de eigen PayPal fraude-instellingen van de verkoper hebben de betaling geblokkeerd. |
| PAYEE_BLOCKED_TRANSACTION | Begunstigde heeft transactie geblokkeerd: de PayPal fraudetool van de verkoper heeft deze geweigerd. |
| TRANSACTION_LIMIT_EXCEEDED | Transactielimiet overschreden: het totaalbedrag overschrijdt een PayPal-transactielimiet. |
| PAYMENT_DENIED | Betaling geweigerd: PayPal weigerde de transactie te verwerken. |
Processorreactiecodes en Orders API-fouten
Processorreactiecodes zijn viercijferige waarden die PayPal retourneert bij een geweigerde kaartafschrijving of autorisatie, in `processor_response.response_code`. Ze komen van de bank van de kaart of de processor en zijn het dichtst bij een bankweigeringsreden die PayPal geeft. PayPal publiceert elke code met een korte naam (bijvoorbeeld 9500 SUSPECTED_FRAUD) en, voor enkele, een instructie zoals "Probeer een andere kaart te gebruiken. Probeer dezelfde kaart niet opnieuw."
Orders API-fouten zijn de namen van problemen die PayPal retourneert wanneer een verzoek mislukt, bijvoorbeeld INSTRUMENT_DECLINED wanneer de betaalmethode van de koper wordt geweigerd, of PAYER_ACTION_REQUIRED wanneer de koper terug moet naar PayPal. Ze zijn van toepassing op zowel PayPal-walletbetalingen als kaartbetalingen.
PayPal-kaartbetalingen en PayPal-walletbetalingen
Wanneer een klant een kaart invoert in de kaartvelden van PayPal, komt de weigering meestal met een processorreactiecode van de bank van de kaart, zodat de reden zo specifiek kan zijn als een verlopen kaart of een mislukte beveiligingscode.
Wanneer een klant betaalt met zijn PayPal-wallet, kiest PayPal de betaalmethode binnen de wallet en meldt meestal een mislukking als een Orders API-fout zoals INSTRUMENT_DECLINED. Het advies van PayPal voor dat geval is om de betaling opnieuw te starten, zodat de koper een andere betaalmethode kan kiezen.
Wat PlatformDTC doet met PayPal-weigeringen
PlatformDTC zet elke PayPal-kaartprocessorcode die het herkent om in een eenvoudig weigeringstype (onvoldoende saldo, verlopen kaart, bankweigering zonder reden, tijdelijke fout, authenticatie nodig of een ongeldige kaart) en bewaart de ruwe code in het foutbericht voor ondersteuning.
Met Smart retry ingeschakeld, krijgen PayPal-abonnementsverlengingen die mislukken wegens onvoldoende saldo of met een algemene PayPal-weigering een langere reeks pogingen dan kaarten: tot 7 pogingen, elk minstens 3 dagen na de vorige, verplaatst naar de volgende betaaldag van de abonnee wanneer deze binnen een week valt, binnen een venster van minstens 24 dagen. Ongeldige overeenkomsten en gesloten of geblokkeerde PayPal-accounts worden nooit opnieuw geprobeerd: het abonnement wordt onmiddellijk geannuleerd, ongeacht de instelling. Harde weigeringen (ongeldige, verlopen of beperkte kaarten, PAYER_CANNOT_PAY) worden op geen van beide schema's opnieuw geprobeerd, inclusief het standaard Vaste schema: het abonnement wordt als achterstallig beschouwd en de klant wordt om een nieuwe betaalmethode gevraagd. Weigeringen veroorzaakt door het eigen PayPal-account van de winkel (PAYEE_ACCOUNT_RESTRICTED, PAYEE_BLOCKED_TRANSACTION) worden nooit aan de klant toegeschreven: de verlenging wordt gepauzeerd, automatisch opnieuw geprobeerd en de handelaar krijgt een dashboardwaarschuwing.
Veelgestelde vragen
- Waar vind ik de PayPal-weigeringscode voor een bestelling?
- Voor kaartbetalingen, in de `processor_response.response_code` van de afschrijving of autorisatie. Voor elke PayPal-betaling benoemt de foutbody van het mislukte verzoek het probleem, zoals INSTRUMENT_DECLINED, in `details[0].issue`.
- Welke PayPal-weigeringscodes mogen nooit opnieuw geprobeerd worden?
- PayPal zelf zegt dat u dezelfde kaart niet opnieuw moet proberen voor 5150, 5180, 9500 en 9520. Verlopen, gesloten of ongeldige kaarten, mislukte beveiligingscodes en geannuleerde factureringsovereenkomsten zullen ook niet slagen bij een nieuwe poging.
- Waarom zegt PayPal INSTRUMENT_DECLINED zonder reden?
- De fout omvat elke weigering van de door de koper gekozen betaalmethode door de processor of bank. Het advies van PayPal is om de betaling opnieuw te starten, zodat de koper een andere bron kan kiezen.
- Probeert PlatformDTC PayPal-abonnementsbetalingen opnieuw?
- Ja, voor weigeringen die kunnen herstellen. Met Smart retry ingeschakeld, krijgen onvoldoende saldo en algemene weigeringen tot 7 pogingen over minstens 24 dagen, tijdelijke fouten tot 4, en bankweigeringen zonder reden één; op het standaard Vaste schema worden ze opnieuw geprobeerd met 1, 3, 5 en 7 dagen ertussen. Ongeldige kaarten, verlopen kaarten en gesloten accounts worden op geen van beide schema's opnieuw geprobeerd.
Bronnen
- Orders v2 API-schema: `processor_response.response_code` — PayPal
- Orders v2 API-fouten — PayPal
- Omgaan met mislukte betalingen — PayPal