Cómo usar Connect con cuentas Express
Demostración de Express
Para ver cómo funciona el flujo completo de onboarding de Express, prueba este modelo de integración de Express de extremo a extremo antes de comenzar a desarrollar el tuyo. La demo incluye un ejemplo de una experiencia de onboarding de usuarios y gestión de cuentas para Rocket Rides, un marketplace on demand.
Puedes buscar el código fuente completo de la demostración en GitHub.
Antes de comenzar
Para crear cuentas Express, debes cumplir los siguientes requisitos:
- Versión mínima de API: Express necesita la versión 2017-05-25 o posterior. Las funcionalidades en Express requieren la versión 2019-02-19 o posterior.
- Plataforma en un país admitido: Las plataformas en Alemania, Australia, Austria, Bélgica, Brasil, Bulgaria, Canadá, Chipre, Croacia, Dinamarca, Eslovaquia, Eslovenia, España, Estados Unidos, Estonia, Finlandia, Francia, Grecia, Hong Kong, Hungría, Irlanda, Italia, Japón, Letonia, Lituania, Luxemburgo, Malta, México, Noruega, Nueva Zelanda, Países Bajos, Polonia, Portugal, Reino Unido, República Checa, Rumania, Singapur, Suecia, Suiza y Tailandia pueden crear cuentas Express para la mayoría de los países Compatibilidad con Stripe. Si quieres recibir información sobre las restricciones específicas de cada país o si deseas que te notifiquemos cuando las cuentas Express estén disponibles en tu país, ponte en contacto con nosotros.
- Países que no admiten el autoservicio: debido a las restricciones que se aplican al usar Connect en los Emiratos Árabes Unidos y Tailandia, los/las usuarios/as de la plataforma en estos países no pueden usar el autoservicio para las cuentas de Express Connect. Para iniciar el onboarding de cuentas Express en estos países, ponte en contacto con nosotros.
- Plataformas en los Emiratos Árabes Unidos: las plataformas en los Emiratos Árabes Unidos (EAU) solo pueden usar cuentas Express establecidas en los EAU con los siguientes tipos de cargos: destination_charges y cargos y envíos de fondos separados. Los cargos a un destino que utilizan el atributo on_behalf_of aún no se admiten para las plataformas de los EAU.
- Verificación por fraude: debido a que tu plataforma es responsable de las pérdidas en las cuentas Express, debes examinar de cerca todas las cuentas que se creen a través de tu plataforma para detectar posibles fraudes. Consulta nuestra guía de prácticas recomendadas para la gestión de riesgos a fin de obtener más información.
- Perfil de la plataforma: debes completar el perfil de tu plataforma.
Cómo activar cuentas Express fuera del país de tu plataforma
Puedes habilitar el onboarding por país en la sección Configuración de Connect del Dashboard.
El flujo de onboarding de las cuentas Express ha sido localizado en inglés, francés, español, búlgaro, chino simplificado, chino tradicional, checo, danés, neerlandés, estonio, finlandés, alemán, griego, húngaro, indonesio, italiano, japonés, letón, lituano, noruego, polaco, portugués, rumano, eslovaco, esloveno, sueco y tailandés.
Cuando actives cuentas de otros países, ten en cuenta lo siguiente:
- Empresa internacional: tu plataforma es responsable de comprender las implicaciones de hacer negocios en todo el mundo, por ejemplo, en lo que respecta a declaraciones fiscales e informes financieros.
- Flujos de pago: asegúrate de revisar tus opciones para crear cargos en función de los países donde quieres operar.
- Tipo de contrato de servicio: Tu plataforma puede crear cuentas conectadas conforme al contrato de servicio para beneficiarios con el objeto de habilitar envíos de fondos transfronterizos. Estas cuentas tienen acceso restringido a las funcionalidades.
Configura la experiencia de onboarding
Antes de hacer el onboarding de tu primera cuenta, 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 requiere esta información.
Crear una cuenta Express y completar la información automáticamente
Utiliza la API Create Account para crear una cuenta conectada con type
establecido en express
. 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 la activación.
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 conoces el país y las funcionalidades de tu cuenta conectada, puedes proporcionar esa información cuando creas la cuenta. Luego, el onboarding de Connect recopilará todo lo necesario para esas funcionalidades. A fin de reducir la carga de trabajo del onboarding, solicita únicamente las funcionalidades que necesites.
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 haces el onboarding de una cuenta sin su propio sitio web y tu plataforma le proporciona una URL personal, completa automáticamente su business_profile.url
. Si la cuenta no tiene una URL, puedes completar automáticamente su business_profile.product_description
.
Cuando pruebes la integración, completa automáticamente la información de la cuenta con los datos de prueba.
Si omites capabilities
, el onboarding de Connect usa los parámetros de la sección Parámetros de configuración del Dashboard de Stripe para solicitar funcionalidades automáticamente según el país de la cuenta.
Crear un enlace de cuenta
Crea un objeto Account Link 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
Redirige tu cuenta a la URL del enlace de la cuenta
Un objeto Account Link contiene una url
. Redirige la cuenta a este enlace para enviarla al flujo de onboarding. Cada URL de Account Link solo se puede usar una vez, ya que otorga acceso a los datos personales del titular de la cuenta. Autentica la cuenta en tu aplicación antes de redirigirla a esta URL.
Antes de crear el primer enlace de cuenta para una cuenta Express, completa automáticamente la información de Conoce a tu cliente (KYC). Después de crear un enlace de cuenta para una cuenta Express, no puedes leer ni actualizar su información de KYC.
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
You can use HTTP for your return_url
and refresh_url
while in test mode (for example, to test with localhost), but live mode only accepts HTTPS. Be sure to swap testing URLs for HTTPS URLs before going live.
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 se transmite ningún estado a través de esta URL. Después de redirigir al usuario a tu return_url
, verifica el estado del parámetro details_submitted
en su cuenta por medio de uno de los siguientes métodos:
- Escucha los eventos
account.updated
con un webhook de Connect. - Recupera la cuenta con la API.
refresh_url
Tu usuario será redirigido a la refresh_url
en estos casos:
- Se venció el enlace (pasaron algunos minutos desde la creación del enlace).
- The user already visited the URL (the user 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.
La refresh_url
debe activar un método que le permita a tu servidor volver a llamar a Account Links con los mismos parámetros y redirigir al usuario al flujo de onboarding de Connect para crear una experiencia fluida.
Gestionar usuarios que no han completado el onboarding
Un usuario que es redirigido a tu return_url
puede no hacer completado el proceso de onboarding. Recupera la cuenta del usuario y verifica charges_enabled
. Si no se completó la activación, proporcione solicitudes de IU para que el usuario pueda continuar el onboarding más tarde. Puede completar la activación de la cuenta a través de un nuevo enlace de la cuenta (generado por tu integración). Puedes verificar el estado del parámetro details_submitted
en su cuenta para ver si ha completado el proceso de onboarding.