Integra tu cuenta conectada

Integra tus cuentas conectadas a tu Marketplace.

Después de crear y completar previamente una cuenta conectada, crea un enlace de Account y envíaselo al usuario para que pueda completar el proceso de onboarding. Un enlace de Account es una URL de un solo uso que envías a una cuenta conectada para darle acceso al flujo de onboarding de Connect.

Como alternativa, también puedes crear un flujo de onboarding personalizado a partir decomponentes integrados o la API. Para simplificar el cumplimiento de la normativa y el mantenimiento, utiliza enlaces de Accounts o crea tu propio flujo de onboarding con componentes integrados. En esta guía, se utilizan enlaces de Account.

El flujo de onboarding de Connect no le solicita a tu cuenta conectada ninguna información que hayas completado previamente, pero sí le solicita a la cuenta conectada que confirme la información completada previamente antes de aceptar el Contrato de servicios de Connect.

Nota

El onboarding alojado por Stripe solo se admite en navegadores web. No puedes usarlo en vistas web integradas dentro de aplicaciones móviles o de escritorio.

Crear un enlace de Account

Parámetro	Valor	¿Obligatorio?	Descripción
account	El ID de la cuenta conectada	Sí	Establece esto en el ID de la cuenta conectada para la que estás creando un enlace de Account.
return_url	Una URL válida	Sí	La URL a la que se redirige al usuario después de que abandone o complete el flujo de onboarding.
refresh_url	Una URL válida	Sí	La URL a la que redirigir al usuario si el enlace de Account venció, se visitó con anterioridad o no es válida. Usa esta URL para generar un nuevo enlace de Account con los mismos parámetros que usaste para crear el enlace de Account original.
tipo	`account_onboarding`	Sí	Proporciona un formulario para recopilar la información nueva que necesitas.

Redirigir al usuario a la URL del enlace de cuenta

La respuesta a tu solicitud de enlaces de Account incluye un valor para la url clave. Redirige a este enlace para enviar la cuenta conectada al flujo de onboarding.

Las URL de la API Account Links son temporales y solo se pueden usar una vez porque dan acceso a los datos personales del usuario de la cuenta conectada. Autentica al usuario en tu solicitud antes de redirigirlo a esta URL. Si quieres completar previamente la información, debes hacerlo antes de generar el enlace de Account. Una vez creado el enlace de Account, ya no puedes leer ni escribir información para la cuenta conectada.

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 retorno del usuario a tu 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 remitido a tu plataforma. Es importante implementarlas correctamente para brindarle la mejor experiencia al usuario.

Nota

Puedes usar HTTP para tu return_url y refresh_url mientras estás en un entorno de prueba (por ejemplo, para probar con localhost), pero el modo activo solo acepta HTTPS. Asegúrate de cambiar las URL de prueba por URL HTTPS antes de pasar a modo activo.

Establecer la URL de retorno

Stripe redirige la cuenta conectada a la return_url cuando completa el flujo de onboarding o hace clic en Guardar para después en cualquier momento del flujo. Esto no significa que se recopiló toda la información o que no hay requisitos pendientes en la cuenta. Solo significa que la entrada y salida del flujo se realizó correctamente.

No se especifica ningún estado con esta URL. Después de redirigir una cuenta conectada a la return_url, determina si la cuenta completó el onboarding de las siguientes maneras:

Recuperación de la cuenta y comprobación del hash de requisitos en busca de requisitos pendientes.
Presta atención al evento account.updated enviado a tu punto de conexión de webhook y almacena en caché el estado de la cuenta en tu solicitud. Si la cuenta no completó el proceso de onboarding, proporciona indicaciones en tu solicitud para que se pueda retomar en otro momento.

Establece la URL actualizada

Stripe redirige a tu usuario a la refresh_url en estos casos:

El enlace venció (transcurrieron algunos minutos desde la creación del enlace).
El usuario ya visitó la URL (el usuario actualizó la página o se desplazó de página en el navegador).
Tu plataforma ya no puede acceder a la cuenta.
El enlace se compartió en una aplicación de terceros, como un cliente de mensajería que intenta acceder a la URL para obtener una vista previa. Muchos clientes visitan automáticamente enlaces, lo que hace que un enlace de Account se venza.
La cuenta ha sido rechazada.

Configura la refresh_url para llamar a un método en tu servidor y así, volver a llamar a Account Links y crear un nuevo enlace de cuenta con los mismos parámetros y, luego, redirigir la cuenta conectada a la nueva URL del Account Links.

Gestiona los usuarios que no completaron el proceso de onboarding.

Un usuario que es redirigido a tu return_url puede no haber completado el proceso de onboarding. Para ver si un usuario completó el proceso de onboarding, recupera la cuenta del usuario y verifica que details_submitted esté establecido en true. Si details_submitted es false, la cuenta aún no se integró por completo. Proporciona indicaciones de interfaz de usuario en tu solicitud para que el usuario pueda continuar el onboarding más tarde. El usuario puede completar la activación de su cuenta a través de un nuevo enlace de Account generado por tu integración.

Próximos pasos

A continuación, habilita los métodos de pago que quieras admitir.