Aggiornamenti imminenti dei requisiti

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à.

Le modifiche imminenti riguardano gli account connessi nei seguenti Paesi:

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: Consigliato invia gli account a un flusso in hosting su Stripe per inoltrare le informazioni richieste.
• Attivazione integrata: 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: crea e gestisci un flusso di attivazione personalizzato utilizzando le API di Stripe.

Scopri di più sulle opzioni di attivazione Connect e sulla migrazione dei tuoi flussi di integrazione e risoluzione basati su API a flussi integrati o in hosting su Stripe.

Le modifiche apportate al flusso di attivazione dipendono dal modo in cui raccogli le informazioni per l’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)
• Verifica del beneficiario effettivo (UBO) e della relazione tra i membri del consiglio di amministrazione
• Requisiti di registrazione delle attività olandesi (KvK)
• Nuovi codici di errore

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.

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 e membri del consiglio di amministrazione (per gli account considerati ad alto rischio dal modello di rischio di Stripe)

Metodi di verifica aggiuntivi

Puoi migliorare i tassi di successo della verifica utilizzando i seguenti metodi in aggiunta alle informazioni inserite manualmente standard:

• Verifica del documento di identità: Recommended raccogli in anticipo un numero di documento di identità nazionale per aumentare i tassi di verifica al primo tentativo.
• Stripe Identity: utilizza selfie e acquisizione dei documenti per gli account che non superano la verifica automatica.
• Carica ulteriori documenti: 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. Identity funziona con l’acquisizione di un selfie e di un documento di identità. La maggior parte dei Paesi europei supporta Stripe Identity e le percentuali di successo variano secondo il Paese.

Crea una sessione di verifica dell’identità e utilizza il parametro 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 Anteprima pubblica

Nei Paesi interessati da questo aggiornamento è 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.

Puoi fornire i numeri di identificazione nazionale solo per gli account connessi dei Paesi interessati da questo aggiornamento. Ad esempio, puoi fornire il numero di identificazione di un cittadino spagnolo che agisce in qualità di rappresentante di un account connesso in Austria, ma non puoi fornire il numero di identificazione di un cittadino spagnolo che agisce da rappresentante di un account connesso negli USA.

// 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",
      ...
    ]
  }
 ...
}

> 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",
  ...
}

> 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"
    ]
  }
 ...
}

> 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"
        ]
      }
    ]
  }
}

> curl https://api.stripe.com/v1/accounts/acct_1Nv0FGQ9RKHgCVdB/persons/person_1N9XNb2eZvKYlo2CjPX7xF6B \
  -u sk_test_123: \
  -d 'id_number'='74362315-A' \
  ...other person fields...

> 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"
    ],
  }
}

> 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.*"
        ],
          "person_1N9XNb2eZvKYlo2CjPX7xF6B.proof_of_liveness"
        ]
      },
    ]
  }
}

> 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_in_mismatch",
        "reason": "Identity information could not be verified."
        "requirement": "person_1N9XNb2eZvKYlo2CjPX7xF6B.name"
      },
      {
        "code": "verification_failed_keyed_in_mismatch",
        "reason": "Identity information could not be verified."
        "requirement": "person_1N9XNb2eZvKYlo2CjPX7xF6B.address"
      },
      {
        "code": "verification_failed_keyed_in_mismatch",
        "reason": "Identity information could not be verified."
        "requirement": "person_1N9XNb2eZvKYlo2CjPX7xF6B.id_number"
      }
    ]
  }
}

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:

Verifica le informazioni sull’UBO e sul membro del consiglio di amministrazione

Stripe attempts to verify the person’s relationship by matching key properties of the person with properties of the legal entity.

A successful verification might require only a subset of the properties to match.

Stripe attempts to verify relationships in the following ways:

// 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"
        ],
      }
    ]
  }
}

// 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"
        ],
      }
    ]
  }
}

// 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"
        ],
      }
    ]
  }
}

{
  "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."
    }]
  }
}

{
  "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."
    }]
  }
}

{
  "error": {
    "code": "invalid_signator",
    "message": "signer.person can only be provided when a file is also provided",
    "type": "invalid_request_error"
  }
}

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:

// 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:

// 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.

// 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:

Impatto sulle funzionalità

Le funzionalità degli account con errore unsupported_business_type avranno limitazioni fino all’aggiornamento del tipo di business:

{
  "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:

{
  "capabilities": {
    "card_payments": "inactive"
  },
  "requirements": {
    "disabled_reason": "requirements.past_due",
    "past_due": ["company.tax_id"]
  }
}

Cronologia migrazione

• Ora: nuovo codice d’errore unsupported_business_type attivo
• Quando verranno implementati i requisiti futuri: gli account esistenti dovranno avviare la risoluzione
• 30 settembre 2026: tutti gli account NL devono essere conformi

Lista di spunta per l’implementazione

Piattaforme con account connessi NL:

1. Verifica gli account esistenti

// 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)

2. Gestisci il nuovo codice d’errore

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:

// 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

verification_data_not_found

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.

// 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.

Crea un account di test

Crea un Account di test inviando una richiesta POST all’API Accounts utilizzando la tua chiave privata sandbox.

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:

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, quindi imposta i dettagli di base dell’attività:

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:

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 modalità di test. Per altri risultati, consulta Date di nascita di test. 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.

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:

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:

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:

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.

Crea un account di test seguendo le istruzioni precedenti, quindi imposta i dettagli di base dell’attività:

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à.

Poi fornisci un rappresentante.

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:

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:

{
  "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.

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:

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, quindi imposta i dettagli di base dell’attività. Imposta l’ID fiscale su 222221001, il che attiva l’esito negativo della verifica del titolare.

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:

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:

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:

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_data_not_found. Ciò significa che Stripe non è stata in grado di verificare i titolari utilizzando le informazioni fornite sull’azienda.

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, quindi aggiorna Account utilizzando il token restituito nella risposta. Per questo esempio, utilizza il file_relationship_document_success.

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.

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, 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.

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:

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.

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:

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:

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:

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.