Próximas actualizaciones de requisitos

Última actualización el 23 de febrero de 2026

Comprensión de los cambios en los requisitos de verificación

Para cumplir con las regulaciones de la Autoridad de Conducta Financiera del Reino Unido (FCA) y el Banco Central de Irlanda (CBI), Stripe está actualizando nuestros requisitos de verificación para Conocimiento del cliente (KYC) y los beneficiarios efectivos finales (UBO) y directores.

Si tus cuentas conectadas operan en alguno de los países enumerados, es posible que tengas que actualizar tu flujo de activación. Si no realizas las actualizaciones necesarias, se interrumpirá el acceso de tus cuentas conectadas a los pago y servicios financieros.

Para obtener más información sobre lo que está cambiando y por qué, consulta el artículo de soporte Nuevos requisitos de cumplimiento.

Los próximos cambios afectarán a las cuentas conectadas de los siguientes países:

Elección de un enfoque de integración

Stripe recomienda usar onboarding alojado o integrado en Stripe para recopilar requisitos de verificación de empresas e identidad. Estas opciones requieren menos recursos de implementación y mantenimiento que usar la activación de API. La siguiente tabla describe las principales diferencias:

• Onboarding alojado en Stripe: Recomendado Envía cuentas a un flujo alojado en Stripe para enviar la información requerida.
• Onboarding integrado: Recomendado Integra componentes de onboarding proporcionados por Stripe que permiten a las cuentas enviar información directamente a Stripe desde tu aplicación.
• Activación de API: crea y gestiona un flujo de activación personalizado con las API de Stripe.

Obtén más información sobre las opciones de onboarding de Connect y la migración de tus flujos de Onboarding y corrección basados en API a flujos alojados o integrados en Stripe.

Los cambios que realices en tu flujo de activación dependen de cómo recopiles la información del onboarding. Además de actualizar tu flujo de activación, actualiza tu documentación interna y externa según sea necesario, y prepara a tus equipos de soporte para responder preguntas sobre las actualizaciones.

Si usas el onboarding alojado o integrado en Stripe, no es necesario que actualices tu integración para prepararte para estos nuevos requisitos. Sin embargo, puedes comunicar a tus cuentas conectadas que Stripe podría pedir información de identidad nueva o actualizada cuando cambien los requisitos.

Resumen de la integración de API

Si decides no migrar a la activación alojada o integrada en Stripe, debes abordar las siguientes actualizaciones:

• Verificación de conocimiento del cliente (KYC)
• Verificación de la relación entre beneficiario efectivo final (UBO) y director
• Requisitos de registro empresas (KvK) en los Países Bajos
• Nuevos códigos de error

Actualización de la línea temporal

La siguiente línea temporal explica los hitos clave para estos cambios. Asegúrate de actualizar y probar tu integración pronto para evitar cualquier problema cuando entren en vigor los nuevos requisitos.

Verificación de conocimiento del cliente (KYC)

Stripe está fortaleciendo nuestro proceso de verificación de identidad, lo que puede requerir que algunas de tus cuentas conectadas proporcionen información adicional. También estamos añadiendo más opciones a la API para verificar la información.

Las siguientes entidades deben proporcionar información KYC verificable:

• Entidad jurídica (para particulares y entidades unipersonales);
• Representante de la cuenta
• Los UBO y directores (para cuentas consideradas de alto riesgo por el modelo de riesgo de Stripe)

Métodos de verificación adicionales

Puedes mejorar las tasas de éxito de la verificación utilizando los siguientes métodos, además de la información introducida de forma estándar:

• Verificación del documento nacional de identidad: Recommended consigue un número de identificación nacional por adelantado para aumentar las tasas de verificación en la primera pasada.
• Stripe Identity: utiliza selfies y capturas de documentos para las cuentas que no superen la verificación automática.
• Cargar documentación adicional: envía documentos justificativos de identidad o dirección para revisarlos manualmente.

Stripe Identity Recomendado

Puedes intentar verificar las cuentas conectadas que no pasen su verificación automática utilizando Stripe Identity, que funciona capturando una selfie y un documento de identidad. La mayoría de los países europeos aceptan Stripe Identity, y las tasas de éxito varían según el país.

Crea una sesión de verificación de identidad y utiliza el parámetro related_person para enviar los requisitos de document y la proof_of_liveness de la persona. Puedes comprobar los resultados usando la API o el Dashboard.

Verificación del documento nacional de identidad Vista previa privada

En los países afectados por esta actualización, puedes mejorar la verificación de un representante de la cuenta conectada proporcionando su número de identificación nacional además de su nombre, fecha de nacimiento, dirección y nacionalidad.

Actualmente, la verificación solo admite los siguientes números de identificación nacional.

Puedes proporcionar documentos nacionales de identidad solo para cuentas conectadas en los países afectados por esta actualización. Por ejemplo, puedes proporcionar el documento nacional de identidad de un ciudadano español que actúe como representante de una cuenta conectada en Austria, pero no puedes proporcionar ese documento de un ciudadano español que actúe como representante de una cuenta conectada en EE. UU.

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

Verificación de la relación entre los UBO y los directores

Stripe está mejorando nuestro proceso de verificación para los beneficiarios finales (UBO, por sus siglas en inglés) y los directores. La normativa europea exige verificar la relación de los UBO y los directores con la entidad jurídica:

• UBO: un particular que posee o controla (directa o indirectamente) más del 25 % de una entidad jurídica (por ejemplo, empresas, corporaciones, LLC y sociedades colectivas).
• Director: miembro del consejo de administración o persona sénior responsable de la gestión de una empresa (por ejemplo, CEO, COO, director gerente).

La siguiente tabla muestra las relaciones que deben verificarse para cada tipo de entidad jurídica:

Verifica la información del UBO y del director

Stripe intenta verificar la relación de la persona cotejando las propiedades clave de la persona con las propiedades de la entidad jurídica.

Una verificación correcta puede requerir que solo coincida un subconjunto de las propiedades.

Stripe intenta verificar las relaciones de las siguientes maneras:

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

Rellena automáticamente la información del UBO y del director Vista previa privada

Si lo deseas, también puedes integrarte con una API que detecta y rellena mediante programación los UBO o directores asociados a una entidad jurídica. La cuenta conectada puede verificar la relación confirmando la información detectada en lugar de mediante la carga de documentos o la certificación digital.

Esta vía puede aumentar las tasas de verificación y reducir las fricciones, pero no funciona para todas las cuentas. Aún es necesario gestionar la carga de documentos o las certificaciones digitales para aquellas cuentas en las que Stripe no puede rellenar previamente sus relaciones.

Si te interesa rellenar automáticamente la verificación de UBO o directores, regístrate a continuación.

Requisitos de registro empresas (KvK) en los Países Bajos

A partir de 2026, aplicaremos requisitos más estrictos sobre el tipo de empresa para las cuentas de los Países Bajos (NL) con el fin de garantizar el cumplimiento de la normativa holandesa. Esto afecta específicamente a la forma en que cobramos el KvK (Kamer van Koophandel), el número de registro único de 8 dígitos de la empresa requerido para las empresas de los Países Bajos.

¿Qué va a cambiar?

Ya no es compatible el tipo de empresa particular

El tipo de empresa individual ya no es compatible con las cuentas de los Países Bajos, lo que afecta a las cuentas existentes y nuevas de Países Bajos con business_type: "individual" y business_type: "sole_proprietorship"

Por qué es importante: en los Países Bajos, todas las empresas deben proporcionar un número KvK (Cámara de Comercio). Nuestro tipo de empresa «particular» no recopila el KvK, lo que la convierte en no conforme.

Nuevo código de error: unsupported_business_type

Las cuentas con tipos de empresa no válidos ven un nuevo error en sus requisitos:

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

Recopilación del registro KvK para cuentas no constituidas

Las cuentas de NL existentes y nuevas con los siguientes tipos y estructuras de empresa deben proporcionar el registro KvK.

• business_type: "company" y business_structure: "unincorporated_partnership"
• business_type: "non_profit" y business_structure: "unincorporated_non_profit"

Por qué es importante: las cuentas no constituidas actualmente no están obligadas a proporcionar un número KvK, lo que infringe los requisitos neerlandeses de cumplimiento de la normativa. Todas las empresas de Países Bajos deben proporcionar su registro KvK.

Cómo resolverlo

Para las cuentas existentes

Las cuentas de Países Bajos existentes con tipo de empresa individual deben actualizarse a company con estructura sole_proprietorship para cumplir con la normativa cuando comencemos a implementar este nuevo requisito:

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

Para la creación de nuevas cuentas

Si intentas crear una cuenta en los Países Bajos con un tipo de empresa individual, aparecerá el error 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"

Estructuras de empresa compatibles con NL

Para las cuentas de Países Bajos, utiliza estas combinaciones de tipo y estructura de empresa:

Impacto en las funcionalidades

Las cuentas con error unsupported_business_type tendrán sus capacidades restringidas hasta que se actualice el tipo de empresa:

{
  "capabilities": {
    "card_payments": "inactive",
    "transfers": "inactive"
  },
  "requirements": {
    "disabled_reason": "requirements.past_due",
    "past_due": ["business_type"]
  }
}

Las cuentas que no hayan proporcionado su registro KvK tendrán restringida su funcionalidad card_payments hasta que se proporcione esta información:

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

Línea temporal de migración

• Ahora: el nuevo código de error unsupported_business_type está activo
• Cuándo se implementarán los requisitos futuros: las cuentas existentes deben iniciar correcciones
• 30 de septiembre de 2026: todas las cuentas de NL deben cumplir con la normativa

Lista de verificación de implementación

Para plataformas con cuentas conectadas a NL:

1. Auditoría de cuentas existentes

// 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. Actualización de flujos para crear cuentas

   • Elimina la opción individual para cuentas de NL
   • Predeterminado para company con sole_proprietorship
   • Recopilación del número KvK (company.tax_id)

2. Gestionar el nuevo código de error

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. Comunicación con las cuentas conectadas afectadas

   • Explicación de por qué es necesario realizar el cambio
   • Proporción de orientación sobre cómo seleccionar la estructura correcta de la empresa
   • Ayúdales a localizar su número KvK

Pruebas

Prueba tu implementación con estas situaciones:

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

Aspectos adicionales que se deben tener en cuenta

Autónomos particulares

En los Países Bajos, incluso los trabajadores autónomos particulares deben registrarse como empresa (eenmanszaak) y obtener un número KvK. Deben seleccionar empresa → sole_proprietorship.

Cómo encontrar el número KvK para las cuentas conectadas

El número KvK figura en su certificado de registro de la Cámara de comercio (uittreksel Kamer van Koophandel).

Compatibilidad con versiones anteriores

En versiones anteriores de la API, unsupported_business_type aparece como invalid_value_other con un campo detailed_code que contiene el error específico.

Nuevos códigos de error

verification_data_not_found

El nuevo código de error verification_data_not_found puede aparecer en la matriz requirements.errors del objeto Account. Este error indica que Stripe no ha podido recuperar información (como datos sobre el propietario beneficiario último o sobre directores/ejecutivos) de proveedores de verificación externos utilizando los datos de la entidad jurídica conocidos de la cuenta conectada. Esto puede ocurrir por varias razones, pero a menudo se debe a que la cuenta ha introducido la información de forma incorrecta.

Este error de «datos no encontrados» es distinto de los códigos de error de verificación existentes:

• verification_missing_owners: indica que faltan propietarios conocidos en la cuenta.
• verification_failed_keyed_match: indica una falta de coincidencia entre la información enviada y las fuentes de verificación.

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

Para solucionar este error, solicita a la cuenta conectada que revise y corrija la información de su entidad jurídica (nombre de la empresa, número de registro, dirección). Si actualizan su información, Stripe intentará verificarla de nuevo automáticamente.

Si la información de la cuenta es correcta, o si Stripe sigue sin poder verificar la información actualizada, utiliza un método de verificación manual, como la carga de documentos o la certificación digital.

Pruebas

Puedes crear cuentas de prueba para utilizarlas durante el desarrollo y las pruebas de tu integración. Las cuentas de prueba pueden simular diferentes resultados de verificación, lo que te permite ver cómo la API devuelve los requisitos y los errores para cada caso.

Los siguientes ejemplos te ayudarán a prepararte para los próximos cambios en los requisitos de la UE. Para obtener más información sobre las pruebas de Connect en general, consulta Pruebas de Stripe Connect.

Crea una cuenta de prueba

Crea una cuenta de prueba enviando una solicitud POST a la API de cuentas utilizando tu clave secreta de entorno de pruebas.

Para acceder a los nuevos requisitos antes de que se publiquen en las cuentas que no están en modo de prueba, configura un encabezado que habilite una versión preliminar de la API, habilita la función experimental de vista previa de onboarding y habilita la versión preliminar al solicitar una capacidad. Por ejemplo:

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'

Los ejemplos siguientes muestran cómo simular diferentes situaciones utilizando valores que desencadenan respuestas específicas para cuentas de prueba.

Probar una cuenta perteneciente a una persona física

Este ejemplo crea una cuenta que no requiere verificación de relación porque el tipo de entidad comercial es individual.

Crea una cuenta de prueba siguiendo las instrucciones anteriores,y, a continuación, configura los datos básicos de la empresa:

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 respuesta incluye los requisitos básicos para una persona. Puedes cumplir estos requisitos creando un representante:

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"

Al especificar la fecha de nacimiento 1901-01-01, se activa la verificación de identidad correcta en modo de prueba. Para otros desencadenantes de resultados, consulta Fechas de nacimiento de prueba… Del mismo modo, al establecer la primera línea de la dirección con la cadena address_full_match, se activa la verificación correcta de la dirección. Para otros desencadenantes de resultados, consulta Direcciones comerciales de prueba.

La respuesta muestra que los requisitos del individuo han quedado pendientes. Si esperas unos momentos y recuperas la cuenta, podrás ver que esos requisitos se han eliminado:

curl https://api.stripe.com/v1/accounts/acct_test_123 \
  -u sk_test_123

Los únicos requisitos que quedan son los relativos a la cuenta bancaria (external_account y las condiciones del servicio (TOS). Para cumplir los requisitos de las condiciones del servicio, configura el hash tos_acceptance de la cuenta:

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"

Para cumplir con los requisitos de la cuenta bancaria, crea una cuenta bancaria de prueba para la Cuenta.. Especifica un número de cuenta bancaria de prueba según tu país:

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"

Probar una cuenta perteneciente a una empresa

Este ejemplo crea una cuenta que está sujeta a requisitos de verificación de relaciones porque el tipo de entidad comercial es empresa

Crea una cuenta de prueba siguiendo las instrucciones anteriores,y, a continuación, configura los datos básicos de la empresa:

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"

Si especificas el número de ID fiscal 000000000, se activará correctamente la verificación de la empresa. Para obtener otros resultados, consulta Probar ID fiscales de la empresa.

A continuación, proporciona un representante.

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"

Una vez completado el proceso de verificación del representante, puedes ver los requisitos restantes con una solicitud GET:

curl https://api.stripe.com/v1/accounts/acct_test_123 \
  -u sk_test_123:

Los requisitos de la matriz rrequirements.currently_due enumeran los detalles que necesitamos sobre los propietarios de la cuenta. La matriz requirements.alternatives puede incluir información opcional que puedes proporcionar para cumplir determinados requisitos. Por ejemplo:

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

Puedes proporcionar los campos enumerados en alternative_fields_due como otra forma de cumplir los requisitos en la lista original_fields_due correspondiente. En este ejemplo, alternative_fields_due incluye las propiedades de original_fields_due, además de documents.proof_of_ultimate_beneficial_ownership.files. Esto significa que la información original es obligatoria, pero también tienes la opción de proporcionar un documento que demuestre la propiedad efectiva final para ayudar a procesar la verificación.

Para cumplir los requisitos de propietario, crea dos personas y márcalas como propietarios. Los nombres de este ejemplo son valores codificados para cuentas de prueba que usan el número de ID fiscal 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 que has creado todos los propietarios de la cuenta estableciendo empresa.owners_provided como verdadero:

curl https://api.stripe.com/v1/accounts/acct_test_123 \
  -u sk_test_123: \
  -d "company[owners_provided]=true"

Al completar esta solicitud, se eliminarán todos los requisitos del propietario de la cuenta.

Prueba de respaldo para la verificación de documentos

Los requisitos de propietario de una cuenta permanecen en currenty_due (o en pending_verification, si la verificación está en curso) hasta que se completa correctamente.

Cuando la verificación falla, una de tus opciones es cargar un documento. Este ejemplo muestra cómo hacerlo utilizando la API.

Crea una cuenta de prueba siguiendo las instrucciones anteriores y, a continuación, establece los datos básicos de la empresa. Establece el número de ID fiscal en 222221001, lo que provoca un error en la verificación del propietario.

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"

A continuación, indica un representante:

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"

Luego, crea un propietario:

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 que has terminado de crear propietarios estableciendo empresa.owners_provided como verdadero:

curl https://api.stripe.com/v1/accounts/acct_test_123 \
  -u sk_test_123: \
  -d "company[owners_provided]=true"

Si examinas la cuenta, puedes ver que los requisitos de propietario se mantienen y que la matriz requirements.errors contiene una entrada con un requisito de propietarios y un código de verification_data_not_found. Eso significa que Stripe no ha podido verificar a los propietarios utilizando la información proporcionada por la empresa.

Si recibes este error para una cuenta, real, comprueba que has introducido los datos de la entidad jurídica correcta. En este ejemplo se supone que los datos son correctos y que debes proporcionar un documento para verificarlos.

En el caso de una cuenta real, utiliza la API Files para cargar un documento y, a continuación, actualiza la cuenta utilizando el token devuelto en la respuesta. Para este ejemplo, utiliza el token de prueba 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

Unos momentos después de actualizar la cuenta, podrás obtener los requisitos actuales y ver que los requisitos del propietario se han eliminado.

curl https://api.stripe.com/v1/accounts/acct_test_123 \
  -u sk_test_123:

Prueba una empresa sin propietarios aplicables

Si una empresa no tiene propietarios con más del 25 % de participación, Stripe requiere la información de los directores. Este ejemplo muestra cómo proporcionar la información de los directores.

Crea una cuenta de prueba siguiendo las instrucciones anteriores y, a continuación, configura los datos básicos de la empresa. Establece el número de ID fiscal en 000000000, lo que activa el éxito de la verificación empresa.

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"

A continuación, indica un representante:

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"

Para indicar que la empresa no tiene propietarios relevantes, establece empresa.owners_provided como verdadero sin crear ningún propietario. Para reutilizar una cuenta de prueba existente que tenga propietarios, puedes eliminar todos los propietarios existentes.

curl https://api.stripe.com/v1/accounts/acct_test_123 \
  -u sk_test_123: \
  -d "company[owners_provided]=true"

La matriz requirements.alternatives contiene un conjunto de propiedades de director como alternativa a las propiedades de propietario. El proceso para crear un director es muy similar al proceso para crear un propietario:

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 que has terminado de crear directores estableciendo empresa.directors_provided como verdadero:

curl https://api.stripe.com/v1/accounts/acct_test_123 \
  -u sk_test_123: \
  -d "company[directors_provided]=true"

Para simular una verificación correcta de la relación, establece empresa.name en la cadena match_name_relationships:

curl https://api.stripe.com/v1/accounts/acct_test_123 \
  -u sk_test_123: \
  -d "company[name]=match_name_relationships"

Otros casos de prueba

Las siguientes pruebas también son útiles:

• Una entidad del tipo sin ánimo_de lucro, que requiere la verificación del director (la verificación del beneficiario efectivo real no es una opción).
• Cumplimiento de los requisitos de verificación del director con un documento.
• Empresas del Reino Unido que requieren tanto la verificación del beneficiario efectivo final (UBO) como la verificación de los directores.