Codici di rifiuto
Codici di rifiuto Stripe: cosa significa ciascuno e come risolverlo
Verificato il
I codici di rifiuto Stripe ti dicono perché un pagamento con carta è fallito su Stripe. Alcuni provengono dalla banca della carta, come `insufficient_funds` o `expired_card`; alcuni provengono da Stripe stesso, come `fraudulent` o `merchant_blacklist`. Stripe li restituisce come `decline_code` su un errore `card_declined`. Ogni pagina qui sotto spiega un codice, dice se un nuovo tentativo può funzionare secondo le regole del circuito della carta e mostra cosa fanno il checkout e i rinnovi degli abbonamenti di PlatformDTC con esso.
| Codice | Significato |
|---|---|
| authentication_required | La banca vuole che il titolare della carta verifichi il pagamento, di solito con 3D Secure. |
| authentication_not_handled | La verifica era richiesta, l'acquirente l'ha saltata e la banca ha rifiutato di nuovo. |
| approve_with_id | La banca non ha potuto autorizzare il pagamento come inviato; un altro tentativo potrebbe funzionare. |
| call_issuer | La banca ha rifiutato senza motivo e vuole che il titolare della carta la contatti. |
| card_not_supported | La carta non può essere utilizzata per questo tipo di acquisto. |
| card_velocity_exceeded | Il saldo, il limite di credito o il limite di importo della carta è stato raggiunto. |
| currency_not_supported | La carta non può essere addebitata nella valuta del pagamento. |
| do_not_honor | La banca ha rifiutato la carta senza dire il perché. |
| do_not_try_again | Codice deprecato: rifiutato per una ragione sconosciuta; non addebitare di nuovo questa carta. |
| duplicate_transaction | Un pagamento identico sulla stessa carta è stato inviato pochi istanti fa. |
| expired_card | La carta ha superato la sua data di scadenza. |
| fraudulent | I controlli antifrode di Stripe hanno sospettato che il pagamento fosse fraudolento e lo hanno bloccato. |
| generic_decline | Rifiutato per un motivo sconosciuto, o bloccato da Stripe Radar o Adaptive Acceptance. |
| incorrect_address | L'indirizzo di fatturazione inserito non corrisponde ai registri della banca. |
| incorrect_cvc | Il codice di sicurezza della carta (CVC) è sbagliato. |
| incorrect_number | Il numero della carta inserito è sbagliato. |
| incorrect_pin | Il PIN inserito su un lettore di carte è sbagliato. |
| incorrect_zip | Il codice postale di fatturazione non corrisponde ai registri della banca. |
| insufficient_funds | La carta non ha abbastanza denaro o credito per questo pagamento. |
| invalid_account | La carta o il conto ad essa collegato non è più valido. |
| invalid_amount | L'importo del pagamento non è valido o supera quanto consentito dalla carta. |
| invalid_cvc | Il codice di sicurezza della carta (CVC) non è corretto. |
| invalid_expiry_month | Il mese di scadenza della carta non è valido. |
| invalid_expiry_year | L'anno di scadenza della carta non è valido. |
| invalid_number | Il numero della carta non è corretto. |
| invalid_pin | Il PIN inserito non è corretto. |
| issuer_not_available | La banca della carta non è stata raggiungibile, quindi il pagamento non è mai stato autorizzato. |
| lost_card | La carta è stata segnalata come smarrita. Non può essere usata; l'acquirente ha bisogno di un'altra carta. |
| merchant_blacklist | Il pagamento corrispondeva a una voce nell'elenco di blocco Stripe del negozio. |
| new_account_information_available | La carta o il suo conto non sono validi; la banca potrebbe avere dettagli più recenti per esso. |
| no_action_taken | La carta è stata rifiutata per un motivo che la banca non ha condiviso. |
| not_permitted | La banca dice che questo pagamento non è consentito su questa carta. |
| offline_pin_required | Solo di persona: la carta deve essere inserita e un PIN digitato. |
| online_or_offline_pin_required | Solo di persona: la carta richiede un PIN, tramite Online PIN o chip e PIN. |
| pickup_card | La carta non può essere utilizzata per questo pagamento; potrebbe essere stata segnalata come smarrita o rubata. |
| pin_try_exceeded | Troppi tentativi PIN errati; il cliente deve usare un'altra carta o metodo. |
| processing_error | Si è verificato un errore durante l'elaborazione della carta. Di solito temporaneo. |
| reenter_transaction | La banca non è riuscita a elaborare il pagamento per un motivo sconosciuto; riprova. |
| restricted_card | La carta non può essere utilizzata per questo pagamento; potrebbe essere stata segnalata come smarrita o rubata. |
| revocation_of_all_authorizations | La banca ha rifiutato; tipicamente il titolare della carta ha bloccato tutti i pagamenti futuri. |
| revocation_of_authorization | La banca ha rifiutato; tipicamente il titolare della carta ha revocato i pagamenti a questo negozio. |
| security_violation | La banca ha rifiutato per una ragione che non ha condiviso; spesso una regola di sicurezza. |
| service_not_allowed | La carta è stata rifiutata per un motivo non fornito dalla banca. |
| stolen_card | La carta è stata segnalata come rubata. Non può essere usata di nuovo. |
| stop_payment_order | La banca ha rifiutato; il nome del codice indica un ordine di blocco del pagamento sulla carta. |
| testmode_decline | È stato utilizzato un numero di carta di prova Stripe in un pagamento reale. |
| transaction_not_allowed | La banca ha rifiutato; la carta non consente questo tipo di transazione. |
| try_again_later | Codice deprecato: la banca ha rifiutato per una ragione sconosciuta; riprova più tardi. |
| withdrawal_count_limit_exceeded | Il cliente ha superato il saldo o il limite di credito disponibile sulla carta. |
| mobile_device_authentication_required | Il pagamento richiede autenticazione; il cliente dovrebbe toccare di nuovo il telefono. |
| card_declined | Il codice di errore di Stripe per qualsiasi carta rifiutata; il decline_code ne indica il motivo. |
| payment_intent_authentication_failure | La carta non ha superato il controllo di autenticazione della banca (come il 3-D Secure). |
Quali codici di rifiuto Stripe possono essere riprovati
Stripe classifica molti rifiuti come generici, quindi la ragione esatta è spesso poco chiara. Come regola generale, i codici relativi a fondi, limiti e temporanei possono risolversi in seguito; i dettagli errati della carta richiedono che l'acquirente li reinserisca; le carte smarrite, rubate, chiuse, limitate ed scadute richiedono una carta diversa.
Stripe restituisce anche un codice di consiglio con alcuni rifiuti: `do_not_try_again` significa non usare di nuovo la carta per quel pagamento, `try_again_later` significa che un nuovo tentativo è consentito, e `confirm_card_data` significa che alcuni dettagli della carta sono errati. Stripe raccomanda al massimo otto tentativi per un addebito che consente nuovi tentativi.
Secondo il programma fisso predefinito (nuovi tentativi a 1, 3, 5 e 7 giorni di distanza), i rifiuti negli ultimi due gruppi si fermano anche al primo fallimento: la carta non viene riprovata, l'abbonamento viene mantenuto in scadenza e il cliente riceve l'email per aggiornare la carta o confermare il pagamento. Solo gli altri gruppi vengono riprovati secondo quel programma.
| Gruppo | Codici di esempio | Cosa succede |
|---|---|---|
| Fondi insufficienti | `insufficient_funds` | Riprova il giorno di paga probabile del cliente, o 2, 5, 8, 13 e 18 giorni dopo il primo rifiuto: fino a 6 tentativi (7 su PayPal, 2 su una carta prepagata) |
| Temporaneo | `processing_error`, `issuer_not_available`, `try_again_later`, `card_velocity_exceeded`, `card_decline_rate_limit_exceeded` | Riprova 2, 5 e 8 giorni dopo il primo rifiuto: fino a 4 tentativi |
| Nessuna ragione fornita | `do_not_honor`, `generic_decline`, `call_issuer`, `approve_with_id`, `no_action_taken`, `duplicate_transaction` | Un nuovo tentativo 48-72 ore dopo, quindi al cliente viene chiesta una nuova carta |
| Conferma bancaria necessaria | `authentication_required`, `authentication_not_handled`, `mobile_device_authentication_required` | Nessun tentativo cieco; al cliente viene chiesto di confermare il pagamento con la propria banca |
| La carta non può essere usata | `lost_card`, `stolen_card`, `expired_card`, `incorrect_number`, `incorrect_zip`, `restricted_card`, `pin_try_exceeded`, `do_not_try_again` | Mai riprovato; il cliente riceve un link con un clic per aggiornare la carta |
Cosa fa PlatformDTC al checkout
L'acquirente vede il messaggio di rifiuto di Stripe, più un suggerimento semplice per i codici comuni, come "La tua carta ha fondi insufficienti. Prova un'altra carta." e un'opzione per provare subito un'altra carta. Per `lost_card`, `stolen_card`, `pickup_card`, `fraudulent` e `merchant_blacklist` il suggerimento è sempre generico "La tua carta è stata rifiutata. Prova un'altra carta o contatta la tua banca.", quindi all'acquirente non viene mai detto che una carta è stata segnalata come smarrita o rubata o contrassegnata.
Se il negozio ha scelto i pagamenti con carta PayPal come backup, un rifiuto bancario senza una ragione duratura, come `do_not_honor` o `processing_error`, può essere riprovato tramite PayPal, dove l'acquirente reinserisce la carta. I rifiuti per fondi, 3-D Secure, dettagli errati, carta non valida e frode non vengono mai spostati al backup.
Domande frequenti
- Dove trovo il codice di rifiuto per un pagamento Stripe?
- Nella Dashboard di Stripe, apri il pagamento fallito: la ragione del rifiuto è mostrata con una breve soluzione suggerita. Nell'API è il `decline_code` su `last_payment_error` del `PaymentIntent`, e l'esito dell'addebito porta anche la ragione, un codice di consiglio e, quando il circuito ne ha inviato uno, il codice di rifiuto grezzo del circuito.
- Qual è il codice di rifiuto Stripe più comune?
- Stripe afferma che le banche delle carte classificano la maggior parte dei rifiuti come generici (`generic_decline`), il che lascia la ragione esatta poco chiara. Se le informazioni della carta sono corrette, Stripe consiglia di chiedere al cliente di contattare la propria banca emittente per sapere perché il pagamento è stato rifiutato.
- Quante volte posso riprovare un pagamento Stripe rifiutato?
- Stripe raccomanda un massimo di otto tentativi per gli addebiti che consentono nuovi tentativi, e avverte che tentativi extra possono sembrare frode alle banche delle carte. Visa consente fino a 20 tentativi in 30 giorni per i rifiuti riprovabili e nessuno dopo un rifiuto di Categoria 1 come una carta smarrita o rubata.
- Dovrei dire all'acquirente la ragione esatta del rifiuto?
- Per la maggior parte dei codici, sì: una ragione semplice come una carta scaduta o un codice di sicurezza errato li aiuta a risolverlo. Per `fraudulent`, `lost_card`, `stolen_card` e `merchant_blacklist`, Stripe dice di non fornire dettagli e di mostrare il rifiuto allo stesso modo di `generic_decline`.