# Gestisci i bonifici Come visualizzare stato e report dei bonifici Dopo aver creato un bonifico, puoi visualizzarne lo stato, ricevere eventi quando lo stato cambia, annullare il bonifico e visualizzare i report. ## Visualizza lo stato del bonifico Puoi visualizzare lo stato di un bonifico nella Dashboard oppure tramite API. #### Dashboard 1. Nella Dashboard Stripe, vai a [Global Payouts](https://dashboard.stripe.com/global-payouts/payouts). 1. Utilizza i pulsanti di filtro per ordinare i bonifici in base allo stato `processing`, `posted`, `failed`, `returned`, `canceled`, o `scheduled`. Puoi anche visualizzare una ricevuta dettagliata del bonifico. #### API Chiama l’API OutboundPayments v2 per esaminare i bonifici, incluso il loro stato. Specifica utilizzando l’OutboundPaymentID nella chiamata all’API OutboundPayments v2. ```curl curl https://api.stripe.com/v2/money_management/outbound_payments/obp_1234 \ -H "Authorization: Bearer <>" \ -H "Stripe-Version: 2026-03-25.preview" ``` Per recuperare una ricevuta dettagliata del bonifico, utilizza l’URL fornito nel parametro `receipt_url`. ### Stati dei bonifici La tabella seguente descrive i possibili stati dei bonifici. | Stato | Descrizione | | ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | pianificato | Il bonifico è previsto per una data specifica. Lo stato di questo pagamento passa a `processing` alla data di invio prevista. I bonifici programmati sono disponibili solo nella Dashboard. | | in corso di elaborazione | Stato iniziale del bonifico. I fondi vengono assegnati a una transazione in sospeso e rimangono nel saldo `outbound_pending` corrente. Se il valore dei parametri annullabili è impostato su `true`, puoi annullare il bonifico. | | non riuscita | Bonifico non riuscito. Stripe annulla la transazione in sospeso e restituisce i fondi. | | annullata | Il bonifico è stato annullato prima della pubblicazione. Stripe annulla la transazione in sospeso e restituisce i fondi. | | Posted | I bonifici e i fondi lasciano il FinancialAccount. Lo stato “posted” non garantisce che il destinatario abbia ricevuto denaro, perché la banca potrebbe ritardare il rilascio dei fondi. Se un bonifico viene registrato ma il destinatario non ha ricevuto il denaro, invitalo ad attendere qualche giorno lavorativo o a informarsi presso la sua banca. | | returned | Il bonifico non è arrivato a destinazione. Stripe restituisce i fondi in una transazione separata (`returned_details[transaction]`). Per visualizzare il motivo della restituzione, nella pagina [Global Payouts](https://dashboard.stripe.com/global-payouts/payouts) fai clic sul bonifico nella vista elenco e visualizza il motivo del reso nella sezione **Cronologia**. Puoi visualizzare i motivi della restituzione anche in [OutboundPayment](https://docs.stripe.com/api/v2/money-management/outbound-payments/create.md?api-version=preview#v2_create_outbound_payments-response-status_details-returned). In genere i bonifici vengono restituiti entro 2-3 giorni lavorativi, ma potrebbe essere necessario più tempo a seconda del Paese del destinatario. | ## Visualizzare le modifiche dello stato del bonifico Puoi visualizzare le modifiche dello stato dei bonifici nella Dashboard, o ricevendo gli eventi sull’endpoint del webhook. #### Dashboard 1. Nella Dashboard, vai a [Global Payouts](https://dashboard.stripe.com/global-payouts/payouts). 1. Trova il bonifico che vuoi esaminare e selezionalo. 1. Vai alla sezione **Cronologia** per visualizzare un registro delle modifiche dello stato. #### API Stripe invia i seguenti eventi dei bonifici all’endpoint del webhook: - `outbound_payment.created` quando viene creato un OutboundPayment. - `outbound_payment.{{new_status}}` quando un OutboundPayment cambia stato. Le opzioni disponibili per il valore dello stato includono: - `outbound_payment.posted` - `outbound_payment.failed` - `outbound_payment.canceled` - `outbound_payment.returned` ## Gestire i bonifici restituiti La maggior parte delle restituzioni di bonifici è causata da informazioni errate riguardanti il destinatario(ad esempio, il conto bancario specificato è stato chiuso o i dati dell’intestatario del conto non corrispondono a quelli del destinatario). Se un bonifico è stato restituito: 1. Leggi il motivo della restituzione. Puoi visualizzarlo nella Dashboard selezionando il bonifico nella vista elenco e leggendo la sezione **Cronologia**. Puoi visualizzare i motivi del reso anche in OutboundPayments. 1. Se il bonifico è stato restituito a causa di informazioni errate, conferma i dati e chiedi al destinatario di aggiornarli, se necessario. Poi invia un nuovo bonifico al destinatario aggiornato. 1. Se il bonifico non è andato a buon fine, conferma i dati e chiedi al destinatario di aggiornarli, se necessario. Poi prova a inviare di nuovo il denaro. Se il bonifico continua a non andare a buon fine, [contatta l’assistenza Stripe](https://support.stripe.com/). ## Annullare o stornare un bonifico Se invii un bonifico inavvertitamente, potresti riuscire ad annullarlo se non è stato avviato. Puoi farlo utilizzando la Dashboard o l’API. Se il bonifico viene registrato, puoi comunque richiedere un annullamento inviando un’email all’assistenza Stripe se il tuo metodo di bonifico lo supporta. Stripe tenterà di stornare il bonifico e restituire i fondi sul tuo conto. Stripe non può garantire lo storno e alcuni metodi di pagamento non sono stornabili. | Tipo di bonifico | Supporto degli storni | | --------------------------------------------------------------- | ------------------------------------------------------------------------- | | Bonifici nazionali negli Stati Uniti (bonifico bancario locale) | Devi richiedere l’annullamento entro 24 ore dalla creazione del bonifico. | | Bonifici nazionali negli Stati Uniti (elettronici) | Devi richiedere l’annullamento entro 24 ore dalla creazione del bonifico. | | Bonifici nazionali nel Regno Unito (bonifico bancario locale) | No | | Bonifici transfrontalieri | No | ## Visualizzare l’ID di tracciamento del bonifico Se lo stato di un bonifico è `posted`, ma il destinatario non lo ha ricevuto, puoi fornirgli l’ID di tracciamento, che potrà essere inoltrato alla banca per una verifica. #### Dashboard 1. Nella Dashboard Stripe, vai alla pagina [Global Payouts](https://dashboard.stripe.com/global-payouts/payouts). 1. Seleziona il bonifico da esaminare. 1. Vai alla sezione **ID tracciamento**. Se ne esiste uno, puoi fare clic sull’ID per copiarlo. #### API Per esaminare un bonifico, incluso l’ID di tracciamento, specifica l’ID OutboundPayment nell’[API Outbound Payments V2](https://docs.stripe.com/api/v2/money-management/outbound-payments/retrieve.md?api-version=2025-05-28.preview). ```curl curl https://api.stripe.com/v2/money_management/outbound_payments/obp_1234 \ -H "Authorization: Bearer <>" \ -H "Stripe-Version: 2026-03-25.preview" ``` ## Visualizzazione di report e transazioni Puoi utilizzare la Dashboard e l’API per visualizzare il saldo e i report del conto, visualizzare le transazioni da e verso il saldo e prelevare fondi. #### Dashboard Accedi a **Bonifici** e fai clic su **Esporta** per esportare un file CSV con le informazioni storiche sui bonifici. Puoi selezionare il fuso orario, l’intervallo di date e le colonne desiderate. Puoi anche scaricare i report da **Saldi**. Sono necessarie 96 ore affinché le commissioni siano visibili nei report e 24 ore per l’attività generale. Puoi anche visualizzare un riepilogo dell’attività dei bonifici in **Report**. Fai clic su **Riepilogo saldo conto finanziario** e scarica `Balance summary` (Riepilogo saldo) o `Balance change from activity` (Variazione del saldo in base all’attività). Puoi selezionare il fuso orario, l’intervallo di date e le colonne desiderate. #### API Per elencare tutte le transazioni del tuo conto, utilizza l’[API Transactions](https://docs.stripe.com/api/v2/money-management/transactions.md?api-version=preview). Includi parametri aggiuntivi per filtrare i risultati restituiti. Oltre al [Set standard di parametri dell’elenco](https://docs.stripe.com/api/pagination.md), puoi filtrare le transazioni in base a: - Tipo del movimento di denaro. Ogni movimento di denaro, come OutboundPayments o ReceivedCredits, contiene una o più transazioni che descrivono l’impatto del flusso sul tuo saldo. - Data di creazione o data di pubblicazione La seguente richiesta recupera le tre transazioni più recenti create per un conto finanziario: ```curl curl -G https://api.stripe.com/v2/money_management/transactions \ -H "Authorization: Bearer <>" \ -H "Stripe-Version: 2026-03-25.preview" \ -d "financial_account={{FINANCIALACCOUNTID_ID}}" \ -d limit=3 ``` Una transazione può contenere più voci di transazioni. Ad esempio, quando il denaro si sposta in stati diversi, viene creata una voce di transazione separata per ogni stato. Se ti serve una visione più dettagliata dei movimenti di denaro, utilizza l’API Transaction Entries v2 per elencare le voci delle transazioni. Includi ulteriori parametri per filtrare i risultati restituiti. Oltre al [Set standard di parametri dell’elenco](https://docs.stripe.com/api/pagination.md), puoi filtrare le voci delle transazioni per: - transazione - creato La seguente richiesta recupera le voci delle transazioni create per una transazione specifica: ```curl curl -G https://api.stripe.com/v2/money_management/transaction_entries \ -H "Authorization: Bearer <>" \ -H "Stripe-Version: 2026-03-25.preview" \ -d transaction={{TRANSACTION_ID}} ``` > I report Sigma o Stripe Data Pipeline con Global Payouts sono in anteprima privata. Se ti interessa accedervi,