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 garantizar que tu integración con Connect gestione correctamente los distintos flujos. Utiliza el modo de prueba para simular el modo activo aprovechando los tokens especiales provistos por Stripe para usar en tus pruebas. Echa un vistazo a nuestra guía de prueba de pagos para obtener más información sobre cómo probar cargos, 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 con OAuth en cuentas conectadas que usen un dashboard alojado por Stripe mediante tu client_ en modo de prueba.
Tu client_ en modo de prueba es ca_. Puedes encontrarlo en la configuración de Connect OAuth.
El client_ en modo de prueba te permite hacer lo siguiente:
- Definir tu
redirect_en una URL que no es HTTPSuri - Establecer tu
redirect_en localhosturi - 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.
| DOB | 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_.
| Token | Tipo |
|---|---|
address_ | Verificación correcta. |
address_ | Verificación incorrecta. |
address_ | 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 | Unsuccessful verification (identity mismatch). |
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
Test images take precedence over test ID numbers. If you upload a verified image, verification succeeds, even if you also provide an unsuccessful test ID value. Similarly, an unverified image automatically fails verification regardless of the value of other test artifacts.
Tokens de archivos de prueba
Usa estos tokens de archivos para activar determinadas condiciones de verificación de identidad.
| Token | Tipo |
|---|---|
file_ | Utiliza la imagen verificada y marca ese requisito de documento como cumplido. |
file_ | 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
In some countries, the business address associated with your connected account must be validated before charges, payouts, or both can be enabled on the connected account.
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_.
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_ 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_ | En la cuenta, se habilitan tanto los cargos como las transferencias. |
address_ | 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_ | 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 | Successful verification as a non-profit. |
111111111 | Unsuccessful verification (identity mismatch). |
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_ | Error en la verificación del director debido a que un nombre no coincide. Esto puede desencadenar un error verification_. |
missing_ | Error en la verificación debido a que faltan directores en la cuenta. Esto puede desencadenar un error verification_. |
extraneous_ | Error en la verificación debido a que hay demasiados directores en la cuenta. Esto puede desencadenar un error verification_. |
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_ | Error en la verificación debido a que el nombre de la empresa no coincide. |
disallowed_ | Error en la verificación debido al nombre genérico o reconocido de la empresa. |
match_ | Verificación correcta del nombre de la empresa. |
match_ | 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_. |
disallowed | Activa un error de verificación invalid_. |
Activa la verificación del prefijo 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_prefix.
| Token | Tipo |
|---|---|
mismatch | Activa un error de verificación invalid_. |
disallowed | Activa un error de verificación invalid_. |
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. | Activa un error de verificación invalid_. |
https://geoblocked. | Activa un error de verificación invalid_. |
https://problem. | Activa un error de verificación invalid_. |
https://missing. | Activa un error de verificación invalid_. |
https://mismatch. | Activa un error de verificación invalid_. |
https://passwordprotected. | Activa un error de verificación invalid_. |
https://accessible. | Activa una validación exitosa de la URL. |
https://underconstruction. | Activa un error de verificación invalid_. |
https://inaccessible. | Activa un error de verificación invalid_. |
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_ | Activa un error de verificación invalid_. |
invalid_ | Activa un error de verificación invalid_. |
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_ | Activa un error de verificación invalid_. |
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. | Configura una cuenta sin actividad reciente como inactiva y pausa todas las verificaciones. Establece el motivo para la desactivación de cualquier capacidad inactiva en paused. (rejected. para las versiones de API anteriores a 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_ | Modifica el siguiente grupo de requisitos que tienen vencimiento más adelante a requisitos que vencen ahora. |
| 4000000000004210 | tok_ | Activa un bloqueo de cargos. |
| 4000000000004236 | tok_ | Activa un bloqueo de transferencias. |
Activar próximos requisitos
Live mode can require additional verification information when a connected account processes a certain amount of volume. This card sets any additional verification information to be required immediately. If no additional information is required, nothing appears.
Activar un bloqueo de cargos o transferencias
If required information isn’t provided by the deadline, Stripe disables the connected account’s charges or payouts. These cards disable the connected account and move any currently due requirements to overdue. These cards have no effect until an account provides the initial information that’s required to enable charges and payouts.
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].
En el modo de prueba, puedes simular el proceso de verificación de titularidad de la cuenta bancaria de EE. UU. Usa los siguientes números de cuenta bancaria de prueba para activar el proceso de verificación. Un número supone una verificación exitosa y el otro te pide que subas imágenes de prueba o tokens de archivos 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 | Triggers the bank account ownership verification process after a short delay and requests for document upload |
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. |
|---|---|---|
| Fecha de nacimiento y dirección verificadas | Verificada | Ninguna |
| Fecha de nacimiento verificada y dirección no verificada | Sin verificar | verification. |
| Fecha de nacimiento no verificada y dirección verificada | Sin verificar | verification. |
| Fecha de nacimiento y dirección no verificadas | Sin verificar | verification., verification. |
Agregar fondos al saldo de Stripe
Para probar agregar fondos a tu saldo de Stripe desde una cuenta bancaria en el Dashboard, habilita el modo 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 transacción realizada con éxito o que falla debido por falta de fondos.
Para probar cómo agregar fondos en la API, utiliza los siguientes tokens bancarios de prueba como fuente estando en modo de prueba. Cada token simula un tipo específico de evento.
| Token | Tipo |
|---|---|
btok_ | Efectuada con éxito |
btok_ | Fallida con el código no_ |
btok_ | Fallida con el código account_ |
btok_ | Fallida con el código insufficient_ |
btok_ | Fallida con el código debit_ |
btok_ | Fallida con el código invalid_ |
Transferencias a cuentas bancarias
Usa los siguientes números de tarjetas de débito y números bancarios de prueba para activar determinados eventos durante la prueba de transferencias a cuenta bancaria. Solo puedes usar estos valores en modo de prueba con claves secretas de prueba.
Las transferencias en modo de prueba simulan una transferencia en tiempo real, pero no se procesan con el banco. Las cuentas en modo de prueba con acceso al Dashboard de Stripe siempre tienen las transferencias habilitadas, siempre que se cumplan condiciones como los datos bancarios externos válidos y otras condiciones pertinentes, y nunca requieren una verificación real de identidad.
Nota
No puedes usar números de tarjetas de débito ni números bancarios de prueba en el Dashboard de Stripe en una cuenta conectada en modo activo. Si introdujiste la información de tu cuenta bancaria en una cuenta en modo activo, aún puedes usar el modo de prueba, y las transferencias en modo de prueba simularán una transferencia activa sin procesar el 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.
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.