Cómo usar Connect con cuentas Standard
Una cuenta Standard es una cuenta convencional de Stripe en la que el titular (es decir, el usuario de tu plataforma) tiene una relación con Stripe, puede iniciar sesión en el Dashboard y puede procesar cobros por su cuenta.
El modelo de integración de Stripe, Kavholm, te muestra cómo usar el onboarding de Connect para tener una experiencia de onboarding de usuarios fluida.
Empezar
Si eres nuevo en Connect, comienza con una guía sobre el uso de cuentas Standard para habilitar a otras empresas a aceptar pagos directamente.
Cómo usar el onboarding de Connect para cuentas Standard
Ve a la página de configuración de Connect para personalizar el aspecto del formulario con el nombre, el color y el ícono de tu marca. El onboarding de Connect necesita esta información.
Usa la API
/v1/accounts
para crear una cuenta nueva y obtener el ID de la cuenta. Puedes completar la información del objeto Account para el usuario automáticamente antes de generar el enlace de cuenta. Debes especificar el siguiente parámetro:type
=standard
Nota
Después de crear una cuenta nueva, comprueba que esta figure en el Dashboard.
Llama a la API de Account Links para crear un enlace para realizar el onboarding con la cuenta.
En el flujo de onboarding de tu plataforma, redirige al usuario a la
url
devuelta por Account Links.Para gestionar otros estados de la cuenta, redirige la cuenta al flujo del onboarding de Connect, en caso de ser necesario.
Opcional: Puedes agregar procedimientos adicionales, como Tax o Climate, al proceso de onboarding de Connect a través de la configuración del producto de la plataforma en el Dashboard.
Crear una cuenta Standard y completar automáticamente la información
Utiliza la API Create Account para crear una cuenta conectada con type
establecido en standard
. Puedes completar previamente cualquier información, pero como mínimo, debes especificar el type
. El país de la cuenta por defecto es el mismo que el de tu plataforma, y la cuenta confirma la selección durante el onboarding.
Nota
En este ejemplo, se incluyen solo algunos de los campos que puedes establecer cuando creas una cuenta. Para ver una lista completa de los campos que puedes establecer, como address
y website_url
, consulta la referencia de la API Create Account.
Si ya recopilaste información para tus cuentas conectadas, puedes completar automáticamente esa información en el objeto Account. Puedes completar automáticamente todo tipo de información de la cuenta, por ejemplo, los datos personales y de la empresa, la información externa de la cuenta y más.
El onboarding de Connect no solicita la información que se completó automáticamente. Sin embargo, sí le pide al titular de la cuenta que confirme esta información antes de aceptar el contrato de servicio de Connect.
Cuando pruebes la integración, completa automáticamente la información de la cuenta con los datos de prueba.
Crear un enlace de cuenta
Puedes crear un enlace de la cuenta llamando a la API Account Links con los siguientes parámetros:
account
- usa el ID de cuenta recibido de la API en el paso anteriorrefresh_url
return_url
type
=account_onboarding
Redirigir al usuario a la URL del enlace de cuenta
La respuesta a tu solicitud de Account Links incluye un valor para la clave url
. Para enviar al usuario al flujo, redirígelo a este enlace. Solo puedes usar las URL de los enlaces de cuenta una vez, ya que otorgan acceso a los datos personales del titular de la cuenta. Autentica al usuario en tu aplicación antes de redirigirlo a esta URL. Después de crear un enlace de cuenta en una cuenta Standard, no podrás leer ni escribir los datos de Conoce a tu cliente (KYC). Completa automáticamente toda la información de KYC antes de crear el primer enlace de cuenta.
Consejo de seguridad
No envíes por correo electrónico, ni por mensaje de texto ni por ningún otro medio las URL del enlace de la cuenta fuera de la aplicación de la plataforma. En lugar de eso, envíalas al titular de la cuenta autenticado dentro de tu aplicación.
Gestionar el caso de un usuario que vuelve a la plataforma
El onboarding de Connect te exige especificar una return_url
y una refresh_url
para gestionar todos los casos en que el usuario es redirigido a tu plataforma. Es importante implementarlas correctamente para brindarle la mejor experiencia al usuario.
Nota
Puedes usar HTTP en las direcciones return_url
y refresh_url
si estás en modo de prueba (por ejemplo, para probar con localhost), pero en modo activo, solo se aceptará HTTPS. Asegúrate de cambiar las URL de prueba por direcciones URL HTTPS antes de pasar a modo activo.
return_url
Stripe redirige a esta URL cuando el usuario completa el flujo de onboarding de Connect. Esto no implica que se haya recopilado toda la información o que no haya requisitos pendientes en la cuenta. Simplemente significa que se ingresó y se salió del flujo correctamente.
No state is passed through this URL. After redirecting a user to your return_url
, check the state of the details_submitted
parameter on their account by doing either of the following:
- Escuchando los webhooks
account.updated
- Llamando a la API Accounts e inspeccionando el objeto devuelto
refresh_url
Tu usuario será redirigido a la refresh_url
en estos casos:
- The link expired (a few minutes went by since the link was created)
- The user already visited the link (they refreshed the page, or clicked back or forward in the browser)
- Tu plataforma ya no puede acceder a la cuenta
- La cuenta ha sido rechazada
Your refresh_url
triggers a method on your server to call Account Links again with the same parameters, and redirect the user to the Connect Onboarding flow to create a seamless experience.
Gestionar los casos de usuarios que no han completado el onboarding
Es posible que un usuario redirigido a tu return_url
no haya completado el proceso de onboarding. Usa el punto de conexión /v1/accounts
para recuperar la cuenta del usuario y comprueba charges_enabled
. Si la cuenta no ha finalizado todo el proceso de onboarding, presenta un mensaje de interfaz de usuario para que el usuario pueda continuarlo más tarde. Podrá completar la activación de su cuenta con un nuevo enlace de cuenta (generado por tu integración). Puedes verificar el estado del parámetro details_submitted
en su cuenta para ver si se completó la activación.