Cómo probar Stripe Connect

Antes de pasar a modo activo, prueba tu integración con Connect para la creación de cuentas, la verificación de identidad y las transferencias.

Utiliza las pruebas para asegurarte de que tu integración de Connect gestiona correctamente los diferentes flujos. Puedes usar entornos de prueba para simular el modo activo mientras aprovechas los tokens especiales proporcionados por Stripe para usar en tus pruebas. Consulta la guía de prueba de pagos para obtener más información sobre cargos de pruebas, disputas, etc.

Crear cuentas de prueba

Puedes crear varias cuentas de prueba y usar cualquier tipo de cuenta o propiedades del controlador que podrías necesitar (por ejemplo, en representación de varios países).

Puedes crear cuentas de prueba con la API Accounts o en el Dashboard de Stripe.

Usa 000-000 como el código del mensaje de texto cuando se te solicite para las cuentas de prueba.

Prueba el flujo OAuth

Puedes probar tu integración de OAuth con cuentas conectadas que usen un Dashboard alojado en Stripe con tu client_id de prueba.

El client_id de prueba es ca_FkyHCg7X8mlvCUdMDao4mMxagUfhIwXb. Puedes encontrarlo en la Configuración de OAuth de Connect.

Tu prueba client_id te permite:

Definir tu redirect_uri en una URL que no es HTTPS
Establecer tu redirect_uri en localhost
Omitir el formulario de cuentas en lugar de tener que llenar la solicitud de cuenta completa (solo cuentas con el Dashboard de Stripe)
Obtén tokens de acceso de prueba para cuentas conectadas

Para probar el flujo de OAuth, crea una cuenta nueva después de hacer clic en el enlace de OAuth. También podrás intentar conectar una cuenta de Stripe existente solo si el correo electrónico es diferente de la cuenta de la plataforma.

Verificación de identidad

Después de crear una cuenta conectada de prueba, puedes usar tokens para probar diferentes estados de verificación con el fin de asegurarte de que estás administrando diferentes requisitos y estados de cuenta. Puedes usar los siguientes tokens para probar la verificación con cuentas de prueba.

Fechas de nacimiento de prueba

Usa estas fechas de nacimiento para activar determinadas condiciones de verificación.

Fecha de nacimiento	Tipo
`1901-01-01`	Verificación correcta. Cualquier otra fecha de nacimiento da una verificación incorrecta.
`1902-01-01`	Verificación inmediata y correcta. El resultado de la verificación se devuelve directamente en la respuesta, no como parte de un evento de webhook.
`1900-01-01`	Esta fecha de nacimiento activa una alerta de la Oficina de Control de Bienes Extranjeros (OFAC).

Direcciones de prueba

Usa estas direcciones para line1 para activar determinadas condiciones de verificación. Debes especificar valores legítimos para los argumentos city, state y postal_code.

Token	Tipo
`address_full_match`	Verificación correcta.
`address_no_match`	Verificación incorrecta.
`address_line1_no_match`	Error en la verificación debido a la coincidencia parcial de direcciones.

Números de documentos de identidad de prueba

Usa estos números de identificación personal para individual.id_number o el atributo id_number en el objeto Person para activar ciertas condiciones de verificación.

Número	Tipo
`000000000`	Verificación correcta. 0000 también funciona para la verificación de los cuatro últimos dígitos del SSN.
`111111111`	Verificación incorrecta (error de coincidencia de identidad).
`222222222`	Verificación inmediata y correcta. El resultado de la verificación se devuelve directamente en la respuesta, no como parte de un evento de webhook.

Documentos de identidad de prueba

Para realizar pruebas, utiliza imágenes de pruebas o tokens de archivos en lugar de cargar tus propias ID de prueba. Para obtener más detalles, consulta Cómo cargar un archivo.

Imágenes de documentos de prueba

Puedes usar una imagen verificada para que se marque al usuario automáticamente como verified. Puedes usar una imagen no verificada para que se marque al usuario automáticamente como unverified.

Nota

Las imágenes de prueba tienen prioridad sobre los números de identificación de la prueba. Si subes una imagen verificada, la verificación se realiza correctamente, incluso si también proporcionas un valor de ID de prueba sin éxito. Del mismo modo, una imagen no verificada falla automáticamente la verificación independientemente del valor de otros artefactos de prueba.

Tokens de archivos de prueba

Usa estos tokens de archivos para activar determinadas condiciones de verificación de identidad.

Token	Tipo
`file_identity_document_success`	Utiliza la imagen verificada y marca ese requisito de documento como cumplido.
`file_identity_document_failure`	Utiliza la imagen no verificada y marca ese requisito de documento como no cumplido.

Verificación de la información de la empresa

Validación de la dirección comercial

En algunos países, la dirección comercial asociada con tu cuenta conectada debe validarse para que puedan habilitarse cargos, transferencias a cuentas bancarias o ambos en la cuenta conectada.

Direcciones comerciales de prueba

Usa estas direcciones para line1 para activar determinadas condiciones de validación. Debes especificar valores legítimos para los argumentos city, state y postal_code.

Asegúrate de comenzar con un token de dirección que tenga la condición de validación menos permisiva que quieras probar. Esto se debe a que no puedes usar un token de dirección con una condición de validación más restrictiva que la del token utilizado antes. Por ejemplo, si especificaste address_full_match para habilitar tanto cargos como transferencias, después no podrás deshabilitar las transferencias o los cargos cambiando el token por uno no válido. Puedes resolverlo creando una nueva cuenta con el token correspondiente.

Token	Tipo
`address_full_match`	En la cuenta, se habilitan tanto los cargos como las transferencias.
`address_no_match`	En la cuenta, solo se habilitan los cargos. Debido a que falló la validación en el atributo `line1`, vuelve a incluirse en el hash de requisitos.
`address_line1_no_match`	En la cuenta no se habilitan ni cargos ni transferencias a cuentas bancarias. Debido a que falló la validación, los atributos de la dirección vuelven a incluirse en el hash de requisitos.

ID fiscales de la empresa de prueba

Usa estos números de identificación fiscal de la empresa para company.tax_id para activar ciertas condiciones de verificación. El comportamiento de la prueba puede cambiar según los países de la cuenta conectada y las normativas de esos países. Según la regulación del país, un documento fiscal válido puede marcar el número de identificación fiscal verificado en estos países.

Número	Tipo
`000000000`	Verificación correcta.
`000000001`	Verificación correcta como organización sin fines de lucro.
`111111111`	Verificación incorrecta (error de coincidencia de identidad).
`111111112`	Verificación incorrecta (no se emitió la identificación fiscal).
`222222222`	Verificación inmediata y correcta. El resultado de la verificación se devuelve directamente en la respuesta, no como parte de un evento de webhook.

Prueba la verificación del cargo directivo

Stripe realiza la verificación del cargo directivo comparando la lista de directores en el objeto Account con una lista recuperada de los registros locales. Si el país lo exige, puedes activar la verificación de un objeto Account usando estos tokens para el atributo person. first_name y estableciendo el atributo person.relationship.director como verdadero.

Token	Tipo
`mismatch_director`	Error en la verificación del director debido a que un nombre no coincide. Esto puede desencadenar un error `verification_directors_mismatch`.
`missing_director`	Error en la verificación debido a que faltan directores en la cuenta. Esto puede desencadenar un error `verification_missing_directors`.
`extraneous_director`	Error en la verificación debido a que hay demasiados directores en la cuenta. Esto puede desencadenar un error `verification_extraneous_directors`.

Los errores de verificación pueden desencadenarse si varios directores en el objeto Account usan estos tokens mágicos.

Prueba la verificación del nombre de la empresa

Activa la verificación del nombre de la empresa para un objeto Account mediante el uso de este token para el atributo company.name.

Token	Tipo
`mismatch_business_name`	Error en la verificación debido a que el nombre de la empresa no coincide.
`disallowed_name`	Error en la verificación debido al nombre genérico o reconocido de la empresa.
`match_name_relationships`	Verificación correcta del nombre de la empresa.
`match_name_only`	Error en la verificación debido a una discrepancia en el nombre de la empresa.

Prueba la verificación de la descripción del cargo en el extracto bancario

Activa la verificación de la descripción del cargo en el extracto bancario para un objeto Account mediante el uso de este token para el atributo settings.payments. statement_descriptor.

Token	Tipo
`mismatch`	Activa un error de verificación `invalid_statement_descriptor_business_mismatch`.
`disallowed`	Activa un error de verificación `invalid_statement_descriptor_denylisted`.

A fin de activar la verificación del prefijo de la descripción del cargo en el extracto bancario para un objeto Account, usa este token para el atributo settings.card_payments.statement_descriptor_prefix.

Token	Tipo
`mismatch`	Activa un error de verificación `invalid_statement_descriptor_prefix_mismatch`.
`disallowed`	Activa un error de verificación `invalid_statement_descriptor_prefix_denylisted`.

Prueba la verificación de la URL de la empresa

Activa la verificación de la URL para un objeto Account con este token para el atributo business_profile.url.

Token	Tipo
`https://disallowed.stripe.com`	Activa un error de verificación `invalid_url_denylisted`.
`https://geoblocked.stripe.com`	Activa un error de verificación `invalid_url_website_inaccessible_geoblocked`.
`https://problem.stripe.com`	Activa un error de verificación `invalid_url_website_other`.
`https://missing.stripe.com`	Activa un error de verificación `invalid_url_website_incomplete`.
`https://mismatch.stripe.com`	Activa un error de verificación `invalid_url_website_business_information_mismatch`.
`https://passwordprotected.stripe.com`	Activa un error de verificación `invalid_url_website_inaccessible_password_protected`.
`https://accessible.stripe.com`	Activa una validación exitosa de la URL.
`https://underconstruction.stripe.com`	Activa un error de verificación `invalid_url_website_incomplete_under_construction`.
`https://inaccessible.stripe.com`	Activa un error de verificación `invalid_url_website_inaccessible`.

Prueba la verificación del nombre comercial (DBA)

Activa la verificación DBA para un objeto Account con este token para el atributo business_profile.name.

Token	Tipo
`disallowed_dba`	Activa un error de verificación `invalid_business_profile_name_denylisted`.
`invalid_dba`	Activa un error de verificación `invalid_business_profile_name`.

Prueba la verificación de la descripción del producto

Activa la verificación de la descripción del producto para un objeto Account con este token para el atributo business_profile.product_description.

Token	Tipo
`require_url`	Activa un error de verificación `invalid_url_web_presence_detected`.

Prueba la validación del número de teléfono

Borra la validación del número de teléfono para un objeto Account mediante este token para los siguientes atributos:

Borra la validación del número de teléfono para un objeto Person mediante este token para el atributo phone.

Token	Tipo
`0000000000`	Validación correcta

Motivos de desactivación de la funcionalidad de prueba

Activa la asignación de un requirements. disabled_reason específico para todos los objetos Capability inactivos de un objeto Account mediante el uso de este token para el atributo business_profile.url de la cuenta.

Token	Tipo
`https://inactivity.stripe.com`	Set an account as inactive and pause all verifications for it. Set the disabled reason for any inactive capabilities to `paused.inactivity` (`rejected.other` for API versions prior to `2024-06-20`).

Activa o adelanta la verificación

Activar tarjetas

Utiliza estos números de tarjeta para activar diversas condiciones al probar requisitos y verificaciones escalonadas. Para que funcionen las acciones de activación, debes usar estas tarjetas con un cargo Connect configurando on_behalf_of o creando el cargo directamente en la cuenta conectada.

Número	Token	Tipo
4000000000004202	`tok_visa_triggerNextRequirements`	Modifica el siguiente grupo de requisitos que tienen vencimiento más adelante a requisitos que vencen ahora.
4000000000004210	`tok_visa_triggerChargeBlock`	Activa un bloqueo de cargos.
4000000000004236	`tok_visa_triggerPayoutBlock`	Activa un bloqueo de transferencias.

Activar próximos requisitos

El modo activo puede exigir información de verificación adicional cuando una cuenta conectada procesa un determinado volumen. Esta tarjeta establece la información adicional que debe solicitarse de inmediato. Si no se requiere información adicional, no aparece nada.

Activar un bloqueo de cargos o transferencias

Si vence el plazo y no se proporciona la información necesaria, Stripe deshabilita los cargos o transferencias de la cuenta conectada. Estas tarjetas deshabilitan la cuenta conectada y cambian el estado de los requisitos de “vencen ahora“ a “vencidos“. Estas tarjetas no tienen ningún efecto hasta que una cuenta proporciona la información inicial necesaria para habilitar los cargos y transferencias.

Activar la verificación de titularidad de la cuenta bancaria

Las cuentas conectadas en Estados Unidos e India están sujetas a la verificación de la titularidad de la cuenta bancaria. Para completar esta verificación, sube documentos de respaldo con el Dashboard de Connect o con la API mediante la función hash documents[bank_account_ownership_verification].

Durante las pruebas, puedes simular el proceso de verificación de titularidad de una cuenta bancaria de EE. UU. Utiliza los siguientes números de cuenta bancaria de prueba para activar el proceso de verificación. Un número supone que la verificación se realizó correctamente y el otro le solicita que cargue imágenes de prueba o tokens de archivo para completar el proceso de verificación. Estas cuentas de prueba solo están disponibles para cuentas de EE. UU.

Enrutamiento	Cuenta	Tipo
`110000000`	`000999999991`	Activa y completa el proceso de verificación de la titularidad de la cuenta bancaria después de una pequeña demora
`110000000`	`000999999992`	Activa el proceso de verificación de la titularidad de la cuenta bancaria tras un breve período y solicita la carga de documentos

Simular requisitos

Si tu plataforma tiene cuentas conectadas en diferentes países o planea tenerlas, podrías tener que verificar la dirección y la identidad de las personas (según el país de que se trate). Stripe proporciona una fecha de nacimiento y direcciones de ejemplo para que puedas probar este requisito.

Información proporcionada	Estado de verificación de la persona	`requirements.currently_due`
Fecha de nacimiento y dirección verificadas	Verificada	Ninguna
Fecha de nacimiento verificada y dirección no verificada	Sin verificar	`verification.additional_document`
Fecha de nacimiento no verificada y dirección verificada	Sin verificar	`verification.document`
Fecha de nacimiento y dirección no verificadas	Sin verificar	`verification.additional_document`, `verification.document`

Agregar fondos al saldo de Stripe

Para probar agregar fondos a tu saldo de Stripe desde una cuenta bancaria en el Dashboard, crea un entorno de prueba y selecciona la cuenta bancaria de prueba deseada en el menú desplegable dentro del cuadro de diálogo Agregar al saldo. Puedes simular una operación exitosa o un error debido a fondos insuficientes.

Para probar la adición de fondos en la API, usa los siguientes tokens de banco de prueba como origen mientras realizas la prueba. Cada token simula un tipo específico de evento.

Token	Tipo
`btok_us_verified`	Efectuada con éxito
`btok_us_verified_noAccount`	Fallida con el código `no_account`
`btok_us_verified_accountClosed`	Fallida con el código `account_closed`
`btok_us_verified_insufficientFunds`	Fallida con el código `insufficient_funds`
`btok_us_verified_debitNotAuthorized`	Fallida con el código `debit_not_authorized`
`btok_us_verified_invalidCurrency`	Fallida con el código `invalid_currency`

Transferencias a cuentas bancarias

Usa los siguientes números de banco y tarjeta de débito de prueba para activar ciertos eventos durante la prueba de payout. Solo puedes usar estos valores durante las pruebas con claves secretas de prueba.

Las transferencias de prueba simulan una transferencia real, pero no se procesan con el banco. Las cuentas de prueba con acceso al Dashboard de Stripe siempre tienen activadas las transferencias, mientras se cumplan las condiciones relacionadas con datos bancarios externos válidos y otras condiciones relevantes, y nunca requieren una verificación de identidad real.

Nota

No puedes usar números de banco y tarjeta de débito de prueba en el Dashboard de Stripe en una cuenta conectada en modo activo. Si ingresaste la información de tu cuenta bancaria en una cuenta en modo activo, puedes usar un entorno de prueba y las transferencias de prueba simularán una transferencia real sin procesar dinero real.

Números bancarios

Utiliza estos números de cuenta bancaria de prueba para probar las transferencias. Solo puedes usarlos con las claves secretas de prueba.

Enrutamiento	Cuenta	Type
`110000000`	`000123456789`	La transferencia se efectúa correctamente.
`110000000`	`000111111116`	La transferencia falla con el código `no_account`.
`110000000`	`000111111113`	La transferencia falla con el código `account_closed`.
`110000000`	`000222222227`	La transferencia falla con el código `insufficient_funds`.
`110000000`	`000333333335`	La transferencia falla con el código `debit_not_authorized`.
`110000000`	`000444444440`	La transferencia falla con el código `invalid_currency`.
`110000000`	`000888888883`	La transferencia a cuenta bancaria falla si `method` es `instant`. La cuenta bancaria no reúne los requisitos para Instant Payouts.

Números de tarjetas de débito

Utiliza estos números de tarjetas de débito de prueba para probar transferencias a una tarjeta de débito. Solo se pueden usar con las claves secretas de prueba.

Número	Token	Tipo
4000056655665556	`tok_visa_debit_us_transferSuccess`	Débito Visa. Transferencia efectuada con éxito.
4000056655665572	`tok_visa_debit_us_transferFail`	Débito Visa. La transferencia falla con el código `could_not_process`.
4000056755665555	`tok_visa_debit_us_instantPayoutUnsupported`	Débito Visa. La tarjeta no cumple los requisitos de Instant Payouts.
5200828282828210	`tok_mastercard_debit_us_transferSuccess`	Débito Mastercard. Transferencia efectuada con éxito.
6011981111111113	`tok_discover_debit_us_transferSuccess`	Débito Discover. Transferencia efectuada con éxito.