# 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) 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 Stripe offre agli account connessi una suite completa di funzionalità, tra cui la visualizzazione dei bonifici, la gestione di rimborsi e contestazioni, l’accesso ai report e l’elaborazione degli addebiti in modo autonomo. Gli utenti possono accedere alla loro Dashboard Stripe in qualsiasi momento direttamente dal sito di Stripe. Gli utenti hanno accesso all’assistenza di Stripe e Stripe può contattarli per informarli sul loro account. Utilizza la Dashboard Stripe se: - I tuoi utenti hanno bisogno di accedere a potenti flussi di lavoro di pagamento e funzionalità avanzate di gestione degli utenti. - Preferisci che Stripe gestisca il rischio di perdita e si assuma la responsabilità dei saldi negativi sugli account connessi. - Ti senti a tuo agio con il branding di Stripe e il co-branding limitato della piattaforma. 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 consente agli account connessi di visualizzare il saldo disponibile, vedere i bonifici in entrata e monitorare gli utili in tempo reale. Gli utenti non possono gestire rimborsi o contestazioni tramite la Dashboard Express. Gli utenti hanno accesso all’assistenza Stripe e Stripe può contattarli per informarli sul loro account. Utilizza la Dashboard Express se: - I tuoi utenti sono venditori di marketplace che hanno bisogno di un accesso limitato ai flussi di lavoro. - Invii i bonifici principalmente a questi utenti. Gli utenti non gestiranno direttamente rimborsi o contestazioni. - Vuoi personalizzare completamente l’aspetto della dashboard. - Ritieni di essere in grado di assumerti la responsabilità dei saldi negativi e di gestire il rischio di perdita per gli account connessi. Puoi sempre aggiungere i [componenti incorporati di Connect](https://docs.stripe.com/connect/get-started-connect-embedded-components.md) al tuo sito web oltre all’accesso alla Dashboard Stripe. #### 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. ### 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 addebiti indiretti 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. A meno che tu non sia idoneo per i [bonifici transfrontalieri](https://docs.stripe.com/connect/cross-border-payouts.md), per creare un addebito indiretto la tua piattaforma e l’account connesso a cui trasferisci i fondi devono trovarsi nella stessa regione. Qualsiasi tentativo di trasferire i fondi oltre un confine non consentito restituisce 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. A meno che tu non sia idoneo per i [bonifici transfrontalieri](https://docs.stripe.com/connect/cross-border-payouts.md), per utilizzare addebiti e trasferimenti separati la tua piattaforma e l’account connesso a cui trasferisci i fondi devono trovarsi nella stessa regione. Qualsiasi tentativo di trasferire i fondi oltre un confine non consentito restituisce 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) #### Item 2 (See full diagram at https://docs.stripe.com/connect/design-an-integration) #### Item 3 (See full diagram at https://docs.stripe.com/connect/design-an-integration) #### 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) ### 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 dagli acquirenti per versarli ai venditori o per le piattaforme avanzate che vogliono avere il controllo totale su come vengono gestiti i rischi e i saldi negativi per gli 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 #### 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.