Qual è la differenza tra card_declined e un codice di rifiuto?

card_declined è il codice di errore per qualsiasi rifiuto di carta. Il codice di rifiuto, nell'attributo decline_code, spiega il motivo.

Dovrei riprovare un errore card_declined?

Guarda prima il decline_code. Alcuni motivi si risolvono con il tempo, altri significano che la carta non funzionerà mai. Senza un decline_code, un nuovo tentativo distanziato è ragionevole.

Stripe · Codici di rifiuto

Cosa significa l'errore Stripe card_declined?

Verificato il 31 ottobre 2026

Il codice di errore Stripe card_declined significa che la carta è stata rifiutata. È l'errore generico per ogni rifiuto di carta: Stripe aggiunge un attributo decline_code che fornisce il motivo, come insufficient_funds o do_not_honor. Quando non viene restituito alcun decline_code, la banca non ha fornito alcun motivo. L'acquirente dovrebbe provare un'altra carta o contattare la propria banca; il negozio dovrebbe leggere il decline_code prima di decidere un nuovo tentativo.

Tipo: Codice di errore che racchiude ogni rifiuto di carta
Chi ha rifiutato: Di solito la banca della carta; vedi decline_code
Riprova: Dipende dal decline_code
Azione dell'acquirente: Prova un'altra carta o contatta la banca
Azione del commerciante: Cerca il decline_code per vedere il vero motivo
Rinnovo PlatformDTC: Senza decline_code: un nuovo tentativo 48–72 ore dopo (Riprova intelligente)

Cosa fa PlatformDTC

Quando viene restituito solo card_declined, il checkout di PlatformDTC aggiunge "La tua carta è stata rifiutata. Prova un'altra carta o contatta la tua banca." e, se il negozio ha i pagamenti con carta PayPal come backup, offre un secondo tentativo lì. Con Riprova intelligente attiva, un rinnovo con card_declined e senza decline_code viene ritentato una volta, 48–72 ore dopo; un secondo rifiuto chiede al cliente un nuovo metodo di pagamento.

Perché succede

Ogni volta che un pagamento con carta viene rifiutato, Stripe restituisce card_declined. Il motivo specifico viaggia separatamente nel decline_code, che può essere qualsiasi cosa, da un CVC errato a una carta smarrita.

Se non è presente alcun decline_code, la banca ha rifiutato senza fornire un motivo.

Cosa può fare l'acquirente

Controlla i dettagli della carta, quindi riprova o usa un'altra carta. Se la carta continua a fallire, chiama la tua banca: le banche spiegano i rifiuti solo al titolare della carta.

Cosa può fare il negozio

Mostra un messaggio chiaro e metodi di pagamento alternativi. Nei report, raggruppa i fallimenti per decline_code piuttosto che per card_declined, altrimenti ogni fallimento sembrerà uguale.

Per gli sviluppatori

error.code = card_declined; il motivo è in error.decline_code (anche last_payment_error.decline_code sul PaymentIntent). Leggi anche charge.outcome.advice_code e network_decline_code. Memorizzare solo card_declined fa perdere le informazioni necessarie per scegliere tra un nuovo tentativo, una richiesta di aggiornamento della carta e un'interruzione.

Domande frequenti

Qual è la differenza tra card_declined e un codice di rifiuto?: card_declined è il codice di errore per qualsiasi rifiuto di carta. Il codice di rifiuto, nell'attributo decline_code, spiega il motivo.
Dovrei riprovare un errore card_declined?: Guarda prima il decline_code. Alcuni motivi si risolvono con il tempo, altri significano che la carta non funzionerà mai. Senza un decline_code, un nuovo tentativo distanziato è ragionevole.