# 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 beneficiari effettivi (UBO) 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:** membro del consiglio di amministrazione o dirigente senior responsabile della gestione di un’attività (ad esempio, CEO, COO, direttore esecutivo). 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 | Di solito le organizzazioni non profit non hanno UBO | | Ente governativo, organismo governativo, persona fisica, ditta individuale, quotata in borsa | N/A | Solo verifica dell’identità | ### Verifica le informazioni sull’UBO e sul membro del consiglio di amministrazione Stripe cerca di verificare la relazione della persona confrontando le proprietà chiave della persona con le proprietà della persona giuridica. | Entità | Proprietà chiave | | ----------------- | ---------------------------------------------------------------------------- | | Persona | - Nome - Cognome - Numero documento di identità | | 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) A partire dal 2026, applicheremo requisiti più rigorosi per i tipi di account business nei Paesi Bassi, per garantire la conformità alle normative olandesi. Questo influisce particolarmente sulle modalità di raccolta del KvK (Kamer van Koophandel), il numero di registrazione di 8 cifre univoco dell’azienda, richiesto per le attività nei Paesi Bassi. ### Cosa cambierà #### Il tipo di business persona fisica non è più supportato. Il tipo di business `individual` non è più supportato per gli account dei Paesi Bassi. Questo riguarda: account esistenti e nuovi dei Paesi Bassi con `business_type: "individual"` e `business_type: "sole_proprietorship"` **Perché è importante:** nei Paesi Bassi, ogni attività deve fornire un numero KvK (Camera di commercio). Il nostro tipo di business “persona fisica” non acquisisce un KvK e questo lo rende non conforme. #### Nuovo codice d’errore: `unsupported_business_type` Gli account con tipi di business non validi vedono un nuovo errore nei requisiti: ```shell // Account with unsupported business type { "id": "acct_123", "business_type": "individual", "country": "NL", "requirements": { "past_due": ["business_type"], "errors": [{ "requirement": "business_type", "code": "unsupported_business_type", "reason": "Business type isn't supported in merchant country. 'individual' isn't a supported business type in country NL." }] } } ``` #### Raccogliere la registrazione KvK per gli account non costituiti come società Per fornire la registrazione KvK sono necessari account NL nuovi o esistenti con i seguenti tipi di attività e strutture. - `business_type: "company"` e `business_structure: "unincorporated_partnership"` - `business_type: "non_profit"` e `business_structure: "unincorporated_non_profit"` **Perché è importante:** gli account non costituiti come società **attualmente** non sono tenuti a fornire un numero KvK, il che viola i requisiti di conformità olandesi. Tutte le attività nei Paesi Bassi devono fornire la propria registrazione KvK. ### Come risolverlo #### Per gli account esistenti Quando inizieremo a implementare questo nuovo requisito, per rimanere conformi gli account NL esistenti con tipo di business `individual` devono aggiornarsi a `company` con struttura `sole_proprietorship`: ```shell // Update existing account curl -X POST https://api.stripe.com/v1/accounts/acct_123 \ -u sk_test_123: \ -d "business_type=company" \ -d "company[structure]=sole_proprietorship" \ -d "company[tax_id]=12345678" // KvK number // Successful response { "id": "acct_123", "business_type": "company", "company": { "structure": "sole_proprietorship", "tax_id": "12345678" }, "requirements": { "past_due": [], // business_type requirement resolved "errors": [] } } ``` #### Per la creazione di un nuovo account Il tentativo di creare un account olandese con un tipo di business `individual` restituirà l’errore unsupported_business_type. ```shell // This will fail curl -X POST https://api.stripe.com/v1/accounts \ -u sk_test_123: \ -d "country=NL" \ -d "type=custom" \ -d "business_type=individual" // Response { "id": "acct_123", "business_type": "individual", "country": "NL", "requirements": { "past_due": ["business_type"], "errors": [{ "requirement": "business_type", "code": "unsupported_business_type", "reason": "Business type isn't supported in merchant country. 'individual' isn't a supported business type in country NL." }] } // Correct approach curl -X POST https://api.stripe.com/v1/accounts \ -u sk_test_123: \ -d "country=NL" \ -d "type=custom" \ -d "business_type=company" \ -d "company[structure]=sole_proprietorship" ``` ### Strutture di attività supportate per i Paesi Bassi Per gli account dei Paesi Bassi, utilizza queste combinazioni di tipi di attività e strutture: | Tipo di business | Struttura | KvK obbligatorio | | ---------------- | ---------------------------- | ---------------- | | `company` | `sole_proprietorship` | Sì | | `company` | `incorporated_partnership` | Sì | | `company` | `unincorporated_partnership` | Sì | | `company` | `private_corporation` | Sì | | `company` | `public_corporation` | Sì | | `non_profit` | Strutture varie | Sì | ### Impatto sulle funzionalità Le funzionalità degli account con errore `unsupported_business_type` avranno limitazioni fino all’aggiornamento del tipo di business: ```shell { "capabilities": { "card_payments": "inactive", "transfers": "inactive" }, "requirements": { "disabled_reason": "requirements.past_due", "past_due": ["business_type"] } } ``` Gli account che non hanno fornito la registrazione KvK avranno la funzionalità `card_payments` con limitazioni fino a quando non verranno fornite queste informazioni: ```shell { "capabilities": { "card_payments": "inactive" }, "requirements": { "disabled_reason": "requirements.past_due", "past_due": ["company.tax_id"] } } ``` ### Lista di spunta per l’implementazione Piattaforme con account connessi NL: 1. **Verifica gli account esistenti** ```javascript // Find affected accounts const accounts = await stripe.accounts.list({ limit: 100, // Filter for NL accounts in your system }); const affected = accounts.data.filter(a => a.country === 'NL' && a.business_type === 'individual' ); ``` 1. **Aggiorna i flussi di creazione dell’account** - Rimuovi l’opzione `individual` per gli account NL - Il valore predefinito è `company` con `sole_proprietorship` - Raccogli il numero KvK (company.tax_id) 1. **Gestisci il nuovo codice d’errore** ```javascript if (account.requirements.errors.some(e => e.code === 'unsupported_business_type')) { // Prompt user to update business type // Guide them to select appropriate structure // Collect KvK number } ``` 1. **Comunica con gli account connessi interessati** - Spiega perché è necessaria la modifica - Fornisci indicazioni sulla scelta della corretta struttura dell’attività - Aiutali a trovare il loro numero KvK ### Test Collauda la tua implementazione con questi scenari: ```javascript // Test updating to valid business type const updated = await stripe.accounts.update('acct_test_123', { business_type: 'company', company: { structure: 'sole_proprietorship', tax_id: '12345678' // Test KvK } }); ``` ### Considerazioni aggiuntive #### Persone fisiche freelance Nei Paesi Bassi, anche le persone fisiche freelance devono registrarsi come attività (eenmanszaak) e ottenere un numero KvK. Dovrebbero selezionare `company` → `sole_proprietorship`. #### Come trovare il numero KvK per gli account connessi Il numero KvK è indicato sul certificato di registrazione della Camera di commercio (uittreksel Kamer van Koophandel). #### Compatibilità retroattiva Nelle versioni precedenti dell’API, `unsupported_business_type` viene visualizzato come `invalid_value_other` con `detailed_code` contenente l’errore specifico. ## 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 beneficiari effettivi finali (UBO) 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 beneficiario 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 - 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 integrata](https://docs.stripe.com/connect/embedded-onboarding.md) o [in hosting su Stripe](https://docs.stripe.com/connect/hosted-onboarding.md) per gestire la raccolta delle informazioni sull’attività e sulla verifica dell’identità. L’attivazione integrata e in hosting su Stripe fornisce un’esperienza guidata con informazioni aggiuntive su beneficiari effettivi e amministratori, che al momento non sono disponibili nell’API. Queste informazioni vengono recuperate dai database della pubblica amministrazione 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)