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 con diferentes tipos de cuenta o propiedades del controlador que quieras probar.
Puedes crear cuentas de prueba con API Accounts o en la 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 una Dashboard alojada en Stripe mediante el client_ de prueba.
El client_ de prueba es ca_. Puedes encontrarlo en la Configuración de OAuth de Connect.
Tu prueba client_ te permite:
- 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.
| Fecha de nacimiento | Tipo |
|---|---|
1901-01-01 | La fecha de nacimiento coincidió correctamente. Cualquier otra fecha de nacimiento no coincide. |
1902-01-01 | Coincidencia inmediata y exitosa de la fecha de nacimiento. 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_ | Coincidencia de dirección exitosa. |
address_ | Coincidencia de dirección inmediata y exitosa. |
address_ | Es probable que el error en la coincidencia de dirección active requisitos en currently_. |
address_ | Es probable que el error en la coincidencia de direcciones active requisitos en currently_ |
Números de documentos de identidad de prueba
Usa estos números de identificación personal para el atributo individual.id_number en Account o el atributo id_number en el objeto Person para activar ciertas condiciones de verificación.
| Número | Tipo |
|---|---|
000000000 | Coincidencia exitosa de números de ID. 0000 también funciona para la verificación de los cuatro últimos dígitos del SSN. |
111111111 | Error en la coincidencia de números de ID (error de coincidencia de identidad) que puede activar los requisitos en currently_. |
222222222 | Coincidencia inmediata y correcta del número de ID. 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 el número de identificación coincida correctamente. Puedes usar una imagen no verificada que haga que el número de identificación no coincida y que exija requisitos de currently_.
Nota
Las imágenes de prueba tienen prioridad sobre los números de identificación de la prueba. Si subes una imagen verificada, la coincidencia del número de ID se efectuará correctamente, incluso si también proporcionas un valor de ID de prueba sin éxito. Del mismo modo, una imagen no verificada falla automáticamente en la coincidencia de ID 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_ | 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
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_.
Asegúrate de comenzar con un token de dirección que tenga la condición de validación menos permisiva que desees 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 anteriormente. 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 requirements. |
address_ | En la cuenta no se habilitan ni cargos ni transferencias. Debido a que falló la validación, los atributos de la dirección vuelven a incluirse en el hash requirements. |
ID fiscales de la empresa de prueba
Usa estos números de identificación fiscal de la empresa para company.tax_id a fin de activar determinadas 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 las normativas 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 | Coincidencia exitosa del número de ID de la empresa. |
000000001 | El número de identificación de la empresa coincide con el de una organización sin fines de lucro. |
111111111 | Error en la coincidencia del número de identificación de la empresa (error de coincidencia de identidad). |
111111112 | Error en la coincidencia del número de identificación de la empresa (identificación fiscal no emitida). |
222222222 | Coincidencia inmediata y exitosa del número de identificación de la empresa. 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 first_name en el atributo Person asociado y estableciendo el atributo relationship.director en el atributo Person a verdadero.
| Token | Tipo |
|---|---|
mismatch_ | Error en la coincidencia debido a que el nombre no coincide. Esto puede desencadenar un error de verificación verification_. |
missing_ | Error en la coincidencia debido a la falta de directores en la cuenta. Esto puede desencadenar un error de verificación verification_. |
extraneous_ | Error en la coincidencia debido a que hay demasiados directores en la cuenta. Esto puede desencadenar un error de verificación 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 con este token para el atributo company.name.
| Token | Tipo |
|---|---|
mismatch_ | Error en la coincidencia debido a que el nombre de la empresa no coincide. |
disallowed_ | Error en la coincidencia debido a un nombre genérico o reconocido de la empresa. |
match_ | Coincidencia exitosa del nombre de la empresa. |
match_ | Error en la coincidencia 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.card_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 del nombre comercial 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_. |
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 a todos los objetos Capability inactivos de un objeto Account mediante el uso de este token para el atributo business_profile.url.
| Token | Tipo |
|---|---|
https://inactivity. | Configura una cuenta como inactiva y pausa todas sus verificaciones. Establece el motivo de deshabilitación de las funcionalidades inactivas en paused. (rejected. para 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
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 las transferencias.
Activar la verificación de titularidad de la cuenta bancaria
Las cuentas conectadas en Estados Unidos y la India están sujetas a la verificación de titularidad de la cuenta bancaria. Puedes completar esta verificación subiendo documentos de respaldo con el Dashboard de Connect o con la API a través del 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 |
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_ | Efectuado correctamente |
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 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.
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.