Dovrei riprovare INSTRUMENT_DECLINED?

Al checkout, riavvia in modo che l'acquirente possa scegliere un'altra fonte di finanziamento, come raccomanda PayPal. Per gli abbonamenti, i tentativi distanziati danno alla carta o al saldo dell'acquirente il tempo di recuperare, poiché PayPal non indica alcuna ragione che escluda il recupero.

INSTRUMENT_DECLINED significa che l'account PayPal dell'acquirente è bloccato?

No. Riguarda la specifica carta o banca che hanno scelto. PayPal utilizza altri errori, come PAYER_ACCOUNT_LOCKED_OR_CLOSED, per problemi di account.

PayPal · Codici di rifiuto

Cosa significa l'errore PayPal INSTRUMENT_DECLINED?

Verificato il 31 ottobre 2026

L'errore INSTRUMENT_DECLINED di PayPal significa che la fonte di finanziamento scelta dall'acquirente, una carta o un conto bancario nel loro wallet PayPal, è stata rifiutata dal processore o dalla banca, o non può essere utilizzata per questo pagamento. PayPal elenca cause come un indirizzo di fatturazione errato, una carta che ha superato il limite o un rifiuto bancario. La soluzione è riavviare il pagamento in modo che l'acquirente possa scegliere un'altra fonte di finanziamento.

Descrizione PayPal: Lo strumento presentato è stato rifiutato dal processore o dalla banca, oppure non può essere utilizzato per questo pagamento.
Tipo: Rifiuto soft
Chi ha rifiutato: Il processore o la banca dietro la fonte di finanziamento PayPal
Riprova: Sì, qualche giorno dopo; cambia metodo se si ripete
Azione dell'acquirente: Scegli un'altra carta o banca in PayPal e paga di nuovo
Azione del commerciante: Riavvia il pagamento in modo che l'acquirente possa scegliere un'altra fonte
Rinnovo PlatformDTC (Smart retry): Scala PayPal: fino a 7 tentativi, a distanza di 3+ giorni, mirati al giorno di paga

Cosa fa PlatformDTC

PlatformDTC tratta INSTRUMENT_DECLINED come un rifiuto generico di PayPal. Con Smart retry attivo, un rinnovo di abbonamento PayPal rifiutato in questo modo segue la scala PayPal più lunga: fino a 7 tentativi, ciascuno almeno 3 giorni dopo il precedente, spostati al prossimo giorno di paga dell'abbonato quando uno cade entro una settimana, all'interno di una finestra di almeno 24 giorni. Quando i tentativi si esauriscono, l'abbonamento viene mantenuto in scadenza, non annullato. Sui pagamenti con carta PayPal, qualsiasi codice processore che PlatformDTC non mappa viene anche registrato come INSTRUMENT_DECLINED, mantenendo il codice originale.

Perché succede

PayPal restituisce questo quando la fonte di finanziamento del pagatore fallisce: la carta o la banca all'interno del loro wallet PayPal ha detto di no. La guida di PayPal sui fallimenti di finanziamento elenca un indirizzo di fatturazione errato, una transazione che supera il limite della carta e un rifiuto dell'emittente della carta come esempi.

Cosa può fare l'acquirente

Torna su PayPal e scegli una carta, un conto bancario o il tuo saldo PayPal diverso.

Oppure controlla l'indirizzo di fatturazione e il limite della carta, quindi riprova.

Cosa può fare il negozio

Riavvia il flusso di pagamento in modo che l'acquirente veda di nuovo le scelte di finanziamento di PayPal; non mostrare solo un errore.

Sui rinnovi, distanzia i tentativi su più giorni; il saldo dell'acquirente potrebbe recuperare entro il giorno di paga.

Per gli sviluppatori

Quando acquisisci dal tuo server e l'API Orders restituisce INSTRUMENT_DECLINED (in `details[0].issue` del corpo dell'errore), riavvia il pagamento: nel JavaScript SDK, chiama `actions.restart()` all'interno di `onApprove`. PayPal afferma che il riavvio è richiesto se chiami l'API Orders direttamente dal tuo server.

Se acquisisci con `actions.order.capture()` nel browser, lo script di PayPal riavvia automaticamente il flusso di checkout e chiede al pagatore di scegliere un'altra fonte di finanziamento.

Domande frequenti

Dovrei riprovare INSTRUMENT_DECLINED?: Al checkout, riavvia in modo che l'acquirente possa scegliere un'altra fonte di finanziamento, come raccomanda PayPal. Per gli abbonamenti, i tentativi distanziati danno alla carta o al saldo dell'acquirente il tempo di recuperare, poiché PayPal non indica alcuna ragione che escluda il recupero.
INSTRUMENT_DECLINED significa che l'account PayPal dell'acquirente è bloccato?: No. Riguarda la specifica carta o banca che hanno scelto. PayPal utilizza altri errori, come PAYER_ACCOUNT_LOCKED_OR_CLOSED, per problemi di account.

Fonti

Errori API Orders v2 — PayPal
Gestire i fallimenti di finanziamento — PayPal
Riferimento API Orders v2 — PayPal