# Aggiornamenti imminenti dei requisiti Leggi le informazioni sulle modifiche alle informazioni di verifica richieste e sul loro impatto sulla tua integrazione con Stripe Gli aggiornamenti dei requisiti riportati nella presente guida si riferiscono alle proprietà dell’API Accounts v1. Puoi visualizzare le proprietà corrispondenti dell’API Accounts v2 in [Informazioni di verifica richieste](https://docs.stripe.com/connect/required-verification-information.md) selezionando `v2` nel menu a discesa **API Accounts** e l’aggiornamento desiderato nel menu a discesa **Aggiornamento dei requisiti**. Le normative sui pagamenti contribuiscono a prevenire reati quali riciclaggio di denaro, frode ed evasione fiscale. Le autorità di regolamentazione finanziaria di tutto il mondo applicano i [requisiti di adeguata verifica della clientela (Know Your Customer, KYC)](https://support.stripe.com/questions/know-your-customer) per garantire che Stripe raccolga, verifichi e conservi le informazioni relative all’identità di determinati tipi di attività e delle persone che ne sono proprietarie, che le controllano o le dirigono. Tali requisiti vengono aggiornati frequentemente dalle autorità di regolamentazione dei servizi finanziari, dai circuiti di carte di credito e da altri istituti finanziari. Questa guida fornisce una panoramica delle modifiche imminenti ed evidenzia quelle più significative. Per un elenco esaustivo dei requisiti, fai riferimento a [Informazioni richieste per la verifica](https://docs.stripe.com/connect/required-verification-information.md). Se utilizzi un flusso basato su API per integrare i tuoi account connessi, devi aggiornare la tua integrazione per gestire tutte le modifiche dei requisiti. Scopri di più sulle [opzioni di attivazione Connect](https://docs.stripe.com/connect/onboarding.md) e sulla [migrazione dei tuoi flussi di integrazione e risoluzione basati su API a flussi integrati o in hosting su Stripe](https://docs.stripe.com/connect/migrate-from-api-onboarding.md). #### Programma - Europa *Ultimo aggiornamento: 23 febbraio 2026* ## Comprendere le modifiche ai requisiti di verifica Per allinearci alle normative della Financial Conduct Authority (FCA) del Regno Unito e della Banca Centrale d’Irlanda (CBI), Stripe sta aggiornando i requisiti di adeguata verifica della clientela (KYC), dei beneficiari effettivi (UBO) e dei membri del consiglio di amministrazione. Se i tuoi account connessi operano in uno qualsiasi dei Paesi elencati, potresti dover aggiornare il flusso di attivazione. La mancata esecuzione degli aggiornamenti richiesti interromperà l’accesso dei tuoi account connessi a pagamenti e servizi finanziari. Per saperne di più su ciò che sta cambiando e perché, consulta il [nuovo articolo di assistenza sui requisiti di conformità](https://support.stripe.com/questions/europe-verification-requirement-updates-for-connected-accounts). Le modifiche imminenti riguardano gli account connessi nei seguenti Paesi: - AT - BE - BG - CH - CY - CZ - DE - DK - EE - ES - FI - FR - GB - GI - GR - HR - HU - IE - IS - IT - LI - LT - LU - LV - MT - NL - NO - PL - PT - RO - SE - SI - SK > #### Aggiornamenti continui > > Stripe continuerà ad aggiornare l’API per supportare la raccolta di questi requisiti fino al 1° aprile 2026. ## Scegli un approccio per l’integrazione Stripe consiglia di utilizzare l’attivazione in hosting o incorporata su Stripe per raccogliere i requisiti di verifica dell’attività e dell’identità. Queste opzioni richiedono meno risorse da implementare e gestire rispetto all’attivazione con API. La tabella seguente descrive le principali differenze: - [Attivazione in hosting su Stripe](https://docs.stripe.com/connect/hosted-onboarding.md): (Consigliato) invia gli account a un flusso in hosting su Stripe per inoltrare le informazioni richieste. - [Attivazione integrata](https://docs.stripe.com/connect/embedded-onboarding.md): (Consigliato) integra componenti di attivazione forniti da Stripe che consentono agli account di inviare le informazioni direttamente a Stripe dalla tua app. - [Attivazione tramite API](https://docs.stripe.com/connect/api-onboarding.md): crea e gestisci un flusso di attivazione personalizzato utilizzando le API di Stripe. | | **Attivazione in hosting su Stripe** | **Attivazione integrata** | **Attivazione basata su API** | | -------------------------------------------------------------- | --------------------------------------------------------------- | ------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------- | | Ottimali per | Piattaforme che desiderano che Stripe gestisca l’attivazione | Piattaforme che desiderano un flusso di attivazione brandizzato in-app | Piattaforme che hanno necessitano di pieno controllo, possono crearlo e mantenerlo | | Impegno di implementazione iniziale | 3-4 settimane di progettazione | 3-4 settimane di progettazione | 30-40 settimane di progettazione | | Impegno continuo per risolvere gli aggiornamenti dei requisiti | Gestito automaticamente da Stripe | Gestito automaticamente da Stripe | Richiede un monitoraggio proattivo delle modifiche imminenti, oltre a risorse tecniche per aggiornare il flusso di attivazione a ogni modifica | | Personalizzazione | Interfaccia in hosting su Stripe con branding della piattaforma | Componente altamente tematizzabile a cui gli account accedono attraverso l’app della piattaforma | La piattaforma progetta, crea e gestisce l’interfaccia | | Impegno per il supporto di altri Paesi | Gestito automaticamente da Stripe | Gestito automaticamente da Stripe | Richiede risorse tecniche per aggiornare il flusso di attivazione per ogni Paese aggiuntivo | Scopri di più sulle [opzioni di attivazione Connect](https://docs.stripe.com/connect/onboarding.md) e sulla [migrazione dei tuoi flussi di integrazione e risoluzione basati su API a flussi integrati o in hosting su Stripe](https://docs.stripe.com/connect/migrate-from-api-onboarding.md). Le [modifiche apportate al flusso di attivazione](https://docs.stripe.com/connect/handle-verification-updates.md#collect-future-requirements) dipendono dalla configurazione dell’attivazione. Oltre ad aggiornare il flusso di attivazione, aggiorna la documentazione interna ed esterna, se necessario, e prepara i team di assistenza in modo che rispondano alle domande sugli aggiornamenti. Se utilizzi l’attivazione in hosting su Stripe o integrata, non devi aggiornare l’integrazione per preparare agli aggiornamenti dei requisiti. Tuttavia, puoi comunicare ai tuoi account connessi che Stripe potrebbe richiedere informazioni nuove o aggiornate sull’identità quando i requisiti cambiano. ## Panoramica integrazione API Se scegli di non eseguire la migrazione all’attivazione in hosting su Stripe o integrata, devi gestire i seguenti aggiornamenti: - [Adeguata verifica della clientela (KYC)](https://docs.stripe.com/connect/upcoming-requirements-updates.md#know-your-customer-\(kyc\)-verification) - [Verifica del beneficiario effettivo (UBO) e della relazione tra i membri del consiglio di amministrazione](https://docs.stripe.com/connect/upcoming-requirements-updates.md#ubo-director-verification) - [Requisiti di registrazione delle attività olandesi (KvK)](https://docs.stripe.com/connect/upcoming-requirements-updates.md#netherlands-business-registration-requirements) - [Nuovi codici di errore](https://docs.stripe.com/connect/upcoming-requirements-updates.md#new-error-codes) ## Aggiorna la cronologia La cronologia seguente illustra le tappe fondamentali per queste modifiche. Assicurati di aggiornare e testare in anticipo la tua integrazione per evitare problemi quando entreranno in vigore i nuovi requisiti. | Data | Pietra miliare | Descrizione | | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 2025 ottobre | Avvia la pianificazione dell’integrazione | Sono disponibili i primi aggiornamenti dell’API. Consulta questa guida e le relative modifiche per iniziare a pianificare gli aggiornamenti dell’integrazione. | | Marzo 2026 | Rivedi gli account interessati e verifica gli aggiornamenti dell’integrazione | Stripe fornisce un elenco dei tuoi account connessi interessati. Inizia a testare il flusso di attivazione aggiornato. | | Marzo – aprile 2026 | Inizia il lancio di `future_requirements` (attivazione API) | Per le piattaforme che utilizzano l’attivazione API, Stripe inizia ad aggiungere i nuovi requisiti a `future_requirements` sia per gli account nuovi che per quelli esistenti. | | 1° aprile 2026 | Entrano in vigore nuovi requisiti per le piattaforme che dispongono solo di account collegati con tipo di business `individual` | Assicurati che il tuo flusso di attivazione aggiornato sia pronto per raccogliere i nuovi requisiti. Il flusso aggiornato dovrà essere operativo entro il 1° aprile, quando Stripe inizierà a implementare i nuovi requisiti. Tutti i nuovi requisiti entreranno in vigore entro la fine di aprile. | | 1° maggio 2026 | Entrano in vigore nuovi requisiti per le piattaforme che hanno account connessi con tipo di business `company`, comprese le piattaforme che hanno anche account connessi `individual` | Assicurati che il tuo flusso di attivazione aggiornato sia pronto per raccogliere i nuovi requisiti. Il flusso aggiornato dovrà essere operativo per tutti gli account connessi entro il 1° maggio, data in cui Stripe inizierà a implementare i nuovi requisiti. Tutti i nuovi requisiti entreranno in vigore entro la fine di maggio. | | Giugno 2026 - agosto 2026 | Nuovi requisiti attualmente in scadenza per gli account esistenti | Durante questo periodo i nuovi requisiti verranno revocati agli account connessi esistenti. Utilizza il flusso di attivazione aggiornato per raccoglierli secondo necessità. | | Luglio – ottobre 2026 | Date di scadenza per i nuovi requisiti | Per evitare restrizioni, i requisiti aggiornati per ciascun account devono essere verificati entro la data di scadenza dell’account. | ## Verifica adeguata della clientela (KYC) Stripe sta rafforzando il proprio processo di verifica dell’identità, il che potrebbe richiedere ad alcuni dei tuoi account connessi di fornire ulteriori informazioni. Stiamo inoltre aggiungendo ulteriori opzioni all’API per la verifica delle informazioni. Le seguenti entità devono fornire informazioni controllabili per l’adeguata verifica della clientela: - Persona giuridica (per persone fisiche e ditte individuali); - Rappresentante dell’account - UBO (per gli account considerati ad alto rischio dal modello di rischio di Stripe) ### Metodi di verifica aggiuntivi Oltre alle informazioni inserite manualmente, utilizza i seguenti metodi opzionali per massimizzare le percentuali di successo della verifica: - [Stripe Identity](https://docs.stripe.com/connect/upcoming-requirements-updates.md#stripe-identity): (Recommended) Utilizza la funzione di acquisizione di selfie e documenti per gli account che non superano la verifica automatica. - [Verifica del documento di identità](https://docs.stripe.com/connect/upcoming-requirements-updates.md#national-id-verification): raccogli in anticipo un numero di documento di identità nazionale per aumentare i tassi di verifica al primo tentativo. - [Carica ulteriori documenti](https://support.stripe.com/questions/documents-for-identity-and-home-address-verification): invia documenti di identità o di indirizzo a supporto per una revisione manuale. ### Stripe Identity (Consigliato) Puoi cercare di verificare gli account connessi che non superano la verifica automatica utilizzando [Stripe Identity](https://stripe.com/identity). Identity funziona con l’acquisizione di un selfie e di un [documento di identità](https://docs.stripe.com/acceptable-verification-documents.md). La maggior parte dei [Paesi europei](https://docs.stripe.com/identity/use-cases.md) supporta Stripe Identity e le percentuali di successo variano secondo il Paese. Crea una [sessione di verifica](https://docs.stripe.com/api/identity/verification_sessions.md?api-version=preview) dell’identità e utilizza il parametro [related_person](https://docs.stripe.com/api/identity/verification_sessions/object.md?api-version=preview#identity_verification_session_object-related_person) per inviare i `document` e i requisiti di `proof_of_liveness` della persona. Puoi verificare i risultati utilizzando l’API o la Dashboard. ### Verifica dell’identità nazionale Nei [Paesi interessati da questo aggiornamento](https://docs.stripe.com/connect/upcoming-requirements-updates.md#affected-countries) è possibile migliorare la verifica del rappresentante di un account connesso fornendo il numero del documento di identità nazionale oltre al nome, alla data di nascita, all’indirizzo e alla nazionalità. Al momento la verifica supporta solo i seguenti numeri di identificazione nazionale. | Paese | Tipo di documento di identità nazionale | | --------- | -------------------------------------------------- | | Danimarca | Central Person Register (CPR) | | Italia | Codice fiscale | | Polonia | Numero PESEL | | Spagna | Documento Nacional de Identidad (DNI) | | Svezia | Personnummer (Numero di identificazione personale) | I Paesi non interessati da questo aggiornamento, come gli Stati Uniti, non offrono assistenza per la verifica del numero di identificazione nazionale. Ad esempio, puoi fornire il numero di identificazione di un cittadino spagnolo che agisce in qualità di rappresentante di un account connesso in Austria, che si trova nell’UE. Tuttavia, non puoi fornire il numero di identificazione di un cittadino spagnolo che agisce da rappresentante di un account connesso negli Stati Uniti. > #### Disponibilità del documento di identità nazionale > > Potrai iniziare a raccogliere i numeri di identificazione nazionale per i tuoi account connessi quando i requisiti aggiornati entreranno in vigore. Nel frattempo, l’integrazione è disponibile per i tuoi account sandbox come funzione in anteprima. ### Implementa la verifica dell'identità nazionale utilizzando l'API Il seguente esempio mostra l’attivazione di un nuovo account connesso con i requisiti aggiornati. > Le differenze riportate di seguito riguardano solo l’API Accounts v1, non la v2. #### Passaggio 1: crea un account connesso per testare (Public preview) Una volta revocati i requisiti futuri, crea gli account connessi come di consueto. Fino ad allora, devi creare i nuovi account connessi in una [sandbox](https://docs.stripe.com/sandboxes.md) per consentire il nuovo comportamento di adeguata verifica della clientela. Attiva questo comportamento modificando due parti della chiamata di creazione dell’account: 1. Aggiungi l’intestazione `experimental_onboarding_preview=v2`. 1. Invia `capabilities[card_payments][preview]=true`. Dopo aver creato l’account, viene visualizzata una nuova stringa di requisiti `representative.nationality`. Ciò indica che è possibile creare un rappresentante dell’account e fornire la nazionalità. ```shell // Creating a connected account in Spain > curl https://api.stripe.com/v1/accounts \ -u sk_test_123 \ -H "Stripe-Version: 2025-08-27.basil;experimental_onboarding_preview=v2" \ -d 'type'='custom' \ -d 'country'='ES' \ -d 'capabilities[card_payments][requested]'='true' \ -d 'capabilities[card_payments][preview]'='true' \ -d 'capabilities[transfers][requested]'='true' { "id": "acct_1Nv0FGQ9RKHgCVdB", ... "requirements": { "past_due": [ ... "representative.nationality", ... ] } ... } ``` #### Passaggio 2: crea un rappresentante dell’account Dopo aver creato l’account connesso, crea un rappresentante dell’account. ```shell > curl https://api.stripe.com/v1/accounts/acct_1Nv0FGQ9RKHgCVdB/persons \ -u sk_test_123: \ -d first_name=John \ -d last_name=Doe { "id": "person_1N9XNb2eZvKYlo2CjPX7xF6B", ... } ``` #### Passaggio 3: invia la nazionalità Dopo aver creato un rappresentante dell’account, la `nationality` viene visualizzata in `past_due`. Raccogli questo campo in modo che Stripe possa determinare se il rappresentante è idoneo all’acquisizione dell’`id_number`. ```shell > curl https://api.stripe.com/v1/accounts/acct_1Nv0FGQ9RKHgCVdB -u sk_test_123: { ... "requirements": { "past_due": [ "person_1N9XNb2eZvKYlo2CjPX7xF6B.dob.year", ...other person requirements... "person_1N9XNb2eZvKYlo2CjPX7xF6B.nationality" ] } ... } ``` Dopo aver raccolto la nazionalità, se la persona si trova in un paese idoneo, il suo numero di identificazione apparirà come requisito alternativo nell’array `alternatives`. Ogni voce dell’array`alternatives` rappresenta un percorso alternativo per soddisfare un requisito standard. È possibile soddisfare un requisito alternativo al posto di quello originale, ma non è necessario soddisfarli entrambi. In questo esempio, `alternatives` contiene `id_number` come alternativa per il requisito `dob.year` scaduto. Ciò significa che puoi fornire il numero del documento di identità nazionale della persona anziché l’anno di nascita. Se specifichi l’anno di nascita, non devi fornire il numero del documento di identità. ```shell > curl https://api.stripe.com/v1/accounts/acct_1Nv0FGQ9RKHgCVdB/persons/person_1N9XNb2eZvKYlo2CjPX7xF6B \ -u sk_test_123: \ -d nationality=ES > curl https://api.stripe.com/v1/accounts/acct_1Nv0FGQ9RKHgCVdB -u sk_test_123: { "requirements": { "past_due": [ "person_1N9XNb2eZvKYlo2CjPX7xF6B.dob.year", ...other person fields... ], "alternatives": [ { "original_fields_due": [ "person_1N9XNb2eZvKYlo2CjPX7xF6B.dob.year", ...other person fields... ], "alternative_fields_due": [ "person_1N9XNb2eZvKYlo2CjPX7xF6B.id_number" ] } ] } } ``` #### Passaggio 4: raccogliere i campi dei restanti rappresentanti dell’account Raccogli ulteriori attributi della persona, tra cui un numero di identificazione nazionale, per avviare la verifica KYC. ```shell > curl https://api.stripe.com/v1/accounts/acct_1Nv0FGQ9RKHgCVdB/persons/person_1N9XNb2eZvKYlo2CjPX7xF6B \ -u sk_test_123: \ -d 'id_number'='74362315-A' \ ...other person fields... ``` #### Passaggio 5: i campi digitati passano alla verifica in sospeso Dopo aver inserito i dati, i campi in `pending_verification` vengono visualizzati in un nuovo modo: - I campi inseriti vanno in `pending_verification` anziché in `verification.document` e `verification.additional_document`. Questo indica che i campi inseriti sono in fase di verifica. - Il requisito `id_number` può essere inserito in `pending_verification` se specificato, anche se compare solo in `alternative_fields_due` e mai in `past_due` o `currently_due`. ```shell > curl https://api.stripe.com/v1/accounts/acct_1Nv0FGQ9RKHgCVdB/ -u sk_test_123: { "requirements": { "pending_verification": [ "person_1N9XNb2eZvKYlo2CjPX7xF6B.address.city", "person_1N9XNb2eZvKYlo2CjPX7xF6B.address.line1", "person_1N9XNb2eZvKYlo2CjPX7xF6B.address.postal_code", "person_1N9XNb2eZvKYlo2CjPX7xF6B.dob.day", "person_1N9XNb2eZvKYlo2CjPX7xF6B.dob.month", "person_1N9XNb2eZvKYlo2CjPX7xF6B.dob.year", "person_1N9XNb2eZvKYlo2CjPX7xF6B.first_name", "person_1N9XNb2eZvKYlo2CjPX7xF6B.id_number", "person_1N9XNb2eZvKYlo2CjPX7xF6B.last_name" ] } } ``` #### Passaggio 6: gestire gli errori di verifica In molti casi, dopo che i campi sono stati inseriti in `pending_verification`, il rappresentante supera la verifica KYC e viene completato il processo. Se la verifica non va a buon fine, Stripe restituisce ulteriori informazioni per aiutarti a determinare i passaggi successivi. Ci sono due cambiamenti importanti. **Più alternative** Nell’hash dei requisiti vedrai più alternative. Ognuna di queste rappresenta un percorso utilizzabile dai tuoi utenti. Ad esempio, se il nome e la data di nascita corrispondono ma il nome e l’indirizzo non corrispondono, il tuo account connesso ha diversi modi per risolvere il problema: 1. Possono controllare le informazioni inserite per nome e indirizzo e reimmettere quei campi per correggere eventuali errori. 1. Possono controllare le informazioni inserite per data di nascita, nome, indirizzo e id_number, e digitare nuovamente le informazioni corrette. 1. Possono caricare un documento corrispondente al loro nome e indirizzo 1. Possono completare Stripe Identity Questi quattro percorsi vengono visualizzati come campi `past_due` e `alternatives`: ```shell > curl https://api.stripe.com/v1/accounts/acct_1Nv0FGQ9RKHgCVdB -u sk_test_123: { "requirements": { // 1. They can check the information they've entered for dob, name, and address, and re-enter the correct information. "past_due": [ "person_1N9XNb2eZvKYlo2CjPX7xF6B.first_name", "person_1N9XNb2eZvKYlo2CjPX7xF6B.last_name", "person_1N9XNb2eZvKYlo2CjPX7xF6B.address.*" ], "alternatives": [ // 2. They can check the information they entered for dob, name, address and id_number and re-key correct information. { "original_fields_due": [ "person_1N9XNb2eZvKYlo2CjPX7xF6B.first_name", "person_1N9XNb2eZvKYlo2CjPX7xF6B.last_name", "person_1N9XNb2eZvKYlo2CjPX7xF6B.address.*" ], "alternative_fields_due": [ "person_1N9XNb2eZvKYlo2CjPX7xF6B.id_number" ] }, // 3. They can upload document that matches their name and address { "original_fields_due": [ "person_1N9XNb2eZvKYlo2CjPX7xF6B.first_name", "person_1N9XNb2eZvKYlo2CjPX7xF6B.last_name", "person_1N9XNb2eZvKYlo2CjPX7xF6B.address.*" ], "alternative_fields_due": [ "person_1N9XNb2eZvKYlo2CjPX7xF6B.verification.additional_document" ] }, // 4. They can complete Stripe Identity { "original_fields_due": [ "person_1N9XNb2eZvKYlo2CjPX7xF6B.first_name", "person_1N9XNb2eZvKYlo2CjPX7xF6B.last_name", "person_1N9XNb2eZvKYlo2CjPX7xF6B.address.*" ], "alternative_fields_due": [ "person_1N9XNb2eZvKYlo2CjPX7xF6B.proof_of_liveness" ] } ] } } ``` **Errori nei campi digitati** In precedenza, se si verificava un errore di verifica durante l’elaborazione dei campi digitati, i campi del documento passavano a `past_due` e comparivano degli errori. In seguito, i campi digitati tornavano a `past_due`. I campi come `id_number` rimangono in `alternative_fields_due`. Ad esempio, se il nome, la data di nascita e l’indirizzo sono originariamente `past_due` e, dopo l’invio, il nome e la data di nascita corrispondono mentre il nome e l’indirizzo non corrispondono, il nome e l’indirizzo tornano a `past_due` mentre la data di nascita viene rimossa. In questa situazione appaiono errori nei campi `past_due` e `alternative_fields_due`. ```shell > curl https://api.stripe.com/v1/accounts/acct_1Nv0FGQ9RKHgCVdB -u sk_test_123: { "requirements": { "past_due": [ "person_1N9XNb2eZvKYlo2CjPX7xF6B.name", "person_1N9XNb2eZvKYlo2CjPX7xF6B.address" ], "alternatives": [ { "original_fields_due": [ "person_1N9XNb2eZvKYlo2CjPX7xF6B.name", "person_1N9XNb2eZvKYlo2CjPX7xF6B.address" ], "alternative_fields_due": [ "person_1N9XNb2eZvKYlo2CjPX7xF6B.id_number" ] }, { "original_fields_due": [ "person_1N9XNb2eZvKYlo2CjPX7xF6B.name", "person_1N9XNb2eZvKYlo2CjPX7xF6B.address" ], "alternative_fields_due": [ "person_1N9XNb2eZvKYlo2CjPX7xF6B.proof_of_liveness" ] }, { "original_fields_due": [ "person_1N9XNb2eZvKYlo2CjPX7xF6B.name", "person_1N9XNb2eZvKYlo2CjPX7xF6B.address" ], "alternative_fields_due": [ "person_1N9XNb2eZvKYlo2CjPX7xF6B.verification.additional_document" ] } ], "errors": [ { "code": "verification_failed_keyed_identity", "reason": "Identity information could not be verified.", "requirement": "person_1N9XNb2eZvKYlo2CjPX7xF6B.name" }, { "code": "verification_failed_keyed_identity", "reason": "Identity information could not be verified.", "requirement": "person_1N9XNb2eZvKYlo2CjPX7xF6B.address" }, { "code": "verification_failed_keyed_identity", "reason": "Identity information could not be verified.", "requirement": "person_1N9XNb2eZvKYlo2CjPX7xF6B.id_number" } ] } } ``` ### Account ad alto rischio Il modello di rischio di Stripe richiede l’adeguata verifica della clientela dei titolari effettivi solo per i conti classificati come ad alto rischio. Ai fini del test, aggiungi `_high_risk` alla ragione sociale per forzare l’assegnazione di un rating di alto rischio. Ciò ti consente di testare l’intero flusso di adeguata verifica della clientela per i beneficiari, compresi i requisiti e gli errori che la tua integrazione deve gestire. Questo esempio mostra come creare un account di test ad alto rischio e aggiungere i beneficiari: ```curl // Creating a connected account in Spain curl https://api.stripe.com/v1/accounts \ -u sk_test_123: \ -H "Stripe-Version: 2025-08-27.basil;experimental_onboarding_preview=v2" \ -d 'type'='custom' \ -d 'country'='ES' \ -d 'capabilities[card_payments][requested]'='true' \ -d 'capabilities[card_payments][preview]'='true' \ -d 'capabilities[transfers][requested]'='true' { "id": "acct_123", ... "requirements": {...} ... } // Set the business name to enforce the account to be high risk curl https://api.stripe.com/v1/accounts/acct_123 \ -u sk_test_123: \ -d "business_profile[name]"="example_high_risk" ``` ```curl curl https://api.stripe.com/v1/accounts/acct_123/persons \ -u sk_test_123: \ -d first_name=Marie \ -d last_name=Dupont \ -d "dob[day]"=1 \ -d "dob[month]"=1 \ -d "dob[year]"=1901 \ -d "relationship[owner]=true" \ -d "address[line1]"="address_no_match" \ -d "address[city]"="Madrid" \ -d "address[postal_code]"="28001" { "id": "person_123", ... } ``` ```curl curl https://api.stripe.com/v1/accounts/acct_123 \ -u sk_test_123: \ -d "company[owners_provided]"="true" ``` Dopo che Stripe ha eseguito un’adeguata verifica della clientela sul titolare, i requisiti dell’account riflettono il risultato. Quando il nome del beneficiario corrisponde ma l’indirizzo non corrisponde (attivato utilizzando l’indirizzo di test `address_no_match`), i requisiti includono errori `verification_failed_keyed_identity` nei campi del titolare: ```json { "requirements": { "past_due": [ "people.person_123.address.city", "people.person_123.address.line1", "people.person_123.address.postal_code", "people.person_123.first_name", "people.person_123.last_name" ], "errors": [ { "code": "verification_failed_keyed_identity", "requirement": "people.person_123.address.city" }, { "code": "verification_failed_keyed_identity", "requirement": "people.person_123.address.line1" }, { "code": "verification_failed_keyed_identity", "requirement": "people.person_123.address.postal_code" }, { "code": "verification_failed_keyed_identity", "requirement": "people.person_123.first_name" }, { "code": "verification_failed_keyed_identity", "requirement": "people.person_123.last_name" } ], "alternatives": [ { "original_fields_due": [ "people.person_123.address.city", "people.person_123.address.line1", "people.person_123.address.postal_code", "people.person_123.first_name", "people.person_123.last_name" ], "alternative_fields_due": [ "people.person_123.verification.additional_document" ] }, { "original_fields_due": [ "people.person_123.address.city", "people.person_123.address.line1", "people.person_123.address.postal_code", "people.person_123.first_name", "people.person_123.last_name" ], "alternative_fields_due": [ "people.person_123.verification.proof_of_liveness" ] } ] } } ``` Per soddisfare questi requisiti, devi inviare nuovamente le informazioni sull’identità del beneficiario o soddisfare uno dei requisiti alternativi (carica `additional_document` o `proof_of_liveness` completa). ## Verifica delle relazioni di UBO e membri del consiglio di amministrazione Stripe sta migliorando il processo di verifica dei beneficiari effettivi finali (UBO) e dei membri del consiglio di amministrazione. Le normative europee richiedono la verifica del rapporto tra UBO, membri del consiglio di amministrazione e persona giuridica. - **UBO:** persona fisica che possiede o controlla (direttamente o indirettamente) più del 25% di una persona giuridica (ad esempio, aziende, società di capitali, LLC e società di persone). - **Membro del consiglio di amministrazione:** un membro del consiglio di amministrazione dell’attività o qualsiasi altra figura dirigenziale responsabile della gestione dell’attività. (Gli esempi includono CEO, COO, presidente, amministratore delegato, direttore esecutivo e così via). La tabella seguente mostra le relazioni che devono essere verificate per ogni tipo di persona giuridica: | Tipo di persona giuridica | Relazioni da verificare | Nota | | -------------------------------------- | ----------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Company, corporation, LLC, partnership | UBO, se esistenti; oppure membri del consiglio di amministrazione | Solo per il Regno Unito: UBO e membri del consiglio di amministrazione | | Non profit | Direttori | La maggior parte delle organizzazioni no profit non ha UBO | | Persona fisica o ditta individuale | N/A | N/A | | Organismo governativo o agenzia | N/A | Per l’esenzione dalla fornitura dei dati relativi agli UBO, gli organismi governativi devono seguire la procedura descritta in [questo articolo dell’Assistenza](https://support.stripe.com/questions/business-verification-requirements-for-government-entities). | | Società quotata in borsa | N/A | Per l’esenzione dalla fornitura dei dati relativi agli UBO, le società quotate in borsa devono seguire la procedura descritta in [questo articolo dell’Assistenza](https://support.stripe.com/questions/business-verification-requirements-for-publicly-traded-companies). | ### Verifica le informazioni sull’UBO e sul membro del consiglio di amministrazione Gli UBO e i membri del consiglio di amministrazione devono fornire le seguenti informazioni: - Nome completo - Data di nascita - Indirizzo - Email - Qualifica (solo per i membri del consiglio di amministrazione) Stripe tenta di verificare la relazione della persona confrontando le seguenti proprietà chiave della persona e della persona giuridica: | Entità | Proprietà chiave | | ----------------- | ---------------------------------------------------------------------------- | | Persona | - Nome - Cognome - (Se fornito) Numero ID | | Persona giuridica | - Nome - Indirizzo - ID fiscale - Partita IVA - Numero di iscrizione | Una verifica andata a buon fine potrebbe richiedere solo la corrispondenza di un sottoinsieme delle proprietà. Stripe tenta di verificare le relazioni nei seguenti modi: | Metodo | Descrizione | Esempio di requisiti | | --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Fornitore terzo | Se è disponibile un fornitore terzo, Stripe tenta automaticamente di verificare tutte le relazioni sull’account. | - `owners.first_name` - `owners.last_name` - `company.tax_id` | | Documento ufficiale | È possibile fornire un documento di “Prova dell’UBO” per i titolari e un documento di “Prova di registrazione” per i membri del consiglio di amministrazione. I [documenti accettabili](https://docs.stripe.com/acceptable-verification-documents.md) variano a seconda del Paese. | - `owners.first_name` - `owners.last_name` - `company.name` - `company.address.line1` - `company.address.city` - `company.address.state` - `documents.proof_of_ultimate_beneficial_ownership` | | Attestazione digitale | Puoi utilizzare i seguenti modelli PDF per fornire attestazioni digitali per le tue relazioni: - [Modello di attestazione digitale UBO](https://docs.stripecdn.com/6e82842bfc01bd0b1c46d77f7d46b69673a9ca965ed2ad9ef53139f98abdbbaf.pdf) - [Modello di attestazione digitale per un membro del consiglio di amministrazione](https://docs.stripecdn.com/715ffef45157ff700bc368a4011659ee23bc8ba3c68746c5c15948a6eee1591f.pdf) | - `owners.id_number` - `company.tax_id` - `documents.proof_of_ultimate_beneficial_ownership` - `documents.proof_of_ultimate_beneficial_ownership.signer` | ### Identifica i requisiti di verifica delle relazioni utilizzando l'API Quando si recuperano i requisiti di un `Account`, le opzioni di verifica originali e alternative rappresentano combinazioni delle informazioni chiave e dei metodi di verifica disponibili. Nella maggior parte dei casi, esistono almeno tre opzioni per verificare i titolari o i membri del consiglio di amministrazione. Il codice seguente mostra un esempio di account connesso con requisiti relativi al titolare. Le opzioni specifiche e l’ordine in cui appaiono possono variare da un account all’altro. ```shell // Example with owner requirements > curl https://api.stripe.com/v1/accounts/acct_1234 \ -u sk_test_123: { "id": "acct_1234", "past_due": { // third-party provider option "currently_due": [ "owners.first_name", "owners.last_name", "company.owners_provided", "company.tax_id" ], "alternatives": [ { "original_fields_needed": [ "owners.first_name", "owners.last_name", "company.owners_provided", "company.tax_id" ], // official document option "alternative_fields_needed": [ "owners.first_name", "owners.last_name", "company.owners_provided", "company.name", "company.address.line1", "company.address.state", "company.address.city", "documents.proof_of_ultimate_beneficial_ownership.files" ], }, { "original_fields_needed": [ "owners.first_name", "owners.last_name", "company.owners_provided", "company.tax_id" ], // digital attestation option "alternative_fields_needed": [ "owners.first_name", "owners.last_name", "company.owners_provided", "company.name", "company.address.line1", "company.address.state", "company.address.city", "documents.proof_of_ultimate_beneficial_ownership.files", "documents.proof_of_ultimate_beneficial_ownership.signer" ], } ] } } ``` ### Verifica i membri del consiglio di amministrazione anziché i titolari Se un account connesso è idoneo a fornire membri del consiglio di amministrazione anziché titolari, include opzioni alternative per la verifica dei membri del consiglio di amministrazione. Se si verificano i membri del consiglio di amministrazione, è comunque necessario attestare di aver fornito 0 UBO. L’esempio seguente mostra un account connesso che è idoneo a verificare i membri del consiglio di amministrazione anziché i titolari: ```shell // Example with owner requirements > curl https://api.stripe.com/v1/accounts/acct_1234 \ -u sk_test_123: { "id": "acct_1234", "past_due": { // third-party provider option for owners "currently_due": [ "owners.first_name", "owners.last_name", "company.owners_provided", "company.tax_id" ], "alternatives": [ ..., { "original_fields_needed": [ "owners.first_name", "owners.last_name", "company.owners_provided", "company.tax_id" ], // third-party provider option for directors "alternative_fields_needed": [ "directors.first_name", "directors.last_name", "company.directors_provided", "company.owners_provided", "company.tax_id" ], } ] } } ``` Se fornisci informazioni sul membro del consiglio di amministrazione e attesti di fornire 0 UBO, le opzioni relative ai requisiti primari riflettono comunque i requisiti relativi al titolare. Puoi fornire le informazioni sul titolare non appena saranno disponibili. Il seguente esempio mostra un account connesso con attestazione UBO pari a 0: ```shell // Example with owner requirements > curl https://api.stripe.com/v1/accounts/acct_1234 \ -u sk_test_123: { "id": "acct_1234", "past_due": { // third-party provider option for owners "currently_due": [ "owners.first_name", "owners.last_name", // company.owners_provided is no longer a requirement "company.tax_id" ], "alternatives": [ ..., { "original_fields_needed": [ "owners.first_name", "owners.last_name", "company.tax_id" ], // third-party provider option for directors "alternative_fields_needed": [ "directors.first_name", "directors.last_name", "company.directors_provided", "company.tax_id" ], } ] } } ``` ### Gestione degli errori Gli errori relativi ai requisiti del titolare e del membro del consiglio di amministrazione possono includere i seguenti valori `code` oltre agli [errori comuni di mancata corrispondenza dei documenti e dei dettagli](https://docs.stripe.com/error-codes.md). | Codice | Descrizione | | ----------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `verification_missing_owners` | Nell’`Account` mancano informazioni sui titolari identificati da un fornitore terzo o che figurano in un documento o in un attestato digitale. | | `verification_missing_directors` | Nell’`Account` mancano informazioni sui membri del consiglio di amministrazione identificati da un fornitore terzo o che figurano in un documento o in un attestato digitale. | | `verification_data_not_found` (Private preview) | Un fornitore terzo non è riuscito a trovare informazioni sull’attività. | A volte puoi risolvere questi errori aggiornando i dati dell’attività. Tuttavia, nella maggior parte dei casi, devi indirizzare l’account connesso al percorso di caricamento del documento o al percorso di attestazione digitale. Quando Stripe identifica i titolari o i membri del consiglio di amministrazione mancanti, in alcuni casi un’API privata di anteprima può fornire dati su di loro. L’account connesso può utilizzare tali dati per creare le `Persons` scomparse. ### Implementa l'attestazione digitale per la verifica dell'UBO e del membro del consiglio di amministrazione utilizzando l'API > #### Disponibilità > > L’API Accounts v2 non fornisce ancora assistenza per l’attestazione digitale. Il seguente esempio mostra come eseguire l’attestazione digitale per la verifica dell’UBO o dei membri del consiglio di amministrazione. 1. Recupera l’account per identificare i documenti di attestazione necessari. ```shell // Check for UBO attestation requirement > curl https://api.stripe.com/v1/accounts/acct_1234 \ -u sk_test_123: // Response showing UBO attestation { "id": "acct_1234", "requirements": { "past_due": [ "documents.proof_of_ultimate_beneficial_ownership.files", "documents.proof_of_ultimate_beneficial_ownership.signer", ], "errors": [] } } // Or for directors & officers requirement { "id": "acct_1234", "requirements": { "past_due": [ "documents.proof_of_registration.files", "documents.proof_of_registration.signer" ], "errors": [] } } ``` L’opzione dei requisiti di attestazione digitale può essere visualizzata come opzione principale o in alternativa a un’altra opzione. Le opzioni particolari e l’ordine in cui compaiono possono variare da un account all’altro. 1. Genera un PDF utilizzando il modello e fallo firmare digitalmente da una persona autorizzata. 1. Carica il documento di attestazione firmato con l’API File. ```shell curl -X POST https://files.stripe.com/v1/files \ -u sk_test_123: \ -F purpose=account_requirement \ -F file=@signed_attestation.pdf // Response { "id": "file_1234567890", "object": "file", "purpose": "account_requirement" } ``` 1. Invia il documento con il documento di identità della `Person` che rappresenta il firmatario. ```shell // For UBO attestation curl -X POST https://api.stripe.com/v1/accounts/acct_1234 \ -u sk_test_123: \ -d "documents[proof_of_ultimate_beneficial_ownership][files][]=file_1234567890" \ -d "documents[proof_of_ultimate_beneficial_ownership][signer][person]=person_xyz" // For D&O attestation curl -X POST https://api.stripe.com/v1/accounts/acct_1234 \ -u sk_test_123: \ -d "documents[proof_of_registration][files][]=file_1234567890" \ -d "documents[proof_of_registration][signer][person]=person_xyz" ``` ### Requisiti di convalida del firmatario Chi può firmare le attestazioni - Rappresentanti dell’account - Titolari di attività (25% di proprietà e oltre) - Membri del consiglio di amministrazione e dirigenti - Altri membri autorizzati dell’account Importante: il firmatario deve essere una persona esistente associata all’account. Solo le persone fisiche con un rapporto documentato con la persona giuridica possono firmare i documenti di attestazione. ### Gestione degli errori L’attestazione digitale introduce scenari d’errore specifici che devi gestire: #### Firmatario non valido Si verifica quando il firmatario non è associato all’account o non ha l’autorità. ```shell { "requirements": { "errors": [{ "requirement": "documents.proof_of_ultimate_beneficial_ownership.files", "code": "invalid_signator", "reason": "Unauthorized attestation signer. The signer must have a documented relationship with the legal entity." }, { "requirement": "documents.proof_of_ultimate_beneficial_ownership.signer", "code": "invalid_signator", "reason": "Unauthorized attestation signer. The signer must have a documented relationship with the legal entity." }] } } ``` #### Documento non riuscito Si verifica quando il documento caricato è illeggibile o errato. ```shell { "requirements": { "past_due": ["documents.proof_of_registration.files"], "errors": [{ "requirement": "documents.proof_of_registration.files", "code": "verification_document_failed_other", "reason": "Your team can contact Stripe to learn more about why identity verification failed." }] } } ``` #### Firmatario inviato senza file Errori API durante l’invio del firmatario senza file ```shell { "error": { "code": "invalid_signator", "message": "signer.person can only be provided when a file is also provided", "type": "invalid_request_error" } } ``` ### Passaggi successivi 1. Aggiorna la tua integrazione per riscuotere i firmatari quando utilizzi i documenti di attestazione. 1. Implementa la gestione degli errori per i nuovi codici d’errore specifici dell’attestazione. 1. Forma il tuo team di assistenza sui nuovi requisiti di attestazione. #### Precompila le informazioni sull’UBO e sui membri del Consiglio di amministrazione (Anteprima privata) Facoltativamente, puoi anche integrare un’API che rileva e precompila tramite codice gli UBO o i membri del consiglio di amministrazione associati a una persona giuridica. L’account connesso può verificare la relazione confermando le informazioni rilevate invece di caricare documenti o fornire un’attestazione digitale. Questo percorso può aumentare i tassi di verifica e ridurre le complessità, ma non funziona per tutti gli account. Devi comunque gestire il caricamento dei documenti o le attestazioni digitali per gli account per i quali Stripe non può precompilare le relazioni. Se ti interessa precompilare per la verifica UBO o membro del consiglio di amministrazione, crea il tuo account Express di seguito. ## Requisiti di registrazione delle attività olandesi (KvK) **In vigore dal 14 maggio 2026** All’inizio del 2026, alle piattaforme è stato richiesto di raccogliere un numero KvK (Kamer van Koophandel), un numero univoco di registrazione aziendale a 8 cifre, dagli account connessi nei Paesi Bassi (NL). Nell’ambito di questa modifica, il tipo di business `individual` è stato reso con limitazioni con un errore `unsupported_business_type` e alle entità non incorporate è stato richiesto di fornire un numero KvK tramite `company.tax_id`. A partire dal 14 maggio 2026, gli account connessi che rappresentano persone fisiche o entità non incorporate che non hanno accesso a una Dashboard in hosting su Stripe non sono più tenuti a fornire un numero KvK. Gli account connessi che rappresentano persone fisiche o entità non incorporate che hanno accesso alla Dashboard Stripe completa o alla Dashboard Express devono ancora fornire un numero KvK. ### Cosa cambierà - `business_type: "individual"` è ora supportato per gli account connessi nei Paesi Bassi che non hanno accesso a una Dashboard in hosting su Stripe. L’errore `unsupported_business_type` non viene più visualizzato per questi account. - I tipi di business `unincorporated_partnership` e `unincorporated_non_profit` non richiedono più che `company.tax_id` contenga il numero KvK per gli account connessi che non hanno accesso a una Dashboard in hosting su Stripe. ### Cosa devi fare Non è richiesta alcuna azione. Non è necessario apportare modifiche alla tua integrazione. Per gli account connessi esistenti interessati da questa modifica: - Stripe cancella automaticamente l’errore `unsupported_business_type` da `requirements.errors` per gli account di persone fisiche - Eventuali limitazioni delle funzionalità (come `card_payments` o `transfers`) collegate a questo errore vengono rimosse automaticamente. - Gli account che rappresentano persone fisiche o entità non incorporate che erano con limitazioni per mancanza del numero KvK vengono anch’essi automaticamente ripristinati. ## Nuovi codici di errore ### Codici di errore di verifica (Private preview) Il nuovo codice di errore `verification_data_not_found` può comparire nell’array `requirements.errors` dell’oggetto `Account`. Questo errore indica che Stripe non è riuscita a recuperare informazioni (come i dati relativi a UBO o membri del consiglio di amministrazione/funzionari) dai fornitori di verifica terzi utilizzando i dettagli della persona giuridica associati all’account connesso. Ciò può accadere per diversi motivi, ma spesso è dovuto all’inserimento errato delle informazioni da parte dell’account. Questo errore “dati non trovati” è distinto dai codici di errore di verifica esistenti: - **`verification_missing_owners`**: indica che i titolari noti non sono presenti nell’account. - **`verification_failed_keyed_match`**: indica una mancata corrispondenza tra le informazioni inviate e le fonti di verifica. ```shell // Example: verification_data_not_found error { "requirements": { "errors": [{ "requirement": "owners", "code": "verification_data_not_found", "reason": "Stripe was unable to retrieve ownership or director information from third-party providers based on the current legal entity details. Verify that the business information on the account is correct." }] } } ``` Per gestire questo errore, chiedi all’account connesso di rivedere e correggere le informazioni sulla persona giuridica (nome dell’azienda, numero di registrazione, indirizzo). Se aggiorna le informazioni, Stripe tenta automaticamente di verificarle di nuovo. Se le informazioni dell’account sono corrette o se Stripe non riesce ancora a verificare le informazioni aggiornate, utilizza un metodo di verifica manuale come il caricamento dei documenti o l’attestazione digitale. ## Test Puoi creare account di test da utilizzare durante lo sviluppo e il collaudo dell’integrazione. Gli account di test possono simulare diversi risultati di verifica, consentendo di vedere come l’API restituisce i requisiti e gli errori per ciascun caso. I seguenti esempi ti aiutano a prepararti alle imminenti modifiche dei requisiti UE. Per ulteriori informazioni sui test di Connect in generale, consulta [Test di Stripe Connect](https://docs.stripe.com/connect/testing.md). ### Crea un account di test Crea un `Account` di test inviando una richiesta POST all’API Accounts utilizzando la tua [chiave privata sandbox](https://docs.stripe.com/keys.md). Per accedere ai nuovi requisiti prima che vengano rilasciati agli account in modalità non di test, imposta un’intestazione che abiliti una versione di anteprima dell’API, abilita la funzione di anteprima sperimentale dell’attivazione e abilita la versione di anteprima quando richiedi una funzionalità. Ad esempio: ```shell curl https://api.stripe.com/v1/accounts \ -u sk_test_123: \ -H "Stripe-Version: 2026-01-28.preview;experimental_onboarding_preview=v2" \ -d 'type'='custom' \ -d 'country'='ES' \ -d 'capabilities[card_payments][requested]'='true' \ -d 'capabilities[card_payments][preview]'='true' \ -d 'capabilities[transfers][requested]'='true' \ -d 'capabilities[transfers][preview]'='true' ``` Gli esempi riportati di seguito mostrano come simulare situazioni diverse utilizzando valori che attivano risposte specifiche per gli account di test. ### Testare un account appartenente a una persona fisica Questo esempio crea un account che non richiede la verifica della relazione perché il tipo di persona fisica di attività è `individual`. Crea un account di test seguendo [le istruzioni precedenti](https://docs.stripe.com/connect/upcoming-requirements-updates.md#create-a-test-account), quindi imposta i dettagli di base dell’attività: ```shell curl https://api.stripe.com/v1/accounts/acct_test_123 \ -u sk_test_123: \ -d business_type=individual \ -d "business_profile[mcc]"=5995 \ -d "business_profile[url]"="https://accessible.stripe.com" ``` La risposta include i requisiti di base per una persona fisica. Puoi soddisfare questi requisiti creando un rappresentante: ```shell curl https://api.stripe.com/v1/accounts/acct_test_123/persons \ -u sk_test_123: \ -d "first_name=Marie" \ -d "last_name=Dupont" \ -d "dob[year]=1901" \ -d "dob[month]=1" \ -d "dob[day]=1" \ -d "address[line1]=address_full_match" \ -d "address[city]=Madrid" \ -d "address[postal_code]=28009" \ -d "address[country]=ES" \ -d "email=test@example.com" \ -d "phone=%2B35366666666" \ -d "nationality=ES" \ -d "relationship[representative]=true" ``` Specificando la data di nascita 1901-01-01 si attiva la verifica dell’identità in una sandbox. Per altri risultati, consulta [Date di nascita di test](https://docs.stripe.com/connect/testing.md#test-dobs). Allo stesso modo, impostando la prima riga dell’indirizzo sulla stringa `address_full_match` si attiva la verifica dell’indirizzo. Per altri risultati, consulta [Indirizzi aziendali di test](https://docs.stripe.com/connect/testing.md#test-validation-addresses). La risposta mostra che i requisiti della persona fisica sono diventati in sospeso. Se aspetti qualche istante e recuperi l’`Account`, puoi notare che tali requisiti sono stati soddisfatti: ```shell curl https://api.stripe.com/v1/accounts/acct_test_123 \ -u sk_test_123 ``` Gli unici requisiti rimanenti sono per il conto (`external_account`) e i termini di servizio (TOS). Per cancellare i requisiti dei termini di servizio, imposta l’hash `tos_acceptance` dell’`Account`: ```shell curl https://api.stripe.com/v1/accounts/acct_test_123 \ -u sk_test_123: \ -d "tos_acceptance[date]=1540248693" \ -d "tos_acceptance[ip]=10.0.0.1" ``` Per soddisfare i requisiti del conto bancario, crea un conto bancario di test per `Account`. Specifica [un numero di conto bancario di test in base al Paese](https://docs.stripe.com/connect/testing.md#account-numbers): ```shell curl https://api.stripe.com/v1/accounts/acct_test_123/external_accounts \ -u sk_test_123: \ -d "external_account[object]=bank_account" \ -d "external_account[account_number]=ES0700120345030000067890" \ -d "external_account[country]=ES" \ -d "external_account[currency]=EUR" ``` ### Testare un account appartenente a un’azienda Questo esempio crea un account soggetto a requisiti di verifica della relazione perché il tipo di persona giuridica dell’attività è `company`. > Il Regno Unito richiede la verifica sia dei titolari effettivi finali che degli amministratori. Se disponi di account connessi nel Regno Unito, assicurati di effettuare il test con conti che hanno il Paese impostato su `GB`. Crea un account di test seguendo [le istruzioni precedenti](https://docs.stripe.com/connect/upcoming-requirements-updates.md#create-a-test-account), quindi imposta i dettagli di base dell’attività: ```shell curl https://api.stripe.com/v1/accounts/acct_test_123 \ -u sk_test_123: \ -d business_type=company \ -d "business_profile[mcc]"=5995 \ -d "business_profile[url]"="https://accessible.stripe.com" \ -d "company[name]=Test company" \ -d "company[phone]=628123456787" \ -d "company[address][line1]=address_full_match" \ -d "company[address][city]=Madrid" \ -d "company[address][postal_code]=28009" \ -d "company[address][country]=ES" \ -d "company[tax_id]=000000000" ``` Se specifichi il numero di ID fiscale `000000000`, la verifica dell’azienda va a buon fine. Per altri trigger di risultato, consulta [Testare gli ID fiscali dell’attività](https://docs.stripe.com/connect/testing.md#test-business-tax-ids). Poi fornisci un rappresentante. ```shell curl https://api.stripe.com/v1/accounts/acct_test_123/persons \ -u sk_test_123: \ -d "first_name=Adam" \ -d "last_name=" \ -d "dob[year]=1901" \ -d "dob[month]=1" \ -d "dob[day]=1" \ -d "address[line1]=address_full_match" \ -d "address[city]=Madrid" \ -d "address[postal_code]=28009" \ -d "address[country]=ES" \ -d "email=test@example.com" \ -d "phone=%2B35366666666" \ -d "nationality=ES" \ -d "relationship[representative]=true" \ -d "relationship[title]=CEO" ``` Al termine della verifica elaborata per il rappresentante, puoi visualizzare i requisiti rimanenti con una richiesta GET: ```shell curl https://api.stripe.com/v1/accounts/acct_test_123 \ -u sk_test_123: ``` I requisiti nella matrice `requirements.currently_due` elencano i dettagli di cui abbiamo bisogno sui titolari dell’`Account`. La matrice `requirements.alternatives` può includere informazioni facoltative che puoi fornire per soddisfare determinati requisiti. Ad esempio: ```json { "alternative_fields_due": [ "company.owners_provided", "documents.proof_of_ultimate_beneficial_ownership.files", "owners.first_name", "owners.last_name" ], "original_fields_due": [ "company.owners_provided", "owners.first_name", "owners.last_name" ] } ``` Puoi specificare i campi elencati in `alternative_fields_due` come altro modo per soddisfare i requisiti nell’elenco `original_fields_due` corrispondente. In questo esempio, `alternative_fields_due` include le proprietà in `original_fields_due`, oltre a `documents.proof_of_ultimate_beneficial_ownership.files`. Ciò significa che le informazioni originali sono obbligatorie, ma che hai la possibilità di fornire anche un documento che dimostri il titolare effettivo finale per facilitare l’elaborazione della verifica. Per soddisfare i requisiti del titolare, crea due persone e contrassegnale come titolari. I nomi in questo esempio sono valori con codice rigido per gli account di test che utilizzano l’ID fiscale `000000000`. ```shell curl https://api.stripe.com/v1/accounts/acct_test_123/persons \ -u sk_test_123: \ -d "first_name=Marie" \ -d "last_name=Dupont" \ -d "dob[year]=1901" \ -d "dob[month]=1" \ -d "dob[day]=1" \ -d "address[line1]=address_full_match" \ -d "address[city]=Madrid" \ -d "address[postal_code]=28009" \ -d "address[country]=ES" \ -d "email=owner@example.com" \ -d "relationship[owner]=true" curl https://api.stripe.com/v1/accounts/acct_test_123/persons \ -u sk_test_123: \ -d "first_name=Louis" \ -d "last_name=Martin" \ -d "dob[year]=1901" \ -d "dob[month]=1" \ -d "dob[day]=1" \ -d "address[line1]=address_full_match" \ -d "address[city]=Madrid" \ -d "address[postal_code]=28009" \ -d "address[country]=ES" \ -d "email=owner@example.com" \ -d "relationship[owner]=true" ``` Indica che hai creato tutti i titolari dell’`Account` impostando `company.owners_provided` su true: ```shell curl https://api.stripe.com/v1/accounts/acct_test_123 \ -u sk_test_123: \ -d "company[owners_provided]=true" ``` Se completi questa richiesta, tutti i requisiti del titolare verranno rimossi dall’`Account`. ### Testa il fallback per la verifica dei documenti I requisiti del titolare di un `Account` rimangono in `currently_due` (o in `pending_verification`, se è in corso la verifica) fino a quando la verifica non va a buon fine. Quando la verifica non va a buon fine, puoi caricare un documento. Questo esempio mostra come farlo utilizzando l’API. Crea un account di test seguendo [le istruzioni precedenti](https://docs.stripe.com/connect/upcoming-requirements-updates.md#create-a-test-account), quindi imposta i dettagli di base dell’attività. Imposta l’ID fiscale su `222221001`, il che attiva l’esito negativo della verifica del beneficiario. Per altri risultati, consulta [Test degli ID fiscali delle attività](https://docs.stripe.com/connect/testing.md#test-business-tax-ids). ```shell curl https://api.stripe.com/v1/accounts/acct_test_123 \ -u sk_test_123: \ -d business_type=company \ -d "business_profile[mcc]"=5995 \ -d "business_profile[url]"="https://accessible.stripe.com" \ -d "company[name]=Test company" \ -d "company[phone]=628123456787" \ -d "company[address][line1]=address_full_match" \ -d "company[address][city]=Madrid" \ -d "company[address][postal_code]=28009" \ -d "company[address][country]=ES" \ -d "company[tax_id]=222221001" ``` Poi fornisci un rappresentante: ```shell curl https://api.stripe.com/v1/accounts/acct_test_123/persons \ -u sk_test_123: \ -d "first_name=Marie" \ -d "last_name=Dupont" \ -d "dob[year]=1901" \ -d "dob[month]=1" \ -d "dob[day]=1" \ -d "address[line1]=address_full_match" \ -d "address[city]=Madrid" \ -d "address[postal_code]=28009" \ -d "address[country]=ES" \ -d "email=test@example.com" \ -d "phone=%2B35366666666" \ -d "nationality=ES" \ -d "relationship[representative]=true" \ -d "relationship[title]=CEO" ``` Quindi crea un titolare: ```shell curl https://api.stripe.com/v1/accounts/acct_test_123/persons \ -u sk_test_123: \ -d "first_name=Adam" \ -d "last_name=Smith" \ -d "dob[year]=1901" \ -d "dob[month]=1" \ -d "dob[day]=1" \ -d "address[line1]=address_full_match" \ -d "address[city]=Madrid" \ -d "address[postal_code]=28009" \ -d "address[country]=ES" \ -d "email=owner@example.com" \ -d "relationship[owner]=true" ``` Indica che hai finito di creare titolari impostando `company.owners_provided` su true: ```shell curl https://api.stripe.com/v1/accounts/acct_test_123 \ -u sk_test_123: \ -d "company[owners_provided]=true" ``` Se esamini l’`Account`, puoi notare che i requisiti del titolare rimangono e che la matrice `requirements.errors` contiene una voce con un `requirement` di `owner` e un `code` di `verification_failed_other`. Ciò significa che Stripe non è stata in grado di verificare i titolari utilizzando le informazioni fornite sull’azienda. > Se utilizzi la versione di anteprima privata dell’API, il codice di errore è [verification_data_not_found](https://docs.stripe.com/changelog/clover/2025-10-29/accounts-verification-data-error.md) anziché `verification_failed_other`. Se ricevi questo errore per un `Account` reale, verifica di aver inserito i dati della persona giuridica corretta. Questo esempio presuppone che i dati siano corretti e che tu debba fornire un documento per verificarli. Per un `Account` reale, [utilizza l’API Files per caricare un documento](https://docs.stripe.com/file-upload.md), quindi aggiorna `Account` utilizzando il token restituito nella risposta. Per questo esempio, utilizza il token di test `file_relationship_document_success`. Per altri trigger di risultato, consulta i [Test dei token dei documenti di relazione](https://docs.stripe.com/connect/testing.md#test-relationship-document-tokens). ```shell curl https://api.stripe.com/v1/accounts/acct_test_123 \ -u sk_test_123: \ -d "documents[proof_of_ultimate_beneficial_ownership][files][]"=file_relationship_document_success ``` Pochi istanti dopo aver aggiornato `Account`, puoi recuperare i requisiti attuali e verificare che i requisiti del titolare siano stati soddisfatti. ```shell curl https://api.stripe.com/v1/accounts/acct_test_123 \ -u sk_test_123: ``` ### Testare un’azienda senza titolari idonei Se un’azienda non ha titolari con una quota di proprietà superiore al 25%, Stripe richiede le informazioni sul membro del consiglio di amministrazione. Questo esempio mostra come fornire le informazioni sul membro del consiglio di amministrazione. Crea un account di test seguendo [le istruzioni precedenti](https://docs.stripe.com/connect/upcoming-requirements-updates.md#create-a-test-account), quindi imposta i dettagli di base dell’attività. Imposta l’ID fiscale su `000000000`, in modo che la verifica dell’azienda vada a buon fine. ```shell curl https://api.stripe.com/v1/accounts/acct_test_123 \ -u sk_test_123: \ -d business_type=company \ -d "business_profile[mcc]"=5995 \ -d "business_profile[url]"="https://accessible.stripe.com" \ -d "company[name]=Test company" \ -d "company[phone]=628123456787" \ -d "company[address][line1]=address_full_match" \ -d "company[address][city]=Madrid" \ -d "company[address][postal_code]=28009" \ -d "company[address][country]=ES" \ -d "company[tax_id]=000000000" ``` Poi fornisci un rappresentante: ```shell curl https://api.stripe.com/v1/accounts/acct_test_123/persons \ -u sk_test_123: \ -d "first_name=Marie" \ -d "last_name=Dupont" \ -d "dob[year]=1901" \ -d "dob[month]=1" \ -d "dob[day]=1" \ -d "address[line1]=address_full_match" \ -d "address[city]=Madrid" \ -d "address[postal_code]=28009" \ -d "address[country]=ES" \ -d "email=test@example.com" \ -d "phone=%2B35366666666" \ -d "nationality=ES" \ -d "relationship[representative]=true" \ -d "relationship[title]=CEO" ``` Per indicare che l’attività non ha titolari rilevanti, imposta `company.owners_provided` su true senza creare titolari. Per riutilizzare un `Account` di test esistente con titolari, puoi rimuovere tutti i titolari esistenti. ```shell curl https://api.stripe.com/v1/accounts/acct_test_123 \ -u sk_test_123: \ -d "company[owners_provided]=true" ``` La matrice `requirements.alternatives` contiene una serie di proprietà del membro del consiglio di amministrazione in alternativa alle proprietà del titolare. Il processo di creazione di un membro del consiglio di amministrazione è molto simile a quello di creazione di un titolare: ```shell curl https://api.stripe.com/v1/accounts/acct_test_123/persons \ -u sk_test_123: \ -d "first_name=Adam" \ -d "last_name=Smith" \ -d "dob[year]=1901" \ -d "dob[month]=1" \ -d "dob[day]=1" \ -d "address[line1]=address_full_match" \ -d "address[city]=Madrid" \ -d "address[postal_code]=28009" \ -d "address[country]=ES" \ -d "email=owner@example.com" \ -d "relationship[director]=true" \ -d "relationship[title]=President" ``` Indica che hai finito di creare membri del consiglio di amministrazione impostando `company.directors_provided` su true: ```shell curl https://api.stripe.com/v1/accounts/acct_test_123 \ -u sk_test_123: \ -d "company[directors_provided]=true" ``` Per simulare una corretta verifica delle relazioni, imposta `company.name` sulla stringa `match_name_relationships`: ```shell curl https://api.stripe.com/v1/accounts/acct_test_123 \ -u sk_test_123: \ -d "company[name]=match_name_relationships" ``` ### Altri casi di test Anche i seguenti test sono preziosi: - Un’entità di tipo `non_profit`, che richiede la verifica del membro del consiglio di amministrazione (la verifica UBO non è un’opzione). - Soddisfare i requisiti di verifica del membro del consiglio di amministrazione utilizzando un documento. - Aziende nel Regno Unito che richiedono sia la verifica dell’UBO che quella del membro del consiglio di amministrazione. #### Programma - Brasile *Ultimo aggiornamento: 27 aprile 2026* ## Comprendere le modifiche ai requisiti di verifica Per allinearsi alle normative della Banca Centrale del Brasile (BCB) ai sensi della Circolare BCB 3978/20, Stripe sta aggiornando i propri requisiti di controllo per adeguata verifica della clientela, adeguata verifica dell’attività (KYB) e titolare effettivo (UBO). Se i tuoi conti connessi operano in Brasile, potrebbe essere necessario aggiornare i flussi di attivazione e di regolarizzazione. La mancata esecuzione degli aggiornamenti richiesti interromperà l’accesso dei tuoi conti connessi ai pagamenti e ai servizi finanziari. ## Scegli un approccio di integrazione Stripe consiglia di utilizzare l’attivazione in hosting o incorporata su Stripe per raccogliere i requisiti di verifica dell’attività e dell’identità. Queste opzioni richiedono meno risorse da implementare e gestire rispetto all’attivazione con API. La tabella seguente descrive le principali differenze: - [Attivazione in hosting su Stripe](https://docs.stripe.com/connect/hosted-onboarding.md): (Consigliato) invia gli account a un flusso in hosting su Stripe per inoltrare le informazioni richieste. - [Attivazione integrata](https://docs.stripe.com/connect/embedded-onboarding.md): (Consigliato) integra componenti di attivazione forniti da Stripe che consentono agli account di inviare le informazioni direttamente a Stripe dalla tua app. - [Attivazione tramite API](https://docs.stripe.com/connect/api-onboarding.md): crea e gestisci un flusso di attivazione personalizzato utilizzando le API di Stripe. | | **Attivazione in hosting su Stripe** | **Attivazione integrata** | **Attivazione basata su API** | | -------------------------------------------------------------- | --------------------------------------------------------------- | ------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------- | | Ottimali per | Piattaforme che desiderano che Stripe gestisca l’attivazione | Piattaforme che desiderano un flusso di attivazione brandizzato in-app | Piattaforme che hanno necessitano di pieno controllo, possono crearlo e mantenerlo | | Impegno di implementazione iniziale | 3-4 settimane di progettazione | 3-4 settimane di progettazione | 30-40 settimane di progettazione | | Impegno continuo per risolvere gli aggiornamenti dei requisiti | Gestito automaticamente da Stripe | Gestito automaticamente da Stripe | Richiede un monitoraggio proattivo delle modifiche imminenti, oltre a risorse tecniche per aggiornare il flusso di attivazione a ogni modifica | | Personalizzazione | Interfaccia in hosting su Stripe con branding della piattaforma | Componente altamente tematizzabile a cui gli account accedono attraverso l’app della piattaforma | La piattaforma progetta, crea e gestisce l’interfaccia | | Impegno per il supporto di altri Paesi | Gestito automaticamente da Stripe | Gestito automaticamente da Stripe | Richiede risorse tecniche per aggiornare il flusso di attivazione per ogni Paese aggiuntivo | Scopri di più sulle [opzioni di attivazione Connect](https://docs.stripe.com/connect/onboarding.md) e sulla [migrazione dei tuoi flussi di integrazione e risoluzione basati su API a flussi integrati o in hosting su Stripe](https://docs.stripe.com/connect/migrate-from-api-onboarding.md). Le piattaforme che utilizzano l’attivazione in hosting o integrato da Stripe non devono modificare le proprie integrazioni per questi aggiornamenti dei requisiti: Stripe li gestisce automaticamente. Le piattaforme che utilizzano l’attivazione basata su API devono monitorare attivamente le modifiche ai requisiti e allocare risorse tecniche per ogni aggiornamento. ## Panoramica sull’integrazione API Se la tua piattaforma utilizza l’attivazione basata su API, devi aggiornare l’integrazione per gestire le seguenti modifiche per i conti brasiliani connessi: - **Adeguata verifica della clientela: verifica dell’identità individuale**. Acquisisci CPF, data di nascita, indirizzo e verifica di presenza per tutti i conti intestati a persone fisiche e a rappresentanti dell’attività - **Adeguata verifica dell’attività: verifica dell’identità della persona giuridica**. Acquisisci il CNPJ, la ragione sociale e la sede legale per le persone giuridiche, gestisci i flussi di verifica programmatica e i flussi alternativi basati su documentazione - **Stato di registrazione dell’ID fiscale**: gestisci lo stato di registrazione per i codici CPF e CNPJ inattivi o non validi - **Verifica dell’UBO e del rapporto**: verifica che gli amministratori o i titolari dell’attività siano legalmente registrati come tali - **Capacità finanziaria** acquisisci i dati relativi al reddito mensile o ai ricavi lordi di tutti i conti brasiliani prima che le funzionalità possano essere attivate - **Nuovi codici di errore**: gestisci i nuovi codici di errore di verifica emersi nell’array `requirements.errors` ## Adeguata verifica della clientela: verifica dell’identità delle persone fisiche Stripe sta rafforzando la verifica dell’identità per i conti intestati a persone fisiche in Brasile al fine di conformarsi ai requisiti della Banca Centrale Brasiliana (BCB). I conti connessi intestati a persone fisiche e i rappresentanti dei conti che sono persone giuridiche devono essere verificati: potrebbe essere necessario fornire ulteriori informazioni come parte della procedura di attivazione. Le seguenti persone devono fornire informazioni controllabili per l’adeguata verifica della clientela: - **Rappresentante dell’attività**: la persona che firma i Termini di servizio ed è legalmente responsabile del conto. - **Titolari**: i titolari delle entità giuridiche (ove applicabile). Stripe utilizza una combinazione di dati inseriti manualmente e revisione dei documenti per verificare l’identità di ogni persona. Inoltre, la normativa brasiliana richiede una verifica di presenza (`proof_of_liveness`) per confermare che la persona che presenta i documenti di identità sia fisicamente presente. I flussi di attivazione in hosting su Stripe e integrati gestiscono automaticamente questa fase. Se la tua piattaforma utilizza l’attivazione basata su API, devi reindirizzare gli utenti a per una fase di verifica in hosting su Stripe o integrare il componente `` integrato per completare la raccolta dei dati di verifica di presenza. Vedi [Gestire i requisiti di verifica di presenza](https://docs.stripe.com/connect/api-onboarding.md?accounts-namespace=v1&liveness=hosted#proof-of-liveness) per maggiori dettagli. **Requisiti di età:** i rappresentanti aziendali devono avere almeno 18 anni. I titolari, gli amministratori e i dirigenti devono avere almeno 16 anni. Ai nuovi utenti che non soddisfano questi requisiti non saranno abilitate le funzionalità. I conti esistenti con un rappresentante aziendale di età inferiore ai 16 anni saranno disattivati immediatamente al momento della migrazione della piattaforma. ### Campi obbligatori I conti brasiliani intestati a persone fisiche ora richiedono i seguenti campi: | Campo | Descrizione | | ----------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | | `person.first_name`, `person.last_name` | Ragione sociale completa | | `person.id_number` | CPF (ID fiscale delle persone fisiche brasiliano) | | `person.address.line1`, `.city`, `.postal_code`, `.country` | Indirizzo di residenza in Brasile. Tutti i rappresentanti aziendali devono essere residenti in Brasile e fornire un indirizzo brasiliano. | | `person.dob.day`, `.month`, `.year` | Data di nascita | | `person.verification.proof_of_liveness` | Selfie di verifica della presenza: supportato solo nei flussi in hosting o incorporati da Stripe | | `person.verification.additional_document` | Requisito documentale facoltativo in caso di mancata verifica dell’indirizzo digitato. | Non è richiesto alcun nome di campo se la tua piattaforma acquisisce già `person.id_number`. Assicurati che l’interfaccia utente raccolga specificatamente un CPF: non accettiamo altri tipi di ID (numeri di passaporto, codici fiscali stranieri) per i conti brasiliani. ### Risposta ai requisiti iniziali Quando viene creato un nuovo conto intestato a persone fisiche, l’hash `requirements` includerà: ```json { "currently_due": [ "person.first_name", "person.last_name", "person.id_number", "person.dob.day", "person.dob.month", "person.dob.year", "person.address.line1", "person.address.city", "person.address.state", "person.address.country", "person.verification.proof_of_liveness" ], "pending_verification": [], "alternatives": [ { "original_fields_due": ["person.address.line1", "person.address.city", "person.address.state", "person.address.country"], "alternative_fields_due": ["person.verification.additional_document"] } ], "errors": [] } ``` ### Raccolta dei dati personali Utilizza l’API Persone per inviare singoli campi: ```shell curl https://api.stripe.com/v1/accounts/{{CONNECTED_ACCOUNT_ID}}/persons/{{PERSON_ID}} \ -u "{{PLATFORM_SECRET_KEY}}:" \ -d "first_name=Maria" \ -d "last_name=Silva" \ -d "id_number=123.456.789-09" \ -d "dob[day]=15" \ -d "dob[month]=6" \ -d "dob[year]=1985" \ -d "address[line1]=Rua das Flores, 123" \ -d "address[city]=São Paulo" \ -d "address[state]=SP" \ -d "address[postal_code]=01310-100" \ -d "address[country]=BR" ``` ### Gestione degli errori | Codice di errore | Trigger | Rimedio | | ------------------------------------------ | -------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `verification_failed_id_number_inactive` | CPF trovato ma lo stato è inattivo (ad esempio, sospeso, annullato, deceduto). | L’utente deve risolvere lo stato del CPF con l’Agenzia delle Entrate brasiliana (Receita Federal). I conti con stato CPF annullato, nullo o deceduto saranno disattivati: non è possibile risolvere il problema caricando i documenti. | | `verification_failed_keyed_match` | Sia la ricerca automatica che la verifica manuale non sono riuscite a verificare il CPF. | L’utente invia nuovamente il CPF e il documento di identità: il conto entra nella coda MVR. | | `verification_document_type_not_supported` | Il documento caricato è di tipo errato, proviene da un Paese non supportato o è illeggibile. | L’utente ricarica un documento di identità rilasciato da un’autorità governativa brasiliana. | ## Verifica dell’identità della persona giuridica per la verifica dell’attività Stripe sta aggiornando i requisiti di verifica delle attività commerciali per le persone giuridiche in Brasile al fine di conformarsi alle normative antiriciclaggio della Banca Centrale del Brasile (BCB). Questo tipo di verifica rientra nella categoria generale dei requisiti “verifica dell’attività” (KYB). Se i tuoi conti connessi includono aziende costituite in Brasile, potrebbe essere necessario fornire ulteriori informazioni durante la procedura di attivazione. Stripe verifica le persone giuridiche utilizzando il CNPJ (Cadastro Nacional da Pessoa Jurídica), il numero di registrazione nazionale delle società brasiliane, insieme alla ragione sociale e alla sede legale. Stripe effettua innanzitutto una verifica automatica confrontando i dati con il registro CNPJ del governo brasiliano. Se le informazioni inserite non corrispondono, il conto può risolvere il problema caricando un documento di verifica della società (come un certificato CNPJ rilasciato dalla Receita Federal). Oltre alla verifica dell’identità, la normativa brasiliana in materia di antiriciclaggio richiede a Stripe di valutare la capacità finanziaria di un conto connesso prima di abilitare addebiti e bonifici. Tutti i conti brasiliani devono fornire la stima dei ricavi o del reddito mensile prima che le funzionalità vengano attivate. Queste informazioni sono solo a scopo di monitoraggio normativo e non le verifichiamo in modo indipendente al momento dell’attivazione. ### Campi obbligatori I seguenti campi sono obbligatori per i conti delle persone giuridiche brasiliane: | Campo | Descrizione | | ----------------------------------------------------- | ------------------------------------------------------------------------------------- | | `company.tax_id` | CNPJ (numero di registrazione aziendale brasiliano a 14 cifre). | | `company.name` | Ragione sociale legale: deve corrispondere al registro CNPJ. | | `company.address.line1`, `.city`, `.postal_code` | Indirizzo aziendale registrato in Brasile. | | `company.verification.document` | Opzionale inizialmente, obbligatorio se la verifica programmatica non va a buon fine. | | `business_profile.monthly_estimated_revenue.amount` | Ricavi lordi mensili in BRL. | | `business_profile.monthly_estimated_revenue.currency` | Deve essere `brl`. | ### Risposta ai requisiti iniziali ```json { "currently_due": [ "company.tax_id", "company.name", "company.address.line1", "company.address.city", "company.address.postal_code", "business_profile.monthly_estimated_revenue.amount", "business_profile.monthly_estimated_revenue.currency" ], "pending_verification": [], "alternatives": [ { "original_fields_due": [ "company.tax_id", "company.name", "company.address.line1", "company.address.city", "company.address.postal_code" ], "alternative_fields_due": [ "company.tax_id", "company.name", "company.address.line1", "company.address.city", "company.address.postal_code", "company.verification.document" ] } ], "errors": [] } ``` L’array `alternatives` indica che, se la verifica programmatica del CNPJ non va a buon fine, la piattaforma può risolvere il problema fornendo anche un `company.verification.document`. ### Raccolta dei dati aziendali ```shell curl https://api.stripe.com/v1/accounts/{{CONNECTED_ACCOUNT_ID}} \ -u "{{PLATFORM_SECRET_KEY}}:" \ -d "company[tax_id]=12.345.678/0001-99" \ -d "company[name]=Empresa Exemplo Ltda" \ -d "company[address][line1]=Avenida Paulista, 1000" \ -d "company[address][city]=São Paulo" \ -d "company[address][postal_code]=01310-100" \ -d "company[address][country]=BR" \ -d "business_profile[monthly_estimated_revenue][amount]=5000000" \ -d "business_profile[monthly_estimated_revenue][currency]=brl" ``` Dopo aver inviato l’ID fiscale, il nome e l’indirizzo dell’azienda, i requisiti passano a `pending_verification` mentre Stripe verifica il registro CNPJ: ```json { "currently_due": [], "pending_verification": [ "company.tax_id", "company.name", "company.address.line1", "company.address.city", "company.address.postal_code" ], "alternatives": [], "errors": [] } ``` Attendere un webhook `account.updated` prima di procedere. Se la verifica ha esito positivo, tutti i campi vengono cancellati dai requisiti. Se la verifica non va a buon fine, consulta la sezione relativa alla gestione degli errori di seguito. ### Stato della registrazione dell’ID fiscale Oltre a verificare il CNPJ rispetto ai registri aziendali, Stripe controlla lo stato di registrazione del CNPJ (e del CPF del rappresentante aziendale) rispetto ai registri del governo brasiliano. Non è possibile modificare l’ID fiscale dopo averlo impostato. | Tipo di persona giuridica | Approvato | Errore | È necessaria la disattivazione immediata | | ------------------------- | ----------------------------------------------------------------- | -------------------------------------- | --------------------------------------------------------------------------------------------- | | Persone fisiche (CPF) | Regolare | Sospeso, in attesa di regolarizzazione | Annullato, nullo, deceduto | | Persone giuridiche (CNPJ) | Attiva (Ativa), In attesa di regolarizzazione (Ativa não regular) | Sospesa (Suspensa) | Sciolta (Baixada), Cancellata (Baixada), Inidonea (Inapta), Nulla (Nula), Con sede all’estero | I conti con un CPF o un CNPJ sospeso vengono considerati validi al momento dell’attivazione, ma devono risolvere il loro stato entro circa 30 giorni. Se non risolto, limiteremo le funzionalità di pagamento. I conti con stati che richiedono la disattivazione (cancellato, nullo, deceduto, sciolto, inidoneo) hanno tutte le funzionalità disabilitate immediatamente e non possono essere ripristinati tramite il caricamento di documenti. ### Capacità finanziaria La normativa brasiliana in materia di antiriciclaggio impone a Stripe di raccogliere la capacità finanziaria stimata di un conto connesso prima di abilitare addebiti e bonifici. Ciò si applica a tutti i conti brasiliani, sia di persone fisiche che di persone giuridiche. `monthly_estimated_revenue.amount` è espresso nella più piccola unità monetaria (centavos). Ad esempio, 50.000 BRL = `5000000`. Raccogliamo i valori solo a fini di monitoraggio normativo e non li verifichiamo in modo indipendente al momento dell’attivazione. ### URL e descrizione del prodotto Le normative brasiliane richiedono a Stripe di comprendere le attività di tutte le aziende. I requisiti variano a seconda del tipo di conto: | Tipo di conto | Requisiti | | ------------------------- | ------------------------------------------------------------------------------ | | Diretto e standard | Richiede sia `business_profile.url` che `business_profile.product_description` | | Personalizzato ed Express | Richiede `business_profile.url` o `business_profile.product_description` | ### Gestione degli errori | Codice di errore | Trigger | Rimedio | | ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `verification_failed_keyed_match` | CNPJ non trovato, oppure la ragione sociale o l’indirizzo non corrispondono al registro CNPJ. | Reinserire la ragione sociale e l’indirizzo registrato corretti oppure caricare `company.verification.document`. | | `verification_failed_id_number_status_not_found` | CNPJ trovato ma impossibile recuperare lo stato fiscale. | Invia nuovamente o carica un documento di verifica dell’azienda. | | `verification_failed_id_number_inactive` | CNPJ trovato ma lo stato è inattivo (ad esempio, sospeso, sciolto). | Per lo stato “sospeso”, l’account dispone di un periodo di grazia per risolvere la questione con la Receita Federal. Per gli stati “sciolto”, “annullato”, “inidoneo” o “nullo”, il conto verrà disattivato: non è possibile risolvere la questione tramite il caricamento di documenti. | | `verification_document_type_not_supported` | Il documento aziendale caricato è illeggibile o di tipo errato. | Carica nuovamente un documento di verifica aziendale valido. | | `verification_document_name_mismatch` | La ragione sociale riportata nel documento non corrisponde a quello inserito. | Inserisci nuovamente la ragione sociale esattamente come appare sul certificato CNPJ. | | `verification_document_id_number_mismatch` | L’ID fiscale nel documento non corrisponde al CNPJ inserito, oppure lo stato dell’ID fiscale non è stato trovato o è inattivo. | Carica nuovamente un certificato CNPJ aggiornato rilasciato dalla Receita Federal. | | `verification_document_address_mismatch` | L’indirizzo nel documento non corrisponde all’indirizzo inserito. | Reinserisci l’indirizzo in modo che corrisponda a quello registrato sul certificato CNPJ. | ## Verifica dell’UBO e delle relazioni La normativa brasiliana in materia di antiriciclaggio (Circolare BCB 3978/20) richiede che tutti i rappresentanti aziendali siano identificati e verificati come rappresentanti legalmente registrati dell’entità. Stripe verifica questo aspetto in due fasi: 1. **Corrispondenza programmatica dei nomi**: il nome completo del rappresentante viene confrontato con la risposta del registro CNPJ. 1. **Procedura alternativa, revisione dei documenti**: se la verifica programmatica non va a buon fine, il rappresentante deve caricare un documento idoneo che attesti il rapporto con l’azienda (per strutture proprietarie semplici) oppure un’attestazione (per strutture proprietarie complesse). > Una struttura proprietaria semplice esiste quando l’attività è posseduta direttamente da una o più persone fisiche, mentre una struttura proprietaria complessa prevede livelli intermedi, come holding, trust o società controllate, che separano i titolari effettivi finali dall’azienda operativa. ### Documenti accettati per verificare il rapporto (per strutture proprietarie semplici) Puoi trovare i documenti accettabili per il Brasile alla pagina [Documenti di verifica accettabili](https://docs.stripe.com/acceptable-verification-documents.md?country=BR&document-type=entity#select-a-country-to-view-its-requirements). I documenti devono contenere: (a) il nome della persona giuridica e il CNPJ, (b) una nomina espressa a titolare o membro del consiglio di amministrazione con il nome completo della persona e il CPF, con un mandato valido, e © la firma del rappresentante dell’azienda. Le piattaforme possono caricare documenti di verifica al posto dei conti connessi solo dopo aver ricevuto il consenso scritto del conto connesso, firmato da un rappresentante legale con poteri espressi di agire per suo conto. La piattaforma deve inoltre inviare una procura oppure un atto costitutivo che dimostri tali poteri. ### Attestazione (per strutture proprietarie complesse) Le aziende con una struttura proprietaria complessa devono scaricare e compilare un documento PDF di attestazione, quindi ricaricarlo su Stripe. ## Test Utilizza la [modalità di test](https://docs.stripe.com/connect/testing.md) per verificare che la tua integrazione gestisca tutti gli stati di adeguata verifica della clientela e di adeguata verifica dell’attività. ### Test: adeguata verifica della clientela riuscita (persona fisica) ```shell # Create test account curl https://api.stripe.com/v1/accounts \ -u "{{TEST_SECRET_KEY}}:" \ -H "Stripe-Version: 2026-03-25.dahlia;experimental_onboarding_preview=v2" \ -d "type=custom" \ -d "country=BR" \ -d "capabilities[transfers][requested]=true" # Submit person data (use test CPF: 000.000.001-91 for success) curl https://api.stripe.com/v1/accounts/{{ACCT_ID}}/persons/{{PERSON_ID}} \ -u "{{TEST_SECRET_KEY}}:" \ -d "first_name=Maria" \ -d "last_name=Silva" \ -d "id_number=000.000.001-91" \ -d "dob[day]=15" \ -d "dob[month]=6" \ -d "dob[year]=1985" \ -d "address[line1]=Rua das Flores, 123" \ -d "address[city]=São Paulo" \ -d "address[state]=SP" \ -d "address[postal_code]=01310-100" \ -d "address[country]=BR" ``` Per completare il test di esito positivo di adeguata verifica della clientela, è ancora richiesto `proof_of_liveness`. Vedi [Gestire i requisiti di presenza](https://docs.stripe.com/connect/api-onboarding.md?accounts-namespace=v1&liveness=hosted#proof-of-liveness) per maggiori dettagli. ### Test: CPF inattivo (`verification_document_id_number_mismatch`) ```shell curl https://api.stripe.com/v1/accounts/{{ACCT_ID}}/persons/{{PERSON_ID}} \ -u "{{TEST_SECRET_KEY}}:" \ -d "id_number=000.000.002-00" ``` Errore previsto nei requisiti: ```json { "code": "verification_document_id_number_mismatch", "reason": "", "requirement": "person.id_number" } ``` ### Test: adeguata verifica dell’attività (persona giuridica) completata con successo ```shell # Create test company account curl https://api.stripe.com/v1/accounts \ -u "{{TEST_SECRET_KEY}}:" \ -H "Stripe-Version: 2026-03-25.dahlia;experimental_onboarding_preview=v2" \ -d "type=custom" \ -d "country=BR" \ -d "business_type=company" \ -d "capabilities[transfers][requested]=true" # Submit company data (use test CNPJ: 00.000.000/0001-91 for success) curl https://api.stripe.com/v1/accounts/{{ACCT_ID}} \ -u "{{TEST_SECRET_KEY}}:" \ -d "company[tax_id]=00.000.000/0001-91" \ -d "company[name]=Empresa Teste Ltda" \ -d "company[address][line1]=Avenida Paulista, 1000" \ -d "company[address][city]=São Paulo" \ -d "company[address][postal_code]=01310-100" \ -d "company[address][country]=BR" \ -d "business_profile[monthly_estimated_revenue][amount]=5000000" \ -d "business_profile[monthly_estimated_revenue][currency]=brl" ``` ### Test: errore di corrispondenza con chiave CNPJ (`verification_failed_keyed_match`) ```shell curl https://api.stripe.com/v1/accounts/{{ACCT_ID}} \ -u "{{TEST_SECRET_KEY}}:" \ -d "company[tax_id]=00.000.000/0002-00" \ -d "company[name]=Wrong Name Ltda" ``` Errori previsti nei requisiti: ```json [ { "code": "verification_failed_keyed_match", "requirement": "company.tax_id" }, { "code": "verification_failed_keyed_match", "requirement": "company.name" }, { "code": "verification_failed_keyed_match", "requirement": "company.address.line1" } ] ``` Risolvi il problema caricando un documento di verifica dell’azienda: ```shell # 1. Upload CNPJ certificate PDF curl https://files.stripe.com/v1/files \ -u "{{TEST_SECRET_KEY}}:" \ -F "file=@/path/to/cnpj_certificate.pdf" \ -F "purpose=account_requirement" # 2. Attach to account curl https://api.stripe.com/v1/accounts/{{ACCT_ID}} \ -u "{{TEST_SECRET_KEY}}:" \ -d "company[verification][document][front]={{FILE_ID}}" ``` #### Programma - US *Ultimo aggiornamento: 23 settembre 2025* ## Cosa sta cambiando - **Informazioni obbligatorie raccolte dagli account connessi:** stiamo aggiornando le informazioni che richiediamo alle ditte individuali, alle organizzazioni non profit e alle LLC unipersonali, e semplifichiamo il modo in cui otteniamo il consenso del tutore legale per gli account aperti da minori. Inoltre, ora è necessaria un’email del rappresentante dell’account per tutti i tipi di persone giuridiche e una modifica per gli enti governativi e le società per azioni. - **Come verifichiamo le informazioni sull’attività e forniamo nuove risposte dettagliate per la verifica:** stiamo aggiornando i nostri criteri per le informazioni sull’attività e introducendo nuovi codici d’errore della verifica quando non siamo in grado di accettare o verificare le informazioni fornite. - **Soglia di verifica dei numeri di identificazione fiscale (TIN):** per gli account connessi Custom ed Express, stiamo abbassando la soglia del volume dei pagamenti per cui verifichiamo i pagamenti, per allinearci alle attuali soglie di reportistica fiscale federale. - **Come precompiliamo le voci per gli estratti conto e i prefissi delle voci:** se una voce sull’estratto conto non viene specificata, attualmente viene utilizzato il nome del profilo dell’attività, l’URL dell’attività o il nome della persona giuridica dell’account connesso. Queste modifiche interessano tutti gli utenti che hanno richiesto la funzionalità [card_payments](https://docs.stripe.com/api/accounts/object.md#account_object-capabilities-card_payments) negli USA. ## Informazioni obbligatorie ottenute dagli account connessi Nuove informazioni acquisite e nuovi campi aggiunti all’API: - Le attività che sono [company.structure](https://docs.stripe.com/api/accounts/create.md#create_account-company-structure) di `sole_proprietorship` e `single_member_llc` devono fornire l’indirizzo dell’attività (“indirizzo aziendale”). Nel caso in cui l’indirizzo dell’attività coincida con l’indirizzo personale del rappresentante, gli account connessi possono fornire gli stessi valori per entrambi. - Le persone giuridiche che sono [company.structure](https://docs.stripe.com/api/accounts/create.md#create_account-company-structure) di `government_instrumentality`, `tax_exempt_government_instrumentality`, `governmental_unit`, `public_company`, `public_corporation`, e `public_partnership` devono fornire un’email del rappresentante dell’account. Ora questo requisito si applica a tutti i tipi di persone giuridiche. - Per semplificare il modo in cui otteniamo il consenso di un tutore legale per gli account aperti da minori, l’[API Persons](https://docs.stripe.com/api/persons.md) è stata aggiornata con un nuovo tipo di relazione `legal_guardian`, nonché un campo `additional_tos_acceptances` per registrare il consenso del tutore legale ai termini di servizio di Stripe. Se la data di nascita del rappresentante dell’account indica che la persona fisica è minorenne, viene attivato un requisito dell’account per aggiungere un `legal_guardian` prima che l’account possa essere attivato. ## In che modo verifichiamo le informazioni sull’attività e forniamo nuove risposte dettagliate per le verifiche. ### Aggiornamenti alle informazioni già acquisite Richiederemo ai tuoi account connessi le seguenti informazioni: | Campo | Requisiti aggiornati | Considerazioni aggiuntive | | ------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------- | | SSN o ITIN richiesto ai rappresentanti residenti negli USA | Ultime 4 cifre richieste durante l’attivazione per tutti i tipi di account (inclusi gli account connessi Custom ed Express) | Questo è il comportamento attuale degli account connessi standard | | SSN o ITIN attenuti dai titolari residenti negli USA | Ultime quattro cifre richieste quando il volume dei pagamenti supera i 500.000 USD per tutti i tipi di account (inclusi gli account connessi Custom ed Express) | Vedere *Nota completa SSNa 9 cifre* di seguito | | Documento di identità o di verifica nazionale raccolto da rappresentanti non residenti negli USA | Documento di identità o di verifica nazionale all’attivazione di tutti i tipi di account (inclusi gli account connessi Custom ed Express) | Si applica solo ai rappresentanti non residenti negli USA | | Documento di identità o di verifica nazionale acquisito da titolari non residenti negli USA | Documento di identità o di verifica nazionale quando il volume dei pagamenti supera i 500.000 USD per tutti i tipi di account (inclusi gli account connessi Custom ed Express). | Si applica solo ai titolari non residenti negli USA | > Se, utilizzando le informazioni già fornite, non riusciamo a ottenere tramite codice il numero SSN completo di nove cifre di una persona fisica associata al tuo account, devi fornire tutte le nove cifre. ### Nuovi codici d’errore per la verifica Se non siamo in grado di verificare le informazioni fornite dai tuoi account connessi, le risposte di verifica dettagliate visualizzeranno i relativi codici d’errore nell’oggetto [requirements.errors](https://docs.stripe.com/api/accounts/object.md#account_object-requirements-errors). [Consulta la documentazione](https://docs.stripe.com/connect/handling-api-verification.md#validation-and-verification-errors). #### Errori sincroni | Campo | Nuovo codice d’errore | Messaggio d’errore | | ---------------------------------------- | ------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------- | | Descrizione del prodotto | `invalid_product_description_length` | La descrizione del prodotto deve contenere almeno 10 caratteri. | | Descrizione del prodotto | `invalid_product_description_url_match` | La descrizione del prodotto deve essere diversa dall’URL. | | Voce sull’estratto conto (completa) | `invalid_statement_descriptor_length` | La voce sull’estratto conto deve contenere da 5 a 22 caratteri. | | Voce sull’estratto conto (completa) | `invalid_statement_descriptor_business_mismatch` | La voce sull’estratto conto deve essere simile al nome dell’attività, al nome della persona giuridica o all’URL. | | Voce sull’estratto conto (completa) | `invalid_statement_descriptor_denylisted` | Le voci per gli estratti conto generiche o note non sono supportate. | | Voce per gli estratti conto (breve) | `invalid_statement_descriptor_prefix_mismatch` | Il prefisso della voce per gli estratti conto deve essere simile alla voce stessa, alla ragione sociale, al nome della persona giuridica o all’URL. | | Voce per gli estratti conto (breve) | `invalid_statement_descriptor_prefix_denylisted` | I prefissi delle voci per gli estratti conto, generici o noti, non sono supportati. | | Ragione sociale LE | `invalid_company_name_denylisted` | Le ragioni sociali generiche o note non sono supportate. | | Nome profilo attività (nome commerciale) | `invalid_business_profile_name_denylisted` | Le ragioni sociali generiche o note non sono supportate. | | Nome profilo attività (nome commerciale) | `invalid_business_profile_name` | I nomi dei profili delle attività devono contenere parole riconoscibili. | | Data di nascita delle persone | `invalid_dob_age_under_minimum` | La persona deve avere almeno 13 anni. | | Data di nascita delle persone | `invalid_dob_age_over_maximum` | La data di nascita deve risalire agli ultimi 120 anni. | | Telefono delle persone | `invalid_phone_number` | Il numero di telefono non sembra essere valido. Assicurati che il formato sia corretto. | | Telefono dell’attività LE | `invalid_phone_number` | Il numero di telefono non sembra essere valido. Assicurati che il formato sia corretto. | | Codice fiscale dell’azienda | `invalid_tax_id_format` | I codici fiscali devono essere costituiti da una sequenza univoca di 9 numeri senza trattini o altri caratteri speciali. | | URL | `invalid_url_format` | Formattare come https://example.com | | URL | `invalid_url_denylisted` | Gli URL generici delle attività non sono supportati. | #### Errori asincroni | Campo | Nuovo codice d’errore | Messaggio d’errore | | ----- | --------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | | URL | `invalid_url_website_inaccessible` | Impossibile raggiungere l’URL. Assicurati che sia disponibile e inserito in modo corretto, oppure forniscine un altro. | | URL | `invalid_url_website_business_information_mismatch` | Le informazioni sull’attività presenti sul tuo sito web non corrispondono ai dettagli che hai fornito a Stripe. | | URL | `invalid_url_website_incomplete` | Sembra che nel tuo sito web manchino alcune informazioni obbligatorie. Leggi ulteriori informazioni sui requisiti del sito web | | URL | `invalid_url_website_other` | Non è stato possibile verificare l’attività utilizzando l’URL fornito. Assicurati che sia stato inserito correttamente, oppure fornisci un altro URL. | | URL | `invalid_url_web_presence_detected` | Dato che utilizzi un sito web, un’app, una pagina di social media o un profilo online per vendere prodotti o servizi, devi fornire un URL per la tua attività. | ### Aggiornamento della soglia in base per la verifica dei numeri di identificazione fiscale (TIN) Per allinearci alle soglie di reportistica dell’IRS per i moduli 1099-K, 1099-NEC e 1099-MISC, stiamo aggiornando la soglia alla quale verifichiamo il TIN quando il volume dei pagamenti raggiunge i 600 USD o entro 30 giorni dal primo addebito, a seconda dell’evento che si verifica per primo. ### In che modo precompiliamo le voci degli estratti conto e i relativi prefissi Se non si specifica, la voce sull’estratto conto viene precompilata utilizzando i seguenti campi (nell’ordine): [business_profile.name](https://docs.stripe.com/api/accounts/object.md#account_object-business_profile-name) (“nome commerciale dell’attività”), [business_profile.url](https://docs.stripe.com/api/accounts/object.md#account_object-business_profile-url), nome della persona giuridica ([individual.first_name](https://docs.stripe.com/api/accounts/object.md#account_object-individual-first_name) + [individual.last_name](https://docs.stripe.com/api/accounts/object.md#account_object-individual-last_name) o [company.name](https://docs.stripe.com/api/accounts/object.md#account_object-company-name))`. Inoltre, se non viene fornito il prefisso della voce per gli estratti conto, questo viene precompilato dai primi 10 caratteri della voce sull’estratto conto. #### Programma - Singapore *Ultimo aggiornamento: 21 maggio 2025* ## Raccomandazioni sull’integrazione Le modifiche all’integrazione che devi apportare dipendono dal modo in cui raccogli le informazioni di attivazione dai tuoi account connessi. Devi anche prevedere l’aggiornamento della documentazione interna ed esterna sui requisiti di verifica e formare i team di assistenza per rispondere a qualsiasi domanda dei tuoi utenti. > Stripe consiglia vivamente di utilizzare [l’attivazione ospitata da Stripe](https://docs.stripe.com/connect/hosted-onboarding.md) o [l’attivazione incorporata](https://docs.stripe.com/connect/embedded-onboarding.md) per gestire la raccolta delle informazioni aziendali e di verifica dell’identità. L’attivazione ospitata da Stripe e quella incorporata offrono un’esperienza guidata con informazioni aggiuntive sui titolari effettivi e sui direttori, che attualmente non sono disponibili nell’API. Queste informazioni vengono recuperate dai database governativi e riducono le informazioni di verifica raccolte dagli account connessi. ### Panoramica dell’integrazione A partire da metà marzo, l’hash [future_requirements](https://docs.stripe.com/api/accounts/object.md#account_object-future_requirements) ti consentirà di visualizzare in anteprima i nuovi requisiti necessari a breve e la relativa scadenza per i tuoi account connessi. Per evitare l’interruzione delle funzionalità dei tuoi account connessi, pianifica l’acquisizione delle informazioni aggiornate prima della data `current_deadline`. I nuovi account connessi Custom creati a partire dall’aprile 2025 dovranno soddisfare anche i nuovi requisiti di verifica. Rileva i cambiamenti di stato dell’account ascoltando l’evento account.updated. Per ulteriori informazioni sulle tempistiche, consulta la nostra [pagina delle domande frequenti](https://support.stripe.com/questions/singapore-verification-requirements-for-custom-connected-accounts-faq). Assicurati che la tua integrazione sia configurata per [gestire gli aggiornamenti](https://docs.stripe.com/connect/handle-verification-updates.md) all’attivazione dei nuovi account e la raccolta di informazioni aggiornate dagli account esistenti. Nello specifico, per i flussi di attivazione integrati o in hosting su Stripe, puoi personalizzare il comportamento per raccogliere in anticipo, facoltativamente, i [future_requirements](https://docs.stripe.com/api/accounts/object.md#account_object-future_requirements). Per l’attivazione in hosting su Stripe, imposta il parametro `collection_options.future_requirements` da `include` quando [crei un account Link](https://docs.stripe.com/api/account_links/create.md#create_account_link-collection_options). Per l’attivazione integrata, imposta il campo futureRequirements dell’attributo [`collectionOptions`](https://docs.stripe.com/connect/supported-embedded-components/account-onboarding.md#requirements-collection-options) da `include`. ### Panoramica dei requisiti | Tipo di entità | Verifica dei beneficiari effettivi finali (UBO) | Raccolta dei dati sulla dirigenza | Prova di autorità (PoA) | Lettera di autorizzazione | | -------------------- | ------------------------------------------------------------------------------------------------------------------------------ | --------------------------------- | ----------------------- | ---------------------------------------- | | Persone fisiche | Non applicabile | Non applicabile | Non applicabile | Non applicabile | | Ditte individuali | Non applicabile | Non applicabile | Si applica sempre | Non applicabile | | Aziende private | Obbligatorio per i titolari con almeno il 25% della proprietà* Può essere esentata | Si applica sempre | Si applica sempre | Alternativa se il PoA non va a buon fine | | Partnership | Obbligatorio per tutti i soci e manager e qualsiasi altra persona fisica con almeno il 25% di proprietà Può essere esentata | Non applicabile | Si applica sempre | Alternativa se il PoA non va a buon fine | | Enti governativi** | Non applicabile | Non applicabile | Si applica sempre | Si applica sempre | | Società per azioni** | Esente | Si applica sempre | Si applica sempre | Alternativa se il PoA non va a buon fine | | Non-profit | Tutti i membri del consiglio di amministrazione e i dirigenti chiave Può essere esentata | Non applicabile | Si applica sempre*** | Alternativa se il PoA non va a buon fine | > Nei casi in cui non ci sono titolari con almeno il 25% di proprietà, tutti i membri del consiglio di amministrazione sono trattati come UBO. > > \** Gli enti governativi e le società per azioni sono nuovi tipi di entità di Singapore. Contatta l’[assistenza Stripe](https://support.stripe.com/) per richiedere l’accesso. > > \*** Le organizzazioni non profit non elencate su charities.gov.sg devono caricare un documento di [proof_of_ultimate_beneficial_ownership](https://docs.stripe.com/api/accounts/update.md#update_account-documents-proof_of_ultimate_beneficial_ownership) per indicare tutti i membri del consiglio di amministrazione e i dirigenti principali. ## Tipi di attività e strutture supportate. I requisiti di verifica variano a seconda del tipo di business. Per il tipo di business `company` è possibile classificare ulteriormente l’attività dell’utente identificando la sua struttura giuridica (societaria). Per una struttura commerciale vengono descritti i dettagli dell’entità commerciale come operazioni quotidiane, oneri fiscali, responsabilità e struttura organizzativa. Puoi classificarla utilizzando il campo [company.structure](https://docs.stripe.com/api/accounts/create.md#create_account-company-structure) nell’oggetto Account. Un’azienda è considerata privata per impostazione predefinita se non vengono fornite informazioni su [company.structure](https://docs.stripe.com/api/accounts/create.md#create_account-company-structure). In conformità alle linee guida di Singapore, tutti i tipi di azienda devono essere registrati su [ACRA](https://www.acra.gov.sg/). Queste sono le mappature suggerite per passare dalla classificazione solo per `business_type` a [business_type](https://docs.stripe.com/api/accounts/object.md#account_object-business_type) e [company.structure](https://docs.stripe.com/api/accounts/create.md#create_account-company-structure). | Tipo di attività esistente | Combinazione di nuovo tipo di business e struttura aziendale | Descrizione | | -------------------------- | ------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `individual` | tipo: `individual`, struttura: `nil` | Persona singola che svolge un’attività commerciale, ma non opera nell’ambito di una struttura societaria. | | `sole_prop` | tipo: `company`, struttura: `sole_proprietorship` | Attività non costituita in società, di proprietà di una persona fisica. L’attività è registrata come ditta individuale presso l’[ACRA](https://www.acra.gov.sg/how-to-guides/before-you-start/choosing-a-business-structure). | | `company` / `corporation` | tipo: `company`, struttura: `private_company` | Associazione o relazione tra due o più persone fisiche, società, fiduciarie o partnership che si uniscono per svolgere un commercio o un’attività. L’attività è registrata come azienda nell’[ACRA](https://www.acra.gov.sg/how-to-guides/before-you-start/choosing-a-business-structure), comprese le società a responsabilità limitata per garanzia. | | `partnership` | tipo: `company`, struttura: `private_partnership` | Associazione o relazione tra due o più persone fisiche, società, fiduciarie o partnership che si uniscono per svolgere un commercio o un’attività. L’attività è registrata come azienda nell’[ACRA](https://www.acra.gov.sg/how-to-guides/before-you-start/choosing-a-business-structure). | | `public_company` | tipo: `company`, struttura: `public_company` | Azienda che offre i propri titoli in vendita al pubblico. La struttura di questa attività è con limitazioni. Per informazioni sull’utilizzo, contatta l’[assistenza Stripe](https://support.stripe.com/). L’attività è registrata come azienda su [ACRA](https://www.acra.gov.sg/how-to-guides/before-you-start/choosing-a-business-structure). | | `non_profit` | tipo: `non_profit`, struttura: `nil` | Organizzazione che opera per uno scopo diverso dalla produzione di profitti, spesso con l’obiettivo di promuovere scopi sociali, educativi, benefici o di altra natura. | > Se l’attività è una organizzazione non profit registrata su ACRA, si applicano i requisiti per il tipo di business registrato su ACRA. ## Verifica del rappresentante dell’attività ### Verifica avanzata dell’identità A Singapore, è necessaria la verifica avanzata dell’identità dei rappresentanti per tutti i tipi di attività utilizzando [Singpass MyInfo](https://www.singpass.gov.sg/main/individuals/), un fornitore di identità digitale molto diffuso. Se gli utenti non hanno accesso a MyInfo, devono verificare la validità utilizzando [Stripe Identity](https://docs.stripe.com/identity.md). Per completare correttamente la verifica avanzata dell’identità utilizzando SingPass MyInfo o Stripe Identity è necessaria l’integrazione con l’[attivazione Connect o l’attivazione integrata](https://docs.stripe.com/connect/custom/onboarding.md). Se utilizzi l’API Stripe per aggiungere gli account connessi, devi aggiornare i moduli per raccogliere le nuove informazioni di verifica richieste agli utenti e reindirizzarli all’attivazione Connect nella fase finale per completare la verifica avanzata dell’identità. ### Verifica dell’indirizzo La verifica dell’indirizzo del rappresentante dell’attività è obbligatoria per tutte le attività. Se Stripe non è in grado di verificare l’indirizzo, devi raccogliere un [documento che attesti](https://docs.stripe.com/acceptable-verification-documents.md?country=SG&document-type=address) l’indirizzo. ## Prova di verifica dell’autorità Stripe deve verificare che il [rappresentante dell’account abbia l’autorità sufficiente](https://support.stripe.com/questions/representative-authority-verification) per aprire un conto a nome della persona giuridica. Se non è possibile eseguire la verifica tramite codice, devi sostituirlo con una persona con l’autorità sufficiente. Se una persona con autorità sufficiente non può essere il rappresentante dell’attività, puoi aggiungerla come persona con compiti di [autorizzazione](https://docs.stripe.com/api/persons/update.md#update_person-relationship-authorizer). L’attività deve quindi fornire una [lettera di autorizzazione](https://b.stripecdn.com/content/Letter_of_authorization_for_Stripe_Singapore.pdf) firmata da una [persona con poteri di autorizzazione](https://docs.stripe.com/api/persons/update.md#update_person-relationship-authorizer), che consenta al rappresentante dell’attività di gestire l’account. Deve essere fornita come [company_authorization](https://docs.stripe.com/api/persons/update.md#update_person-documents-company_authorization) del rappresentante. All’account devi aggiungere il [nome](https://docs.stripe.com/api/persons/object.md#person_object-first_name) e il [cognome](https://docs.stripe.com/api/persons/object.md#person_object-last_name) della persona che autorizza, insieme a una copia del suo [documento di identità](https://docs.stripe.com/api/persons/update.md#update_person-verification-document). > Al momento Stripe accetta solo il modello di [lettera di autorizzazione](https://b.stripecdn.com/content/Letter_of_authorization_for_Stripe_Singapore.pdf) fornito. ``` { "id": ""{{CONNECTED_ACCOUNT_ID}}"", "future_requirements": { "past_due": [ "authorizer.first_name", "authorizer.last_name", "authorizer.id_document", "{{REPRESENTATIVE_ID}}.documents.company_authorization.files" ], "alternatives": [ { "original_fields_due": [ "authorizer.first_name", "authorizer.last_name", "authorizer.id_document", "{{REPRESENTATIVE_ID}}.documents.company_authorization.files" ], "alternative_fields_due": [ "{{REPRESENTATIVE_ID}}.first_name", "{{REPRESENTATIVE_ID}}.last_name", "{{REPRESENTATIVE_ID}}.id_number" ] } ], "errors": [ { "code": "verification_failed_representative_authority", "requirement": "authorizer.first_name", "reason": "..." }, { "code": "verification_failed_representative_authority", "requirement": "authorizer.last_name", "reason": "..." }, ... ], ... }, ... } ``` Inoltre, il requisito della lettera di autorizzazione può evidenziare errori relativi ai documenti, come `verification_document_name_mismatch` o `verification_document_type_not_supported`. Assicurati di essere in grado di gestire gli [errori di verifica dei documenti](https://docs.stripe.com/connect/handling-api-verification.md#handle-document-verification-problems) e i [nuovi codici degli errori di verifica](https://docs.stripe.com/connect/upcoming-requirements-updates.md#new-verification-error-codes). ## Verifica della persona giuridica Per tutte le attività è richiesta la verifica della ragione sociale, dell’UEN e del tipo di persona giuridica. Se Stripe non è in grado di verificare l’esistenza dell’azienda, devi raccogliere un documento dell’azienda. Stripe deve inoltre verificare che il tipo di business e la struttura dell’attività corrispondano ai registri della pubblica amministrazione locale. Quando si verifica una mancata corrispondenza nel [tipo di business](https://docs.stripe.com/api/accounts/object.md#account_object-business_type) o nella [struttura dell’attività](https://docs.stripe.com/api/accounts/object.md#account_object-company-structure), viene generato un errore `verification_legal_entity_structure_mismatch` e il tipo di business o la struttura devono essere aggiornati, oppure sarà necessario un documento dell’azienda per verificare la persona giuridica. ``` { "id": ""{{CONNECTED_ACCOUNT_ID}}"", "future_requirements": { "past_due": [ "company.verification.document" ], "errors": [ { "code": "verification_legal_entity_structure_mismatch", "requirement": "company.verification.document", "reason": "Business type or structure seems to be incorrect. Provide the correct business type and structure for this account." }, ... ], ... }, ... } ``` ## Verifica dei beneficiari effettivi finali ### Determinazione dei titolari in base al tipo di entità #### Aziende private Stripe definisce e tenta di identificare come beneficiario effettivo finale (UBO) qualsiasi persona fisica con almeno il 25% di proprietà. Consigliamo di utilizzare l’[attivazione integrata](https://docs.stripe.com/connect/embedded-onboarding.md) o [in hosting su Stripe](https://docs.stripe.com/connect/hosted-onboarding.md) per consentire agli utenti di visualizzare in anteprima e confermare i titolari. In alternativa, puoi raccogliere e aggiungere all’account tutti gli UBO utilizzando la posizione di [titolare](https://docs.stripe.com/api/persons/object.md) nell’API. Se Stripe non è in grado di determinare queste persone, un’azienda deve presentare un [documento che provi i beneficiari effettivi finali](https://docs.stripe.com/acceptable-verification-documents.md?country=SG&document-type=relationship) per attestare la struttura della proprietà, che deve includere i documenti attestanti la titolarità di eventuali holding che detengono almeno il 25% delle azioni dell’account connesso. L’attivazione integrata o in hosting su Stripe cerca automaticamente di ottenere questi documenti, oppure puoi acquisirli e inviarli utilizzando l’API v1/accounts. Devi aggiungere all’account tutti gli UBO elencati nella prova dei beneficiari effettivi finali. > Gli account connessi possono presentare un’unica [attestazione del beneficiario effettivo finale](https://docs.stripe.com/acceptable-verification-documents.md?country=SG&document-type=relationship) in alternativa a un documento per l’attività e a un altro per ciascuna azienda che detiene una proprietà significativa. > > Se l’azienda non ha titolari con una quota di proprietà pari o superiore al 25%, tutti i membri del consiglio di amministrazione indicati negli archivi governativi (e disponibili per l’anteprima dell’attivazione integrata o in hosting su Stripe) saranno considerati UBO e dovranno essere aggiunti all’account. #### Partnership Le società di persone devono verificare il rapporto tra l’attività e tutti i partner, i dirigenti e qualsiasi altra persona fisica che detiene almeno il 25% della proprietà. Tali persone devono essere aggiunte all’account con la posizione di [titolare](https://docs.stripe.com/api/persons/object.md#person_object-relationship-owner) nell’API. #### Organizzazioni non profit Nel caso delle organizzazioni non profit, tutti i dirigenti e i membri del consiglio di amministrazione chiave sono considerati UBO. Questi includono: - Presidente - Membro del CDA - CEO - Tesoriere - Segretario o segretario generale - Presidente - Trustee - Posizioni aggiunte di recente - E qualsiasi di queste posizioni con funzione di assistente, delegato o vice. Stripe cerca di identificare tutti i membri del consiglio di amministrazione e i dirigenti chiave degli enti di beneficenza registrati a Singapore, che possono essere visualizzati in anteprima e confermati durante l’attivazione in hosting o integrata su Stripe. Tutte le altre organizzazioni non profit devono fornire un [documento di prova del beneficiario effettivo finale](https://docs.stripe.com/acceptable-verification-documents.md?country=SG&document-type=relationship) e le persone fisiche elencate devono essere aggiunte all’account con la posizione di [membro del consiglio di amministrazione](https://docs.stripe.com/api/persons/object.md#person_object-relationship-director) nell’API. ### Dettagli dell’integrazione [Nome](https://docs.stripe.com/api/persons/object.md#person_object-first_name), [cognome](https://docs.stripe.com/api/persons/object.md#person_object-last_name), [numero del documento di identità](https://docs.stripe.com/api/persons/update.md#update_person-id_number) e [pseudonimi](https://docs.stripe.com/api/persons/object.md#person_object-full_name_aliases) di tutte le persone fisiche che possiedono o gestiscono la persona giuridica devono essere aggiunti all’account con la posizione di [titolare](https://docs.stripe.com/api/persons/object.md#person_object-relationship-owner) o [membro del consiglio di amministrazione](https://docs.stripe.com/api/persons/object.md#person_object-relationship-director) nell’API. Gli UBO sono definiti in modo diverso in base al tipo di entità. La verifica dei beneficiari effettivi è obbligatoria per le società private, le partnership private e le organizzazioni non profit. Quando non è possibile verificare l’UBO, devi ottenere un [documento di identità](https://docs.stripe.com/api/persons/update.md#update_person-verification-document) dell’UBO non verificato. ``` { "id": ""{{CONNECTED_ACCOUNT_ID}}"", "future_requirements": { "past_due": [ "{{REPRESENTATIVE_ID}}.verification.document" ], "errors": [ { "code": "verification_failed_keyed_identity", "requirement": "{{REPRESENTATIVE_ID}}.verification.document", "reason": "..." }, ... ], ... }, ... } ``` Se Stripe determina che nell’account mancano titolari, membri del consiglio di amministrazione o documentazione delle holding, il campo `documents.proof_of_ultimate_beneficial_ownership.files` verrà restituito in [future_requirements](https://docs.stripe.com/api/accounts/object.md#account_object-future_requirements). Un elenco completo dei documenti accettabili per Singapore è disponibile alla pagina [Documenti di verifica accettabili](https://docs.stripe.com/acceptable-verification-documents.md?country=SG&document-type=relationship). L’attivazione integrata e in hosting su Stripe mostra un elenco di [beneficiari](https://docs.stripe.com/api/persons/object.md#person_object-relationship-owner) e [dirigenti](https://docs.stripe.com/api/persons/object.md#person_object-relationship-director) mancanti, che consente all’utente di aggiungerli al proprio account facendo clic su di essi. L’aggiunta delle persone fisiche suggerite soddisfa il requisito UBO per le aziende senza holding nella loro struttura della proprietà. Per le aziende con holding, Stripe tenta di verificarne i titolari. In caso contrario, l’utente riceve una richiesta di caricare un [documento di attestazione dei beneficiari finali effettivi](https://docs.stripe.com/acceptable-verification-documents.md?country=SG&document-type=relationship) o [documenti di proprietà](https://docs.stripe.com/acceptable-verification-documents.md?country=SG&document-type=relationship) rilevanti per determinare i beneficiari effettivi finali dell’account. (Questo vale anche per altri tipi di attività, come le organizzazioni non profit). Gli account con beneficiari effettivi mancanti hanno un codice d’errore `verification_missing_owners` nell’hash degli errori di [future_requirements](https://docs.stripe.com/api/accounts/object.md#account_object-future_requirements-errors). Analogamente, gli account con membri del consiglio di amministrazione mancanti hanno un codice d’errore `verification_document_directors_mismatch`. Infine, gli account per cui Stripe richiede ulteriori informazioni sulla titolarità hanno un codice d’errore `verification_requires_additional_proof_of_registration`. ``` { "id": ""{{CONNECTED_ACCOUNT_ID}}"", "future_requirements": { "past_due": [ "documents.proof_of_ultimate_beneficial_ownership.files", ], "errors": [ { "code": "verification_missing_owners", "requirement": "documents.proof_of_ultimate_beneficial_ownership.files", "reason": "..." }, ... ], ... }, ... } ``` ### Esenzioni In determinate situazioni, potrebbe non essere necessario che una persona dichiari la proprietà. Per poter beneficiare di un’esenzione, è necessario fornire un motivo legittimo nel campo [company.ownership_exemption_reason](https://docs.stripe.com/api/accounts/update.md#update_account-company-ownership_exemption_reason). I motivi validi dell’esenzione includono: - `qualified_entity_exceeds_ownership_threshold`: se un governo, un’azienda quotata in borsa o un istituto finanziario possiede almeno il 75% dell’attività, l’attività è esente dal fornire i dettagli sulla proprietà. - `qualifies_as_financial_institution`: le attività che sono istituti finanziari regolamentati dall’[Autorità Monetaria di Singapore](https://eservices.mas.gov.sg/fid/institution?sector=Banking&category=Finance%20Company) sono esenti dalla condivisione dei dati sulla proprietà. ``` { "id": ""{{CONNECTED_ACCOUNT_ID}}"", "future_requirements": { "past_due": [ "documents.proof_of_ultimate_beneficial_ownership.files", ], "alternatives": [ { "original_fields_due": [ "documents.proof_of_ultimate_beneficial_ownership.files", ], "alternative_fields_due": [ "company.ownership_exemption_reason", ] } ], ... }, ... } ``` Dopo avere inviato un motivo di esenzione, esamineremo i dettagli della persona giuridica. Durante la revisione, il requisito verrà spostato su [future_requirements.pending_verification](https://docs.stripe.com/api/accounts/object.md#account_object-future_requirements-pending_verification). Se Stripe determina che la persona giuridica non è idonea per l’esenzione, visualizziamo un messaggio di errore e il requisito di proprietà rimarrà: ``` { "id": ""{{CONNECTED_ACCOUNT_ID}}"", "future_requirements": { "past_due": [ "documents.proof_of_ultimate_beneficial_ownership.files", ], "alternatives": [ { "original_fields_due": [ "documents.proof_of_ultimate_beneficial_ownership.files", ], "alternative_fields_due": [ "company.ownership_exemption_reason", ] } ], "errors": [ { "code": "verification_rejected_ownership_exemption_reason", "reason": "The ownership exemption reason was rejected.", "requirement": "company.ownership_exemption_reason" } ], ... }, ... } ``` ## Raccolta dei dati sulla dirigenza Devi acquisire e inviare il [nome](https://docs.stripe.com/api/persons/object.md#person_object-first_name), il [cognome](https://docs.stripe.com/api/persons/object.md#person_object-last_name), il [numero del documento di identità](https://docs.stripe.com/api/persons/update.md#update_person-id_number) e gli [alias](https://docs.stripe.com/api/persons/object.md#person_object-full_name_aliases) di tutti i [membri del consiglio di amministrazione](https://docs.stripe.com/api/persons/object.md#person_object-relationship-director) elencati nei registri governativi dell’account connesso, per le aziende private, le società quotate in borsa e le organizzazioni non profit. Inoltre, potresti dover attestare che l’elenco dei membri del consiglio di amministrazione è aggiornato e corretto, impostando nell’API i campi `company.directorship_declaration.ip`, `company.directorship_declaration.date` e, facoltativamente, `company.directorship_declaration.user_agent`. Se viene rilevata una discrepanza nell’elenco dei membri del consiglio di amministrazione, Stripe potrebbe richiedere una nuova dichiarazione restituendo i requisiti `company.directorship_declaration.ip`, `company.directorship_declaration.date` nel campo dei requisiti. ## Nuovi codici d’errore per la verifica Se Stripe non è in grado di verificare le informazioni fornite dai tuoi account connessi, includeremo risposte dettagliate per la verifica, come nuovi codici di errore nella matrice [requirements.errors](https://docs.stripe.com/api/accounts/object.md#account_object-requirements-errors) dell’oggetto Accounts. La versione API [2025-03-31](https://docs.stripe.com/upgrades.md#2025-03-31) introduce i codici d’errore riportati di seguito. Le versioni API precedenti ricevono invece `verification_failed_other`. In alternativa, è possibile aggiungere un’intestazione beta all’integrazione API che mostra i nuovi codici d’errore senza modificare la versione API. Per accedere all’intestazione beta, contatta l’[Assistenza Stripe](https://support.stripe.com/). | Codice di errore | Descrizione dell’errore | | -------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `verification_legal_entity_structure_mismatch` | Sembra che il tipo di business o la struttura dell’attività non sia corretto. Fornisci il tipo di business e la struttura dell’attività corretti per questo account. | | `verification_failed_representative_authority` | Non è stato possibile verificare l’autorità del rappresentante dell’account. Aggiungi all’account una persona autorizzata e fornisci una lettera di autorizzazione firmata da chi autorizza. Consulta il nostro articolo di assistenza sulla [verifica dell’autorità](https://support.stripe.com/questions/representative-authority-verification). | | `verification_failed_authorizer_authority` | Non è stato possibile verificare l’autorità dell’autorizzatore che è stato indicato. Sostituisci l’autorizzatore con una persona registrata come rappresentante autorizzato. Leggi l’articolo dell’assistenza sulla [Verifica dell’autorità dei rappresentanti](https://support.stripe.com/questions/representative-authority-verification). | | `verification_rejected_ownership_exemption_reason` | Il motivo dell’esenzione è stato rifiutato. Scegli un altro motivo per l’esenzione o carica un documento che attesti i beneficiari effettivi. | | `information_missing` | Fai riferimento al messaggio d’errore per capire quali informazioni mancavano nel documento o nei dati inseriti. Se si tratta di società capogruppo con una quota di proprietà significativa, il codice d’errore indica anche le società capogruppo mancanti che abbiamo identificato. Per ulteriori informazioni, consulta il nostro articolo sull’assistenza [verifica dei beneficiari effettivi delle holding](https://support.stripe.com/questions/beneficial-ownership-verification-for-holding-companies). | | `verification_missing_owners` | Titolari di attività non specificati. Fornisci le informazioni di tutti i titolari dell’attività o invitali a fornirle personalmente. I titolari che abbiamo identificato come mancanti sono: [Nome1, Nome2]. | | `verification_missing_directors` | Mancano i membri del consiglio di amministrazione nell’account. Aggiorna l’account e carica un documento di registrazione con gli attuali membri del consiglio di amministrazione. | | `verification_document_directors_mismatch` | Mancano i membri del consiglio di amministrazione nell’account. Aggiorna l’account e carica un documento di registrazione con gli attuali membri del consiglio di amministrazione. | ## See also - [Attivazione Connect per gli account Custom](https://docs.stripe.com/connect/custom/hosted-onboarding.md) - [Soluzioni di attivazione per gli account Custom](https://docs.stripe.com/connect/custom/onboarding.md) - [Aggiornamento degli account](https://docs.stripe.com/connect/updating-service-agreements.md) - [Gestire la verifica dell’identità con l’API](https://docs.stripe.com/connect/handling-api-verification.md) - [Test di verifica dell’identità dell’account Custom](https://docs.stripe.com/connect/testing-verification.md)