# Rimborsare e annullare pagamenti Scopri come annullare o rimborsare un pagamento. Puoi [annullare un pagamento](https://docs.stripe.com/refunds.md#cancel-payment) prima che venga completato senza alcun costo. In alternativa, puoi rimborsare tutto o parte di un pagamento dopo che è andato a buon fine, ma ciò potrebbe comportare una commissione. Le commissioni di elaborazione di Stripe relative alla transazione originale non vengono rimborsate. Per ulteriori informazioni, consulta la nostra [pagina dei prezzi](https://stripe.com/pricing/local-payment-methods). I rimborsi utilizzano il saldo Stripe disponibile (esclusi gli importi in sospeso). Se il saldo disponibile non copre l’importo del rimborso, Stripe mantiene il rimborso in sospeso per le transazioni con carta (i rimborsi per altri tipi di metodi di pagamento non andranno a buon fine) fino a quando il saldo Stripe non sarà sufficiente. Puoi compensare un saldo Stripe negativo tramite la riscossione di pagamenti o *ricaricando* (The act of adding funds to a Stripe account, typically through a transfer from a bank external to Stripe) il saldo del tuo conto. Nelle aree geografiche in cui è applicabile, Stripe può effettuare un addebito automatico sul tuo conto bancario per recuperare un saldo Stripe negativo. ## Richieste di rimborso Le richieste di rimborso vengono inviate alla banca o alla *società emittente della carta* (The entity that issued a payment card to a cardholder. This could be a bank, such as with the Visa or Mastercard network, or it could be the card network itself, such as with American Express) del cliente. I rimborsi effettuati con successo appaiono sull’estratto conto dei tuoi clienti in tempo reale, a seconda del circuito della carta e della banca emittente. Per i pagamenti con carta di credito completamente rimborsati, le contestazioni e gli storni non sono possibili. Se saranno soddisfatte tutte le condizioni indicate di seguito, invieremo un’email al tuo cliente per avvisarlo del rimborso: - L’addebito originario era stato creato su un cliente nel tuo account Stripe. - Il cliente ha un indirizzo email registrato. - Hai abilitato **Invia email ai clienti per rimborsi** nella [Dashboard](https://dashboard.stripe.com/account/emails). Puoi [visualizzare i pagamenti rimborsati nella Dashboard](https://dashboard.stripe.com/test/payments?status%5B0%5D=refunded&status%5B1%5D=refund_pending&status%5B2%5D=partially_refunded). ## Emettere rimborsi Puoi emettere rimborsi utilizzando l’[API Refunds](https://docs.stripe.com/api/refunds.md) o la [Dashboard](https://dashboard.stripe.com/test/payments). Puoi emettere più rimborsi per coprire un addebito, ma l’importo totale rimborsato non può essere maggiore di quello dell’addebito originario. #### Dashboard Per rimborsare un pagamento utilizzando la Dashboard: 1. Individua il pagamento che desideri rimborsare nella pagina [Pagamenti](https://dashboard.stripe.com/payments). 1. Fai clic sul menu extra (⋯) a destra del pagamento, quindi seleziona **Rimborsa pagamento**. 1. Per impostazione predefinita viene effettuato un rimborso completo. Se desideri effettuare un rimborso parziale, indica un importo diverso. 1. Seleziona un motivo per il rimborso. Se selezioni **Altro**, devi aggiungere una nota che spieghi il motivo del rimborso. Fai clic su **Rimborsa**. In alternativa, puoi fare clic su un pagamento specifico ed emettere un rimborso dalla relativa pagina dei dettagli. Puoi anche inviare [ricevute di rimborso](https://docs.stripe.com/receipts.md#refund-receipts) automaticamente o inviare manualmente una ricevuta per ogni rimborso. > #### Rimborsi in blocco > > La Dashboard supporta il rimborso in blocco dei pagamenti completi. Scegli i pagamenti che vuoi rimborsare selezionando la casella a sinistra di ogni pagamento, anche su più pagine di risultati. Quindi, fai clic su **Rimborsa** e seleziona un motivo. Con questa procedura puoi emettere solo rimborsi completi; i rimborsi parziali devono essere emessi singolarmente. #### API Per rimborsare un pagamento mediante API, [crea un rimborso](https://docs.stripe.com/api.md#create_refund) e indica l’ID dell’addebito o del [PaymentIntent](https://docs.stripe.com/api/payment_intents.md) da rimborsare. Quando utilizzi un PaymentIntent per riscuotere un pagamento, Stripe crea un oggetto di [addebito](https://docs.stripe.com/api/charges/object.md). Per rimborsare un pagamento dopo che il PaymentIntent ha avuto esito positivo, crea un rimborso utilizzando il PaymentIntent, che equivale a rimborsare l’addebito sottostante. Se utilizzi le API Stripe Tax per registrare le vendite, devi [registrare i rimborsi](https://docs.stripe.com/tax/custom.md#reversals). ```curl curl https://api.stripe.com/v1/refunds \ -u "<>:" \ -d payment_intent=pi_Aabcxyz01aDfoo ``` È anche possibile rimborsare solo una parte di un PaymentIntent specificando un importo. A tal fine, fornire un parametro di `amount` come numero intero in centesimi (o l’unità monetaria più piccola della valuta di addebito). ```curl curl https://api.stripe.com/v1/refunds \ -u "<>:" \ -d payment_intent=pi_Aabcxyz01aDfoo \ -d amount=1000 ``` Se desideri separare l’[autorizzazione e l’acquisizione](https://docs.stripe.com/payments/place-a-hold-on-a-payment-method.md) di un addebito e rimborsare un PaymentIntent con stato`requires_capture`, la procedura di rimborso è diversa. In questo caso, l’addebito associato al PaymentIntent rimane non acquisito e non può essere rimborsato direttamente. Devi [annullare il PaymentIntent](https://docs.stripe.com/api/payment_intents/cancel.md). ### Rimborsi tramite una piattaforma Connect La modalità di rimborso dipende dal [tipo di addebito Connect](https://docs.stripe.com/connect/charges.md#refund-creation) utilizzato nella tua integrazione. - Stripe addebita direttamente sull’account connesso i rimborsi tramite pagamenti con [addebito diretto](https://docs.stripe.com/connect/direct-charges.md#issue-refunds). - Stripe addebita sulla tua piattaforma i rimborsi relativi a pagamenti con [addebiti indiretti](https://docs.stripe.com/connect/destination-charges.md#issue-refunds) o [addebito separato e trasferimento](https://docs.stripe.com/connect/separate-charges-and-transfers.md#issue-refunds) (con o senza `on_behalf_of`). Annulla i trasferimenti associati a questi tipi di addebito per recuperare l’importo del rimborso dai tuoi account connessi. Le piattaforme Connect possono consentire ai propri account collegati di fornire rimborsi ai clienti dal proprio sito utilizzando componenti Connect incorporati, come [pagamenti](https://docs.stripe.com/connect/supported-embedded-components/payments.md) o [dettagli di pagamento](https://docs.stripe.com/connect/supported-embedded-components/payment-details.md). ## Destinazione dei rimborsi I rimborsi possono essere effettuati solo con la stessa modalità di pagamento utilizzata per l’addebito. Non puoi inviare un rimborso a una destinazione diversa, come un’altra carta o un altro conto bancario. I rimborsi su carte scadute o annullate vengono gestiti dall’emittente della carta del cliente e, nella maggior parte dei casi, accreditati sulla carta sostitutiva del cliente. In assenza di una carta sostitutiva, in genere l’emittente della carta trasmette il rimborso al cliente utilizzando una modalità di pagamento alternativa (come un assegno o il deposito su conto bancario). In rari casi un rimborso su carta di credito potrebbe [non andare a buon fine](https://docs.stripe.com/refunds.md#failed-refunds). Per altri metodi di pagamento, come [ACH](https://docs.stripe.com/payments/ach-direct-debit.md) e [iDEAL](https://docs.stripe.com/payments/ideal.md), la gestione dei rimborsi varia da banca a banca. Se un cliente ha chiuso il suo metodo di pagamento, la banca potrebbe restituire il rimborso, contrassegnandolo come [non riuscito](https://docs.stripe.com/refunds.md#failed-refunds). ## Gestire i rimborsi non riusciti Un rimborso può non andare a buon fine se la banca o la società emittente della carta del cliente non riescono a elaborarlo correttamente. Ad esempio, un conto bancario chiuso o un problema con la carta possono causare il mancato rimborso. In tal caso la banca restituisce l’importo rimborsato a noi, che lo reintegriamo nel saldo del tuo account Stripe. Questa procedura può richiedere fino a 30 giorni dalla data della comunicazione. Quando si utilizza l’API, lo stato di un oggetto [Refund](https://docs.stripe.com/api.md#refund_object) passa a `failed` e include questi attributi: - `failure_balance_transaction`: l’ID dell’oggetto [transazione saldo](https://docs.stripe.com/api.md#balance_transaction_object) che rappresenta l’importo reintegrato nel tuo saldo Stripe. - `failure_reason`: il motivo per cui il rimborso non è andato a buon fine. Tra questi motivi ci sono: | Motivo dell’errore | Descrizione | | ------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `charge_for_pending_refund_disputed` | Un cliente ha contestato l’addebito mentre il rimborso è in sospeso. In questo caso, consigliamo di [accettare o contestare](https://docs.stripe.com/disputes/responding.md#decide) la contestazione anziché il rimborso, per evitare doppi rimborsi al cliente. | | `declined` | Rimborso rifiutato dai nostri partner finanziari. | | `expired_or_canceled_card` | La modalità di pagamento è stata annullata da un cliente o è scaduta per il partner. | | `insufficient_funds` | Il rimborso è in sospeso a causa di fondi insufficienti e ha superato la finestra di scadenza del rimborso in sospeso. | | `lost_or_stolen_card` | Il rimborso non è andato a buon fine a causa dello smarrimento o del furto della carta originale. | | `merchant_request` | Rimborso non andato a buon fine su richiesta dell’azienda | | `unknown` | Rimborso non riuscito a causa di un motivo sconosciuto. | Per alcuni metodi di pagamento, il codice di rifiuto fornito dai nostri partner finanziari, che indica il motivo per cui il rimborso non è riuscito, è disponibile nel campo `network_decline_code` dell’hash `destination_details`: ``` { id: "pyr_1234", destination_details: { blik: { network_decline_code: "decline_code" }, type: 'blik', } } ``` Nella rara eventualità che un rimborso non vada a buon fine, ti avvisiamo utilizzando l’*evento* (A tool to send events to your application via webhook or directly to your cloud infrastructure) `refund.failed` (guarda [tutti gli eventi correlati al rimborso](https://docs.stripe.com/refunds.md#refund-events)). A quel punto dovrai trovare un metodo alternativo per garantire il rimborso al cliente. Se la tua piattaforma utilizza [Connect con addebiti indiretti](https://docs.stripe.com/connect/destination-charges.md#issue-refunds), i fondi vengono accreditati dal deposito di un rimborso non riuscito sul saldo Stripe del tuo account della piattaforma. ## Annulla un rimborso A seconda del tipo di rimborso, potresti avere la possibilità di annullarlo prima che il cliente lo riceva. Alcuni rimborsi con carta supportano la cancellazione per un breve periodo di tempo. Il rimborso non deve essere stato elaborato come storno di addebito. Al momento, per i rimborsi con carta sono supportate solo le cancellazioni tramite Dashboard. Per alcuni [metodi di pagamento](https://docs.stripe.com/payments/bank-transfers.md#refunds), Stripe si mette in contatto con il cliente al fine di raccogliere le informazioni bancarie prima che il rimborso sia elaborato. Puoi annullare i rimborsi se le informazioni bancarie non sono state raccolte. Per questo tipo di rimborso sono supportate sia le cancellazioni tramite API che quelle tramite Dashboard. I rimborsi annullati passano allo stato `canceled`. Poiché le cancellazioni sono un tipo di errore relativo ai rimborsi, gli attributi `failure_reason` e `failure_balance_transaction` sono inclusi nel [rimborso](https://docs.stripe.com/api.md#refund_object). Se la tua piattaforma utilizza [Connect con addebiti indiretti](https://docs.stripe.com/connect/destination-charges.md#issue-refunds), i fondi vengono accreditati dal deposito di un rimborso annullato sul saldo Stripe del tuo account della piattaforma. To cancel a refund using the Dashboard: 1. Find the payment associated with the refund in the [Payments](https://dashboard.stripe.com/payments) page. 1. Click the overflow menu (⋯) to the right of the payment, then select **Cancel refund**. 1. If there are multiple partial refunds, select the correct refund in the dropdown. 1. Confirm the refund cancellation by selecting **Yes, cancel refund**. Alternatively, you can click a specific payment and cancel the refund from its details page. ## Rimborso e storno I rimborsi emessi poco dopo l’addebito originario non risultano come rimborsi ma come *storni* (A reversal is the cancellation of a transaction. Stripe doesn't withhold any fees for payment reversals). In caso di storno, l’addebito originario non è riportato nell’estratto conto del cliente e non viene emesso un accredito distinto. Gli utenti *IC+* (A pricing plan where businesses pay the variable network cost for each transaction plus the Stripe fee rather than a flat rate for all transactions. This pricing model provides more visibility into payments costs) potrebbero notare una differenza di costo tra storni e rimborsi perché gli storni di solito comportano commissioni dei circuiti inferiori. #### Dashboard Per verificare se un rimborso viene eseguito come storno sulla Dashboard: 1. Apri la pagina dei dati di pagamento relativi al pagamento associato al rimborso. 1. Nella sezione Cronologia, fai clic su **Visualizza dettagli** per la voce relativa al rimborso. 1. Se si tratta di uno storno, viene visualizzato un messaggio corrispondente. #### API Per verificare se un rimborso viene eseguito come storno utilizzando l’API: 1. Utilizza l’[evento](https://docs.stripe.com/refunds.md#refund-events) `refund.updated` o [recupera il rimborso](https://docs.stripe.com/api/refunds/retrieve.md) con l’API. 1. Se si tratta di uno storno, restituisce `destination_details[card][type] = 'reversal'`. ## Tracciare un rimborso Dopo che hai disposto un rimborso, Stripe trasmette la richiesta alla banca o alla società emittente della carta del tuo cliente. A seconda della banca, occorrono circa 5-10 giorni perché il cliente possa vedere l’accredito relativo al rimborso. Un cliente potrebbe contattarti se non vede il rimborso. Un rimborso potrebbe non essere visibile al cliente per diversi motivi: - I rimborsi effettuati poco dopo l’addebito originario non risultano come rimborsi ma come storni. In caso di storno, l’addebito originario non è riportato nell’estratto conto del cliente e non viene emesso un accredito distinto. - I rimborsi possono non andare a buon fine se la banca o l’emittente della carta del cliente non sono state in grado di elaborarli correttamente. In tal caso la banca ci restituisce l’importo rimborsato e noi lo reintegriamo nel saldo del tuo account Stripe. Questo processo può richiedere fino a 30 giorni dalla data di richiesta del rimborso. Se un cliente chiede notizie di un rimborso, può essere utile fornirgli il numero di riferimento principale corrispondente al rimborso. Per i rimborsi delle carte, è l’**ARN (Acquirer Reference Number)**, lo **STAN (System Trace Audit Number)** o l’**RRN (Retrieval Reference Number)**. L’ARN, lo STAN o l’RRN è un numero di riferimento assegnato a una transazione con carta durante la procedura di pagamento. Per i rimborsi con modalità di pagamento locali, può essere un numero di riferimento generato da Stripe o dai nostri partner finanziari che viene trasmesso alle banche o agli istituti beneficiari. Il cliente può mostrare questo numero di riferimento alla propria banca che può fornire informazioni sulla data in cui il rimborso è disponibile. Un numero di riferimento inoltre rassicura il cliente circa l’effettiva emissione del rimborso. I riferimenti per il rimborso sono disponibili alle seguenti condizioni: - Sono supportati per alcuni partner finanziari e contrassegnati come non disponibili in caso contrario. - Dopo l’avvio di un rimborso, occorrono 7 giorni lavorativi per ricevere l’ARN dai partner bancari. - L’ARN non è disponibile per gli storni perché l’addebito originario non è stato elaborato. Per i circuiti delle carte che non supportano gli ARN, cerchiamo di fornire altri riferimenti come lo STAN (System Trace Audit Number) o l’RRN (Retrieval Reference Number). #### Dashboard Per trovare il riferimento di un rimborso utilizzando la Dashboard: 1. Apri la pagina dei dati di pagamento relativi al pagamento associato al rimborso. 1. Nella sezione Cronologia, fai clic su **Visualizza dettagli** per la voce relativa al rimborso. 1. Se disponibile, Stripe visualizza l’ARN o lo STAN negli appunti. #### API Per trovare il riferimento di un rimborso utilizzando l’API: 1. Utilizza l’[evento](https://docs.stripe.com/refunds.md#refund-events) `refund.updated` o [recupera il rimborso](https://docs.stripe.com/api/refunds/retrieve.md) con l’API. 1. Se disponibile, Stripe mostra il riferimento per il rimborso della carta nel seguente formato di risposta API: ``` { id: "re_1234", destination_details: { card: { reference: "123456", reference_status: "available", reference_type: "acquirer_reference_number", type: "refund" }, type: "card", } } ``` Oppure il riferimento per i metodi di pagamento locali selezionati nel seguente formato di risposta API: ``` { id: "pyr_1234", destination_details: { eu_bank_transfer: { reference: "123456", reference_status: "available" }, type: "eu_bank_transfer", } } ``` ## Annullare un pagamento Puoi annullare un pagamento utilizzando la Dashboard solo quando il suo stato è `uncaptured`. Per annullare un pagamento con altri stati, devi utilizzare l’API. #### Dashboard Per annullare i pagamenti non acquisiti utilizzando la Dashboard: 1. Individua il pagamento che desideri annullare nella pagina [Pagamenti](https://dashboard.stripe.com/payments). 1. Fai clic sul pagamento, quindi seleziona **Annulla**. 1. Seleziona un motivo dell’annullamento, quindi fai clic su **Sì**. Se selezioni **Altro**, devi aggiungere una nota che spieghi il motivo dell’annullamento del pagamento. #### API Se non hai più intenzione di incassare un pagamento, puoi [annullare un PaymentIntent](https://docs.stripe.com/api/payment_intents/cancel.md). Puoi mantenere un PaymentIntent in uno stato incompleto, come `requires_confirmation` o `requires_payment_method`, perché i PaymentIntent incompleti sono utili per capire il tasso di conversione al momento del pagamento. L’esempio di codice riportato di seguito mostra una richiesta di annullamento di un PaymentIntent: ```curl curl -X POST https://api.stripe.com/v1/payment_intents/pi_32AkjQ5H4Bas2eAolX13/cancel \ -u "<>:" ``` Puoi annullare un PaymentIntent solo se presenta uno dei seguenti stati: - `requires_payment_method` - `requires_capture` - `requires_confirmation` - `requires_action` - `processing` (solo quando la modalità di pagamento associata è un conto bancario statunitense) Un PaymentIntent non può essere annullato dopo che è andato a buon fine. Un PaymentIntent annullato non può più essere utilizzato per effettuare ulteriori addebiti. Qualsiasi operazione che la tua applicazione cerchi di eseguire su un PaymentIntent annullato determinerà un errore. ## Eventi per i rimborsi Stripe attiva [eventi](https://docs.stripe.com/api/events.md#events) ogni volta che viene creato o modificato un rimborso. Alcune altre azioni, come la chiusura delle revisioni, attivano anche eventi pertinenti per i rimborsi. Assicurati che la tua integrazione sia configurata per [gestire gli eventi](https://docs.stripe.com/webhooks/handling-payment-events.md) e [verifica le firme dei webhook](https://docs.stripe.com/webhooks.md#verify-events) per confermare che gli eventi in arrivo provengano da Stripe. Devi anche creare una logica interna per notificare ai clienti o al tuo team lo stato del processo di rimborso. Come minimo, Stripe consiglia di ascoltare l’evento `refund.created`. La tabella seguente descrive gli eventi più comuni relativi ai rimborsi. | Evento | Descrizione | | ---------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `refund.created` | Inviato quando un rimborso viene creato. | | `refund.updated` | Inviato quando il rimborso viene aggiornato. Gli aggiornamenti includono l’aggiunta di metadati e la fornitura di dettagli come l’[ARN come numero di riferimento per monitorare i rimborsi](https://docs.stripe.com/refunds.md#tracing-refunds). | | `refund.failed` | Inviato quando un [rimborso non è andato a buon fine](https://docs.stripe.com/refunds.md#failed-refunds). | | `charge.dispute.funds_reinstated` | Inviato quando i fondi vengono reintegrati nel tuo account dopo la chiusura di una contestazione, inclusi i [pagamenti parzialmente rimborsati](https://docs.stripe.com/disputes/best-practices.md#partial-refund-bp). | | `charge.refunded` | Inviato quando viene rimborsato un addebito, inclusi quelli parziali. Ascolta `refund.created` per le informazioni sul rimborso. | | `review.closed` | Inviato quando una [revisione](https://docs.stripe.com/api/events/types.md#review_object) viene chiusa. Consulta il campo `reason` per capire il motivo della chiusura, che può trattarsi di una delle seguenti: `approved`, `disputed`, `canceled`, `refunded`, o `refunded_as_fraud`. | | `source.refund_attributes_required` (Obsoleto) | Inviato quando l’origine del destinatario richiede attributi di rimborso per elaborare un rimborso o un pagamento errato. | | `charge.refund.updated` (Obsoleto) | Inviato quando il rimborso viene aggiornato, solo per i rimborsi con un addebito corrispondente. Ascolta `refund.updated` per aggiornamenti su tutti i rimborsi. | ## Ottimizzazione dei costi Se la tua attività elabora un elevato volume di rimborsi in prossimità del momento della transazione, ti consigliamo di utilizzare [l’autorizzazione e l’acquisizione manuali](https://docs.stripe.com/payments/place-a-hold-on-a-payment-method.md) per ridurre i costi di rimborso. L’autorizzazione e l’acquisizione manuali ti consentono di tenere sotto controllo i costi annullando i pagamenti prima che vengano acquisiti oppure riducendo l’importo acquisito anziché elaborando un rimborso. ## See also - [Aggiungere fondi al tuo saldo Stripe](https://docs.stripe.com/get-started/account/add-funds.md) - [Aggiungere fondi al saldo della piattaforma](https://docs.stripe.com/connect/top-ups.md) - [Localizzare i prezzi](https://docs.stripe.com/payments/currencies/localize-prices.md)