# Codici di rifiuto di Stripe

Scopri di più sui codici di rifiuto di Stripe e su come risolverli quando un addebito non riesce.

Stripe utilizza i propri codici di rifiuto, che coprono molti degli stessi motivi potenziali dei [codici di rifiuto delle società emittenti](https://docs.stripe.com/declines/network-codes.md). I codici di rifiuto di Stripe forniscono maggiori dettagli sul motivo specifico del rifiuto rispetto a quelli delle società emittenti. Oltre a un codice di rifiuto, un errore può contenere un [advice_code](https://docs.stripe.com/declines/card.md#retrying-issuer-declines) con i passaggi successivi suggeriti.

> #### Altri errori API
> 
> Alcuni [errori API](https://docs.stripe.com/api/errors.md) includono un attributo di [codice](https://docs.stripe.com/api/errors.md#errors-code) che ti aiuta a [risolverli](https://docs.stripe.com/error-handling.md).

## Codici di rifiuto della carta

Questi sono i codici di pagamento Stripe rifiutati, utilizzati per i pagamenti con carta:

| Codice di rifiuto | Descrizione | Passaggi successivi |
| --- | --- | --- |
| `authentication_required` | La carta è stata rifiutata perché la transazione richiede un’autenticazione come *3D Secure* (3D Secure (3DS) provides an additional layer of authentication for credit card transactions that protects businesses from liability for fraudulent card payments). | Quando utilizzi i front-end di Stripe, nella maggior parte dei casi un rifiuto temporaneo da parte della società emittente avvia un flusso di autenticazione, consentendo al cliente di riprovare e autenticare la propria carta. In alcuni casi, ad esempio per i *pagamenti off-session* (A payment is described as off-session if it occurs without the direct involvement of the customer, using previously-collected payment information), potrebbe essere necessario chiedere al cliente di riprovare. Se la società emittente della carta restituisce questo [codice di rifiuto](https://support.stripe.com/questions/authenticated-payment-declined-with-an-authentication-required-decline-code) nonostante la transazione sia stata autenticata correttamente, il cliente deve contattare la società emittente della propria carta per ulteriori informazioni. |
| `authentication_not_handled` | Relativo a `authentication_required`. Il cliente ha tentato di procedere senza eseguire l’autenticazione richiesta, pertanto la società emittente ha rifiutato nuovamente il pagamento. | Esegui il flusso EMV 3D Secure (3DS) o di autenticazione SCA. Per i pagamenti fuori sessione, raccogli e prepara prima l’autenticazione all’interno della sessione, quindi ricorri alla sessione se necessario. |
| `approve_with_id` | Il pagamento non può essere autorizzato. | Effettua un nuovo tentativo di pagamento. Se l’operazione continua a non andare a buon fine, il cliente dovrà contattare la società emittente della sua carta. |
| `call_issuer` | La carta è stata rifiutata per un motivo sconosciuto. | Il cliente deve contattare la società emittente per richiedere maggiori informazioni. |
| `card_not_supported` | La carta non supporta questo tipo di acquisto. | Il cliente deve contattare la società emittente per accertarsi che la carta possa essere utilizzata per acquisti di questo tipo. |
| `card_velocity_exceeded` | Il cliente ha superato il saldo, il limite di credito o il limite dell’importo della transazione disponibile sulla carta. | Il cliente deve contattare la società emittente per richiedere maggiori informazioni. |
| `currency_not_supported` | La carta non supporta l’assistenza per la valuta specificata. | Il cliente deve verificare con la società emittente se la carta può essere utilizzata con il tipo di valuta specificato. |
| `do_not_honor` | La carta è stata rifiutata per un motivo sconosciuto. | Il cliente deve contattare la società emittente per richiedere maggiori informazioni. |
| (Ritirato)`do_not_try_again` | La carta è stata rifiutata per un motivo sconosciuto. | Il cliente deve contattare la società emittente per richiedere maggiori informazioni. |
| `duplicate_transaction` | Una transazione con lo stesso importo e gli stessi dati della carta è stata inviata poco tempo fa. | Controlla se esiste già un pagamento recente. |
| `expired_card` | La carta è scaduta. | Il cliente deve utilizzare un’altra carta. |
| `fraudulent` | Il pagamento è stato rifiutato perché Stripe sospetta che sia fraudolento. | Non fornire informazioni più dettagliate al cliente. Al contrario, comunica gli stessi dati che forniresti per il codice `generic_decline`. |
| `generic_decline` | La carta è stata rifiutata per motivi sconosciuti oppure Stripe Radar o Adaptive Acceptance [hanno bloccato il pagamento](https://docs.stripe.com/declines.md#blocked-payments). | Il cliente deve contattare la società emittente per richiedere maggiori informazioni. |
| `incorrect_address` | L’indirizzo inserito dal cliente non è corretto. | Il cliente deve riprovare utilizzando l’indirizzo corretto. |
| `incorrect_cvc` | Il codice CVC non è corretto. | Il cliente deve riprovare utilizzando il CVC corretto. |
| `incorrect_number` | Il numero della carta non è corretto. | Il cliente deve riprovare utilizzando il numero di carta corretto. |
| `incorrect_pin` | Il PIN inserito è errato. Questo codice di rifiuto si riferisce esclusivamente ai pagamenti effettuati per mezzo di un lettore di carte. | Il cliente deve riprovare utilizzando il PIN corretto. |
| `incorrect_zip` | Il codice postale è errato. | Il cliente deve riprovare utilizzando il codice postale corretto. |
| `insufficient_funds` | La carta non dispone di fondi sufficienti per completare l’acquisto. | Il cliente deve utilizzare una modalità di pagamento alternativa. |
| `invalid_account` | La carta (o il conto a cui la carta è collegata) non è valida. | Il cliente deve contattare la società emittente per verificare che la carta funzioni correttamente. |
| `invalid_amount` | L’importo del pagamento non è valido o supera l’importo consentito. | Se l’importo sembra essere corretto, il cliente deve verificare con la società emittente della carta se può effettuare acquisti per quell’importo. |
| `invalid_cvc` | Il codice CVC non è corretto. | Il cliente deve riprovare utilizzando il CVC corretto. |
| `invalid_expiry_month` | Il mese di scadenza non è valido. | Il cliente deve riprovare utilizzando la data di scadenza corretta. |
| `invalid_expiry_year` | L’anno di scadenza non è valido. | Il cliente deve riprovare utilizzando la data di scadenza corretta. |
| `invalid_number` | Il numero della carta non è corretto. | Il cliente deve riprovare utilizzando il numero di carta corretto. |
| `invalid_pin` | Il PIN inserito non è corretto. | Il cliente deve riprovare utilizzando il PIN corretto. |
| `issuer_not_available` | Non è stato possibile contattare la società emittente della carta, per cui il pagamento non è stato autorizzato. | Effettua un nuovo tentativo di pagamento. Se l’operazione continua a non andare a buon fine, il cliente dovrà contattare la società emittente della sua carta. |
| `lost_card` | Il pagamento è stato rifiutato perché la carta risulta smarrita. | Il motivo specifico per cui non è andato a buon fine non deve essere comunicato al cliente. Presentalo invece come `generic_decline`. |
| `merchant_blacklist` | Il pagamento è stato rifiutato perché corrisponde a un valore inserito nell’elenco di blocco degli utenti di Stripe. | Non fornire informazioni più dettagliate al cliente. Al contrario, comunica gli stessi dati che forniresti per il codice `generic_decline`. |
| `new_account_information_available` | La carta (o il conto a cui la carta è collegata) non è valida. | Il cliente deve contattare la società emittente per richiedere maggiori informazioni. |
| `no_action_taken` | La carta è stata rifiutata per un motivo sconosciuto. | Il cliente deve contattare la società emittente per richiedere maggiori informazioni. |
| `not_permitted` | Il pagamento non è consentito. | Il cliente deve contattare la società emittente per richiedere maggiori informazioni. |
| `offline_pin_required` | La carta è stata rifiutata perché richiede il PIN. | Il cliente deve riprovare inserendo la propria carta e digitando il PIN. |
| `online_or_offline_pin_required` | La carta è stata rifiutata perché richiede il PIN. | Se il lettore di carte supporta il PIN Online, chiedi al cliente di inserire un PIN senza che venga creata una nuova transazione. Se il lettore di carte non supporta il PIN Online, il cliente dovrà fare un nuovo tentativo inserendo la propria carta e digitando il PIN. |
| `pickup_card` | Il cliente non può utilizzare questa carta per effettuare il pagamento (è possibile che risulti smarrita o rubata). | Il cliente deve contattare la società emittente per richiedere maggiori informazioni. |
| `pin_try_exceeded` | È stato raggiunto il numero massimo consentito di tentativi per il PIN. | Il cliente deve utilizzare un’altra carta o un altro metodo di pagamento. |
| `processing_error` | Si è verificato un errore durante l’elaborazione della carta. | Chiedi al cliente di riprovare a effettuare il pagamento. Se non è ancora possibile elaborarlo, il cliente deve contattare la società emittente della propria carta. |
| `reenter_transaction` | La società emittente non ha potuto elaborare il pagamento per un motivo sconosciuto. | Occorre effettuare un nuovo tentativo di pagamento. Se l’operazione continua a non andare a buon fine, il cliente deve contattare la società emittente della sua carta. |
| `restricted_card` | Il cliente non può utilizzare questa carta per effettuare il pagamento (è possibile che risulti smarrita o rubata). | Il cliente deve contattare la società emittente per richiedere maggiori informazioni. |
| `revocation_of_all_authorizations` | La carta è stata rifiutata per un motivo sconosciuto. | Il cliente deve contattare la società emittente per richiedere maggiori informazioni. |
| `revocation_of_authorization` | La carta è stata rifiutata per un motivo sconosciuto. | Il cliente deve contattare la società emittente per richiedere maggiori informazioni. |
| `security_violation` | La carta è stata rifiutata per un motivo sconosciuto. | Il cliente deve contattare la società emittente per richiedere maggiori informazioni. |
| `service_not_allowed` | La carta è stata rifiutata per un motivo sconosciuto. | Il cliente deve contattare la società emittente per richiedere maggiori informazioni. |
| `stolen_card` | Il pagamento è stato rifiutato perché la carta risulta rubata. | Non fornire informazioni più dettagliate al cliente. Al contrario, comunica gli stessi dati che forniresti per il codice `generic_decline`. |
| `stop_payment_order` | La carta è stata rifiutata per un motivo sconosciuto. | Il cliente deve contattare la società emittente per richiedere maggiori informazioni. |
| `testmode_decline` | È stato utilizzato un numero di carta di test Stripe. | Per effettuare il pagamento occorre utilizzare una carta autentica. |
| `transaction_not_allowed` | La carta è stata rifiutata per un motivo sconosciuto. | Il cliente deve contattare la società emittente per richiedere maggiori informazioni. |
| (Ritirato)`try_again_later` | La carta è stata rifiutata per un motivo sconosciuto. | Chiedi al cliente di effettuare un nuovo tentativo di pagamento. Se i pagamenti successivi vengono rifiutati, il cliente dovrà chiedere ulteriori informazioni alla società emittente della sua carta. |
| `withdrawal_count_limit_exceeded` | Il cliente ha superato il saldo o il limite di credito disponibile sulla carta. | Il cliente deve utilizzare una modalità di pagamento alternativa. |
| `mobile_device_authentication_required` | La carta è stata rifiutata perché la transazione richiede l’autenticazione. | Chiedi al cliente di riprovare a effettuare il pagamento toccando nuovamente il dispositivo mobile. |

## Codici di rifiuto dei metodi di pagamento locali

I seguenti codici di rifiuto Stripe possono essere utilizzati per i pagamenti con metodo di pagamento locale (LPM):

| Codice di rifiuto | Motivo dell’esito dell’addebito | Messaggio del venditore | Messaggio di errore API |
| --- | --- | --- | --- |
| `partner_generic_decline` | `partner_generic_decline` | Il fornitore di servizi di pagamento ha rifiutato il pagamento. | Il fornitore di servizi di pagamento ha rifiutato il pagamento. |
| `customer_declined` | `generic_decline` | Il cliente ha rifiutato il pagamento. | Il cliente ha rifiutato questo pagamento. |
| `code_invalid` | `generic_decline` | Il codice BLIK non è valido o ha un formato errato. | Il codice specificato non era un codice BLIK valido. |
| `code_expired` | `generic_decline` | Il codice BLIK è scaduto, è già stato utilizzato o ha superato il suo periodo di validità. | Il codice specificato è scaduto. I codici BLIK scadono dopo 2 minuti. Richiedi un altro codice al cliente. |
| `invalid_customer_account` | `invalid_customer_account` | Non è possibile addebitare l’importo sul conto del cliente. | Non riusciamo ad addebitare l’importo sul conto del cliente. I tentativi ripetuti potrebbero andare a buon fine se il cliente prende le dovute misure per risolvere il problema del suo conto. |
| `payment_limit_exceeded` | `payment_limit_exceeded` | L’ordine supera uno dei limiti previsti dall’account del cliente. | L’ordine supera il limite impostato sul conto del cliente. Le ripetizioni dei tentativi potrebbero andare a buon fine se il cliente prende le dovute misure per risolvere il problema del suo conto. |
| `invalid_billing_agreement` | `invalid_billing_agreement` | Il contratto di addebito al cliente non è valido. | La modalità di pagamento del cliente non è valida a causa di un contratto di addebito non valido. Le ripetizioni dei tentativi non andranno a buon fine. |
| `expired_card` | `partner_expired_card` | La carta registrata presso il fornitore dei servizi di pagamento è scaduta. | La carta registrata con il fornitore di servizi di pagamento è scaduta. I tentativi ripetuti potrebbero andare a buon fine se il cliente prende le dovute misure per risolvere il problema del suo account. |
| `processing_error` | `partner_processing_error` | Il fornitore di servizi di pagamento ha riscontrato un errore di elaborazione. | Il fornitore di servizi di pagamento ha riscontrato un errore di elaborazione. |
| `insufficient_funds` | `partner_insufficient_funds` | Il cliente non dispone di fondi sufficienti presso il fornitore dei servizi di pagamento. | Il cliente non ha fondi sufficienti presso il fornitore di servizi di pagamento. I tentativi ripetuti potrebbero andare a buon fine se il cliente prende le dovute misure per risolvere il problema del suo account. |
| `currency_not_supported` | `partner_invalid_currency` | Il fornitore di servizi di pagamento non accetta questa valuta. | Il fornitore di servizi di pagamento non supporta questa valuta. Le ripetizioni dei tentativi non andranno a buon fine. |
| `invalid_amount` | `partner_invalid_amount` | Il fornitore dei servizi di pagamento non consente l’importo. | Il fornitore di servizi di pagamento non consente l’importo. Le ripetizioni dei tentativi non andranno a buon fine. |
| `invalid_business_account` | `invalid_business_account` | L’account business è disattivato. | L’account business che stai cercando di usare per elaborare un pagamento o emettere un rimborso è disattivato ed è impossibile inviare o ricevere fondi. Se viene riattivato, le ripetizioni dei tentativi potrebbero andare a buon fine. |
| `partner_high_risk_customer` | `partner_high_risk_customer` | Il fornitore di servizi di pagamento ha contrassegnato questo cliente come ad alto rischio. | Il fornitore di servizi di pagamento ha contrassegnato questo cliente come ad alto rischio. |
| `compliance_violation` | `compliance_violation` | Il pagamento viola i termini di servizio, le regole del programma o le leggi vigenti. | Il pagamento viola i termini di servizio, le regole del programma o le leggi vigenti. Le ripetizioni dei tentativi non andranno a buon fine. |
| `payment_disputed` | `payment_disputed` | Il pagamento presenta una contestazione. | Questo pagamento è oggetto di una contestazione. Se viene risolta a favore dell’attività, le ripetizioni dei tentativi potrebbero andare a buon fine. |
| `invalid_authorization` | `invalid_authorization` | L’autorizzazione non è valida o è stata revocata. | Il pagamento non ha ricevuto l’autorizzazione o l’autorizzazione è stata revocata. Le ripetizioni dei tentativi non andranno a buon fine. |
| `invalid_payment_information` | `invalid_payment_information` | I dati del pagamento non sono validi. | I dati del pagamento non sono validi. Le ripetizioni dei tentativi non andranno a buon fine. |
| `partner_payment_not_found` | `partner_payment_not_found` | Il fornitore dei servizi di pagamento non riesce a trovare il pagamento. | Il fornitore dei servizi di pagamento non riesce a trovare il pagamento. |
| `expired_payment_information` | `expired_payment_information` | Lo strumento di pagamento sottostante è scaduto. | I dati del pagamento sono scaduti. I nuovi tentativi potrebbero andare a buon fine dopo che il cliente avrà aggiornato i dati di pagamento. |
| `duplicate_transaction` | `partner_duplicate_transaction` | Una transazione con dettagli identici è stata inviata poco tempo fa. | Una transazione con dettagli identici è stata inviata poco tempo fa al partner. |
| `recurring_not_supported_by_bank` | `recurring_not_supported_by_bank` | La banca del cliente non supporta i pagamenti ricorrenti per questo metodo di pagamento. | La banca del cliente non supporta i pagamenti ricorrenti per questo metodo di pagamento. Invita il cliente a selezionare una banca che supporti i pagamenti ricorrenti. |
| `partner_action_not_supported` | `partner_action_not_supported` | Il fornitore di servizi di pagamento non accetta questa azione. | Il fornitore di servizi di pagamento non accetta questa azione. I nuovi tentativi non andranno a buon fine. |
| `lost_or_stolen_card` | `lost_or_stolen_card` | Il pagamento è stato rifiutato perché la carta risulta smarrita o rubata. | Il motivo specifico per cui non è andato a buon fine non deve essere comunicato al cliente. Presentalo invece come `partner_generic_decline`. |
| `card_already_activated` | `card_already_activated` | La carta è già stata attivata. | La carta è già stata attivata. I nuovi tentativi non andranno a buon fine. |
| `invalid_track_data` | `invalid_track_data` | I dati della carta non sono corretti. | I dati della carta non sono corretti. Il cliente deve contattare la società emittente della carta per verificare che funzioni correttamente. |