# Progetta un'integrazione Connect avanzata utilizzando l'API Accounts v1 Scopri le combinazioni di configurazione alternative per un'integrazione Connect basata sull'API Accounts v1. > #### Integrazioni API Accounts v2 > > Questa guida si applica solo alle piattaforme Connect esistenti che utilizzano l’API Accounts v1. Se sei un nuovo utente Connect, utilizza invece l’API Accounts v2. Consulta la [guida alla piattaforma interattiva](https://docs.stripe.com/connect/interactive-platform-guide.md) per informazioni su come configurare una piattaforma Connect utilizzando l’API Accounts v2. Utilizza questa guida per esplorare le diverse integrazioni di Connect e creare un elenco di passaggi di integrazione personalizzati. Prima di iniziare l’integrazione in un ambiente *sandbox* (A sandbox is an isolated test environment that allows you to test Stripe functionality in your account without affecting your live integration. Use sandboxes to safely experiment with new features and changes), devi [creare un account Stripe o accedere](https://dashboard.stripe.com) e [attivare la tua piattaforma su Connect](https://dashboard.stripe.com/settings/connect/platform-profile). ## Selezionare le proprietà ### Creare e attivare gli account Stripe consente di creare account per conto degli utenti, denominati account connessi. Per utilizzare Connect, devi creare account connessi per ciascun utente che riceve denaro tramite la tua piattaforma. #### Item 1 Invia gli account connessi a un flusso di attivazione in hosting su Stripe. L’attivazione in hosting su Stripe ti consente di reindirizzare l’utente su Stripe per completare la procedura di attivazione in un’interfaccia in co-branding. ![Screenshot del modulo di attivazione Connect](https://b.stripecdn.com/docs-statics-srv/assets/Kavholm-Seamless-Standard.78b64d90c0bf87130c8b6ba1ef53df7f.png) Ideale per un lancio in tempi rapidi con il minimo sforzo di integrazione: - Gli account connessi escono dal tuo sito e vengono reindirizzati a Stripe per completare il flusso. - Co-branding con Stripe e opzioni di personalizzazione limitate. - Stripe gestisce tutta la logica del flusso di attivazione. - Supporta automaticamente più di 46 paesi e 14 lingue. #### Item 2 Incorpora direttamente nella tua applicazione un’interfaccia utente di attivazione molto personalizzabile con il branding di Stripe limitato. Gli utenti degli account connessi interagiscono con il componente incorporato senza mai uscire dalla tua applicazione. Puoi integrare l’attivazione incorporata in poche righe di codice. Note: The following is a preview/demo component that behaves differently than live mode usage with real connected accounts. The actual component has more functionality than what might appear in this demo component. For example, for connected accounts without Stripe dashboard access (custom accounts), no user authentication is required in production. Ideale per mantenere gli utenti sul tuo sito con un’esperienza più integrata e un minimo sforzo di integrazione: - Gli account connessi rimangono sul tuo sito. - Estremamente personalizzabile. Branding di Stripe limitato o assente. - Stripe gestisce tutta la logica del flusso di attivazione. - Supporta automaticamente più di 46 paesi e 14 lingue. #### Item 3 Sviluppa ogni aspetto del flusso di attivazione chiamando le API Stripe corrispondenti. Devi creare una logica personalizzata nell’integrazione per soddisfare tutte le informazioni di verifica richieste. > #### Suggerimento di Stripe > > La creazione e la gestione di un flusso di attivazione API richiede un notevole dispendio di risorse e aggiornamenti regolari. Se desideri implementare un flusso di attivazione personalizzato, Stripe consiglia vivamente di utilizzare l’[attivazione incorporata](https://docs.stripe.com/connect/embedded-onboarding.md). (See full diagram at https://docs.stripe.com/connect/design-an-integration) ```text [Attivare il nuovo account connesso] --> [Mostra l’interfaccia utente per acquisire requirements dal tuo account connesso] [Mostra l’interfaccia utente per acquisire requirements dal tuo account connesso] --> [Creare un account connesso] [Creare un account connesso] --> [Se requirements.currently_due non è vuoto] [Recuperare l’account connesso] --> [Se requirements.currently_due non è vuoto] [Presenta moduli per raccogliere le informazioni e convalidare i campi] --> [Aggiorna l’account connesso con le informazioni raccolte] [Attivare di nuovo l’account connesso esistente] --> [Recuperare l’account connesso] [Aggiorna l’account connesso con le informazioni raccolte] --> [Se requirements.currently_due non è vuoto] [Se requirements.currently_due non è vuoto] --> [Presenta moduli per raccogliere le informazioni e convalidare i campi] ``` Ideale per avere il controllo totale sul flusso di attivazione: - Sviluppa e gestisci tu stesso tutta la logica del flusso di attivazione. Può richiedere molte risorse ed essere dispendioso. - Gestisci il rischio con la piena responsabilità dei saldi negativi sugli account connessi. - Devi tenere aggiornati i flussi man mano che cambiano i requisiti di verifica, nonché creare flussi aggiuntivi per comunicare e raccogliere questi requisiti dagli utenti. Rivedi e aggiorna i requisiti di attivazione almeno ogni sei mesi per garantire che il tuo flusso soddisfi i requisiti più recenti. - Dovrai creare un modulo personalizzato per raccogliere conti bancari o carte di debito in modo che gli account connessi possano essere configurati con un conto per bonifici. ### Configurare i flussi della dashboard Gli account connessi devono accedere a una dashboard per gestire il proprio account. Fornisci agli account connessi l’accesso alla Dashboard Stripe, alla Dashboard Express o a una dashboard creata utilizzando l’API Stripe e i componenti incorporati. #### Item 1 Consenti agli account connessi di accedere alla Dashboard Stripe. La Dashboard di Stripe offre agli account connessi accesso illimitato all’intero set di funzioni di Stripe tramite le proprie credenziali di accesso. Gli account connessi possono accedere direttamente a dashboard.stripe.com in qualsiasi momento. Hanno accesso all’assistenza di Stripe e Stripe può comunicare con loro in merito al loro account. Usa la Dashboard Stripe quando i tuoi account connessi: - Devono gestire le proprie chiavi API, i webhook o le integrazioni per sviluppatori. - Richiedono report finanziari dettagliati o esportazioni di dati. - Hanno team con esigenze di accesso diverse (ad esempio, ruoli separati per amministratori e analisti). - Usano Stripe Apps. Puoi sempre aggiungere i [componenti incorporati](https://docs.stripe.com/connect/get-started-connect-embedded-components.md) al tuo sito web oltre all’accesso alla Dashboard Stripe. #### Item 2 Fornisci l’accesso alla Dashboard Express per gli account connessi in modo tale che possano gestire il proprio account. La Dashboard Express è una dashboard in hosting su Stripe con funzionalità limitate, che puoi personalizzare con il tuo branding e configurando le funzioni supportate. Gli account connessi che usano la Dashboard Express hanno accesso all’assistenza di Stripe e Stripe può comunicare con loro in merito al loro account. Usa la Dashboard Express quando i tuoi account connessi: - Devono principalmente monitorare i propri bonifici e l’attività di pagamento. - Non richiedono strumenti per sviluppatori o reportistica avanzata. - Possono usare un’interfaccia utente semplice e ottimizzata. Puoi [configurare la Dashboard Express](https://docs.stripe.com/connect/customize-express-dashboard.md#customize-features) per personalizzare a quali funzioni, come contestazioni, rimborsi e bonifici manuali, possono accedere i tuoi account connessi. Gli account connessi accedono alla Dashboard Express tramite un [link di accesso](https://docs.stripe.com/api/accounts/login_link/create.md) da te generato, anziché accedere direttamente a dashboard.stripe.com. Puoi sempre aggiungere i [componenti integrati di Connect](https://docs.stripe.com/connect/get-started-connect-embedded-components.md) al tuo sito web e al contempo fornire l’accesso alla Dashboard Express. #### Item 3 Crea una dashboard utilizzando le API Stripe o i componenti incorporati per consentire agli account connessi di gestire il loro account. Gli account connessi non avranno accesso alla Dashboard Stripe o alla Dashboard Express. Spetta a te decidere se consentire l’accesso a questi flussi di lavoro creando la dashboard dell’utente, i rimborsi, i flussi di lavoro delle contestazioni e la funzionalità di reportistica. I tuoi utenti potrebbero non rendersi conto di avere un account Stripe tramite la tua piattaforma. Ti consigliamo di integrare i [componenti incorporati di Connect](https://docs.stripe.com/connect/get-started-connect-embedded-components.md) per aggiungere le funzionalità della dashboard all’applicazione della tua piattaforma con un minino sforzo di integrazione. I componenti incorporati sono estremamente personalizzabili e possono supportare account connessi con: - Flussi di lavoro per pagamenti come la visualizzazione di pagamenti e bonifici, la gestione dei rimborsi e la risposta alle contestazioni - Flussi di lavoro per bonifici come la gestione della frequenza dei bonifici, la creazione di bonifici manuali o l’aggiornamento dei conti per bonifici - Flussi di lavoro per i report per scaricare ed esportare i pagamenti e i bonifici - Flussi di lavoro per la gestione degli account come l’aggiornamento delle informazioni sull’azienda > Per un account senza accesso alla Dashboard in hosting da Stripe, in cui Stripe è responsabile dei saldi negativi, utilizza i componenti integrati Connect per fornire aggiornamenti self-service sull’account. Non è possibile creare [collegamenti account](https://docs.stripe.com/api/account_links.md) di tipo `account_update` per tali account. > #### Il tipo di dashboard è immutabile > > La dashboard che specifichi durante la creazione di un account connesso è permanente, quindi tieni conto dei requisiti a lungo termine della tua attività quando decidi il tipo di dashboard. Per modificare la dashboard di un account connesso, devi creare un nuovo oggetto `Account`. ### Accettare un pagamento Crei un addebito per accettare un pagamento da un cliente per conto del tuo account connesso. Il tipo di addebito creato: - Determina come i fondi di pagamento vengono suddivisi tra tutte le parti coinvolte - Influisce sul modo in cui l’addebito viene visualizzato sull’estratto conto bancario o degli addebiti del cliente (con le informazioni della tua piattaforma o dell’utente) - Determina sul quale conto Stripe addebita i rimborsi e gli storni #### Item 1 Un addebito diretto è un pagamento del cliente effettuato direttamente su un account connesso. I clienti effettuano transazioni direttamente con il tuo account connesso, spesso senza sapere dell’esistenza della tua piattaforma. Questo tipo di addebito è più adatto per le piattaforme SaaS. Ad esempio, Shopify fornisce strumenti per la creazione di vetrine online e Thinkific consente agli insegnanti di vendere corsi online. #### Item 2 Crea pagamenti al destinatario sulla tua piattaforma e trasferisci immediatamente i fondi agli account connessi. I clienti effettuano transazioni con la tua piattaforma per prodotti o servizi forniti dai tuoi account connessi. Questo tipo di addebito è il più adatto per marketplace come Airbnb, un marketplace per case in affitto, o Lyft, un’app di ridesharing. Gli addebiti indiretti vengono creati sulla piattaforma, ma nell’ambito dell’operazione di addebito, i fondi vengono trasferiti immediatamente all’account connesso che hai specificato. Puoi decidere se trasferire una parte o tutti questi fondi. Salvo in caso di idoneità ai [payout transfrontalieri con Connect](https://docs.stripe.com/connect/connect-cross-border-payouts.md), per creare un pagamento al destinatario, la piattaforma e l’account connesso a cui vengono trasferiti i fondi devono trovarsi nella stessa area geografica. Il tentativo di trasferire fondi oltre un confine per il quale i trasferimenti non sono consentiti genera un errore. #### Item 3 Crea addebiti e trasferimenti separati per trasferire i fondi da un pagamento a più account connessi o quando un utente specifico non è noto al momento dell’addebito. L’addebito sul tuo account della piattaforma è dissociato dai trasferimenti ai tuoi account connessi. Questo tipo di addebito è più adatto per i marketplace che devono suddividere i pagamenti tra più parti come DoorDash, una piattaforma di consegna per ristoranti. Sebbene gli addebiti e i trasferimenti separati offrano molta flessibilità, richiedono un’integrazione più complessa per gestire i saldi dei conti tra la piattaforma e gli utenti. Devi monitorare attentamente il saldo del tuo account della piattaforma per assicurarti di disporre di fondi sufficienti per coprire l’importo del trasferimento. Salvo in caso di idoneità ai [payout transfrontalieri con Connect](https://docs.stripe.com/connect/connect-cross-border-payouts.md), per utilizzare pagamenti e trasferimenti separati, la piattaforma e l’account connesso a cui vengono trasferiti i fondi devono trovarsi nella stessa area geografica. Il tentativo di trasferire fondi oltre un confine per il quale i trasferimenti non sono consentiti genera un errore. ### Commissioni Stripe #### Item 1 Stripe riscuote le commissioni Stripe dal tuo account della piattaforma, incluse le commissioni di elaborazione. Puoi controllare l’importo delle commissioni di elaborazione addebitate agli account connessi. Utilizza il parametro delle commissioni della piattaforma per riscuotere le commissioni di elaborazione dai tuoi account connessi. #### Item 1 (See full diagram at https://docs.stripe.com/connect/design-an-integration) ```text [customer] -- Addebito diretto --> [Addebito di 10 USD] [Addebito di 10 USD] --> [Commissione della piattaforma 0,59 USD] [Addebito di 10 USD] -- 9,41 USD netti --> [bank] [Commissione della piattaforma 0,59 USD] -- Stripe (0,23 USD) --> [stripe] [Commissione della piattaforma 0,59 USD] -- 0,36 USD netti --> [bank] [account] [platform] ``` #### Item 2 (See full diagram at https://docs.stripe.com/connect/design-an-integration) ```text [customer] --> [Addebito 10 USD] [Addebito 10 USD] --> [Trasferimento 10 USD] [Trasferimento 10 USD] --> [Pagamento 10 USD] [Pagamento 10 USD] --> [Commissione della piattaforma (1,23 USD)] [Commissione della piattaforma (1,23 USD)] --> [8,77 USD netti] [Commissione della piattaforma (1,23 USD)] --> [Commissione della piattaforma 1,23 USD] [Commissione della piattaforma 1,23 USD] --> [Commissioni Stripe (0,59 USD)] [Commissioni Stripe (0,59 USD)] --> [stripe] [Commissioni Stripe (0,59 USD)] --> [0,64 USD netti] [platform] [account] ``` #### Item 3 (See full diagram at https://docs.stripe.com/connect/design-an-integration) ```text [customer] --> [Addebito 100 USD] [Addebito 100 USD] --> [Trasferimento (70 USD)] [Trasferimento (70 USD)] --> [Pagamento 70 USD] [Trasferimento (70 USD)] --> [Trasferimento (20 USD)] [Trasferimento (20 USD)] --> [Pagamento 20 USD] [Trasferimento (20 USD)] --> [Commissioni Stripe (3,20 USD)] [Commissioni Stripe (3,20 USD)] --> [stripe] [Commissioni Stripe (3,20 USD)] --> [6,80 USD netti] [platform] [account] [account] ``` #### Item 2 Stripe riscuote le commissioni Stripe direttamente dai tuoi account connessi. Puoi riscuotere una commissione della piattaforma facoltativa quando crei l’addebito diretto. (See full diagram at https://docs.stripe.com/connect/design-an-integration) ```text [customer] -- Addebito diretto --> [Addebito 10 USD] [Addebito 10 USD] --> [Commissione della piattaforma (1,23 USD)] [Commissione della piattaforma (1,23 USD)] --> [Commissione della piattaforma 1,23 USD] [Commissione della piattaforma 1,23 USD] --> [platform] [Commissione della piattaforma (1,23 USD)] --> [Commissioni Stripe (0,59 USD)] [Commissione della piattaforma (1,23 USD)] --> [8,18 USD netti] [Commissioni Stripe (0,59 USD)] --> [stripe] [account] ``` ### Pagare gli utenti Quando i fondi del pagamento vengono saldati e l’account connesso del tuo utente ha un saldo Stripe positivo, puoi versare tali fondi sul suo conto esterno. #### Item 1 Se attivi gli utenti in un tuo flusso utilizzando l’API Stripe, devi anche raccogliere i conti bancari o le carte di debito per configurare un conto per i bonifici per gli account connessi. Dopo aver raccolto le informazioni dell’utente per il conto per i bonifici, collegalo come conto esterno. Se il tuo account connesso non dispone di un conto esterno verificato, i bonifici vengono bloccati. #### Item 2 #### Item 3 Per impostazione predefinita, i fondi che sono stati versati sui saldi dei tuoi account connessi vengono bonificati ogni giorno da Stripe. Se preferisci, puoi configurare frequenze dei bonifici automatiche diverse, attivare i bonifici manualmente anziché automaticamente o effettuare bonifici istantanei. ### Responsabilità dei saldi negativi #### Item 1 La tua piattaforma è responsabile delle perdite subite causate dai saldi negativi sui tuoi account connessi. La tua piattaforma è responsabile della revisione dei nuovi account connessi durante l’attivazione e della determinazione del profilo di rischio dei tuoi utenti. Consigliato per i marketplace che riscuotono i pagamenti dai clienti per poi effettuare i pagamenti ai venditori, oppure per le piattaforme più avanzate che desiderano avere il pieno controllo sulla gestione del rischio e dei saldi negativi degli account connessi. - La tua piattaforma deve monitorare gli account connessi per prevenire il rischio di perdita. - La tua piattaforma deve creare flussi per comunicare e risolvere i problemi degli account connessi quando rilevi frodi o rischi. - Disponi sia del team operativo che delle risorse tecniche per definire processi per gestire il rischio di perdita e prevenire le frodi. Prima di creare account con questa configurazione, valuta attentamente e accetta le responsabilità della piattaforma in caso di saldi negativi. #### Item 2 Stripe monitora i segnali di rischio sugli account connessi, interviene in caso di rischio sugli account connessi in risposta ai segnali osservati e cerca di recuperare i saldi negativi degli account connessi. Per la maggior parte delle piattaforme SaaS, questa è la migliore scelta predefinita, soprattutto per coloro che sono nuovi all’integrazione dei pagamenti: - Stripe monitora i tuoi account connessi per prevenire il rischio di credito e di frode, nonché garantire la protezione contro il rischio di perdita in caso di saldi negativi attribuiti al rischio d’impresa. - Stripe gestisce tutte le comunicazioni e le misure correttive end-to-end direttamente con i tuoi account connessi tramite flussi in hosting o componenti incorporati. #### Item 1 > #### Versione dell'API in anteprima richiesta con la Dashboard Express > > La combinazione dell’accesso alla Dashboard Express con la responsabilità di Stripe per i saldi negativi è disponibile in [anteprima pubblica](https://docs.stripe.com/release-phases.md). Utilizza la stringa della versione API di anteprima corrente(`2026-10-28.preview`) nella configurazione dell’SDK Stripe quando crei gli account connessi. > > Il codice generato e il prompt in questa pagina utilizzano la versione API attualmente disponibile in generale. Sostituisci tale versione con la stringa della versione di anteprima se utilizzi questa combinazione. #### Item 2 #### Item 3 #### Item 1 #### Componenti incorporati richiesti Quando Stripe è responsabile dei saldi negativi sui tuoi account connessi, devi integrare componenti incorporati per l’attivazione, la gestione degli account e il banner di notifica. Stripe utilizza il componente banner di notifica incorporato per notificare agli account connessi i requisiti in sospeso o altre richieste relative al rischio gestito. Il componente di gestione degli account è necessario in modo che gli account connessi possano gestire le credenziali di autenticazione e le informazioni aziendali. Stripe invia anche email per tuo conto agli account connessi per gestire i rischi e garantire la conformità continua. Puoi personalizzare e brandizzare queste comunicazioni via email con il tuo dominio email e il branding della piattaforma. Per qualsiasi altro componente opzionale, puoi anche utilizzare i [componenti incorporati](https://docs.stripe.com/connect/get-started-connect-embedded-components.md) o creare la tua interfaccia utente. #### Item 2 #### Item 3 ## Procedura di integrazione per le tue selezioni I seguenti passaggi di integrazione si basano sulle opzioni selezionate in precedenza. Puoi vedere i diversi passaggi selezionando le diverse opzioni in alto o nel riquadro a destra dei passaggi. Le opzioni in questa pagina controllano solo i passaggi visualizzati di seguito. Non influiscono sulla configurazione della piattaforma. Il pulsante seguente genera un prompt LLM domiciliato sulle selezioni effettuate. Supporta solo la Dashboard in hosting su Stripe e l’attivazione in hosting.