# Cómo usar Connect con cuentas conectadas Express Las cuentas Express conectadas le permiten a tu plataforma administrar calendarios de transferencias, personalizar el flujo de fondos y controlar la imagen de marca. Stripe se encargará del onboarding, la gestión de cuentas y la verificación de identidad. > #### Nuevas integraciones de Connect > > La información de esta página solo se aplica a plataformas que ya usan tipos de cuentas conectadas heredadas. Si estás configurando una nueva plataforma Connect o tu integración usa la API Accounts v2, consulta [Configurar el comportamiento de cuentas conectadas](https://docs.stripe.com/connect/accounts-v2/connected-account-configuration.md) para obtener más información sobre las configuraciones de cuentas conectadas. Si tu integración usa la API Accounts v1, consulta [Propiedades del controlador de cuentas](https://docs.stripe.com/connect/migrate-to-controller-properties.md#account-controller-properties). ## 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](https://rocketrides.io/) antes de comenzar a desarrollar el tuyo. La demo incluye un ejemplo de una experiencia de onboarding de cuentas conectadas y gestión de cuentas para Rocket Rides, un marketplace on demand. Puedes buscar el [código fuente completo](https://github.com/stripe/stripe-connect-rocketrides) de la demostración en GitHub. ![Rocket Rides, una demostración de Stripe Connect con cuentas conectadas Express](https://b.stripecdn.com/docs-statics-srv/assets/rocket-rides-new.e01ced22698d7f5d3d1c915f26175dcd.png) ## Before you begin Para crear cuentas conectadas Express, debes cumplir todos los siguientes requisitos: - **Versión mínima de API**: Las cuentas conectadas Express requieren la versión de API 2017-05-25 o posterior. Las [Funcionalidades](https://docs.stripe.com/connect/account-capabilities.md) 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](https://stripe.com/global). 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](connect@stripe.com). - **Países que no admiten el autoservicio**: debido a las restricciones que se aplican al usar Connect en los [Emiratos Árabes Unidos](https://support.stripe.com/questions/connect-availability-in-the-uae) y [Tailandia](https://support.stripe.com/questions/stripe-thailand-support-for-marketplace), los usuarios de la plataforma en estos países no pueden usar el autoservicio para las cuentas conectadas de Express. Para iniciar el onboarding de cuentas conectadas de Express en estos países, [ponte en contacto con nosotros](https://stripe.com/contact/sales). - **Plataformas en los EAU**: las plataformas en los Emiratos Árabes Unidos solo pueden usar cuentas conectadas Express con sede en los EAU con los siguientes tipos de cargos: [destination_charges](https://docs.stripe.com/connect/destination-charges.md) y [separate charges and transfers](https://docs.stripe.com/connect/separate-charges-and-transfers.md). Los cargos de destino (destination charges) que utilizan el atributo [on_behalf_of](https://docs.stripe.com/api/payment_intents/object.md#payment_intent_object-on_behalf_of) aún no son compatibles con las plataformas de los EAU. - **Verificación por fraude**: debido a que tu plataforma es responsable de las pérdidas en las cuentas Express conectadas, 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](https://docs.stripe.com/connect/risk-management/best-practices.md#fraud) a fin de obtener más información. - **Perfil de la plataforma**: debes completar el [perfil de tu plataforma](https://dashboard.stripe.com/connect/registration). ## Onboarding de cuentas Express conectadas fuera del país de tu plataforma Puedes habilitar el onboarding por país en la sección [Configuración de Connect](https://dashboard.stripe.com/account/applications/settings) 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](https://docs.stripe.com/connect/charges.md) 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](https://docs.stripe.com/connect/service-agreement-types.md#recipient) con el objeto de habilitar [envíos de fondos transfronterizos](https://docs.stripe.com/connect/account-capabilities.md#transfers-cross-border). 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](https://dashboard.stripe.com/account/applications/settings) 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. ## Crea una cuenta conectada Express y completa la información automáticamente Usa la API [Create Account](https://docs.stripe.com/api/accounts/create.md) para crear una cuenta conectada cuyo `type` esté 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 el onboarding. > En este ejemplo, se incluyen solo algunos de los campos que puedes configurar al crear una cuenta. Para obtener una lista completa de los campos que puedes configurar, como `address` y `website_url`, consulta la [referencia sobre la API Create Account](https://docs.stripe.com/api/accounts/create.md). ```curl curl https://api.stripe.com/v1/accounts \ -u "<>:" \ -d type=express ``` Si conoces el país y las [funcionalidades](https://docs.stripe.com/connect/account-capabilities.md) de tu cuenta conectada, puedes proporcionar esa información al crear la cuenta. A continuación, el onboarding de Connect recopilará todo lo necesario para esas funcionalidades. Para reducir las tareas de onboarding, solicita únicamente las funcionalidades que necesites. ```curl curl https://api.stripe.com/v1/accounts \ -u "<>:" \ -d country=US \ -d type=express \ -d "capabilities[card_payments][requested]"=true \ -d "capabilities[transfers][requested]"=true \ -d business_type=individual \ --data-urlencode "business_profile[url]"="https://example.com" ``` Si ya recopilaste información para tus cuentas conectadas, puedes completar automáticamente esa información en el objeto `Account`. Puedes completar previamente cualquier información de la cuenta, incluida la información personal y de la empresa, la información de la cuenta externa, etc. Después de crear la `cuenta`, crea una [persona](https://docs.stripe.com/api/persons/create.md) que represente a la persona responsable de abrir la cuenta, con `relationship.representative` establecido en verdadero y cualquier información de la cuenta que quieras completar previamente (por ejemplo, su nombre y apellido). ```curl curl https://api.stripe.com/v1/accounts/{{ACCOUNT_ID}}/persons \ -u "<>:" \ -d first_name=Jenny \ -d last_name=Rosen \ -d "relationship[representative]"=true ``` 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 la información completada automáticamente antes de aceptar el [contrato de servicio de Connect](https://docs.stripe.com/connect/service-agreement-types.md). Cuando integres una cuenta sin su propio sitio web y tu plataforma le proporcione una URL personal, completa previamente su `business_profile.url`. Si la cuenta no tiene una URL, puedes completar previamente su `business_profile.product_description` en su lugar. Cuando pruebes la integración, completa automáticamente la información de la cuenta con los [datos de prueba](https://docs.stripe.com/connect/testing.md). Si omites `capabilities`, el onboarding de Connect usa los parámetros de la sección [Parámetros de configuración](https://dashboard.stripe.com/account/applications/settings/express) 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](https://docs.stripe.com/api/account_links/create.md) con los siguientes parámetros: - `account` - usa el ID de cuenta recibido de la API en el paso anterior - `refresh_url` - `return_url` - `type` = `account_onboarding` ```curl curl https://api.stripe.com/v1/account_links \ -u "<>:" \ -d account="{{CONNECTEDACCOUNT_ID}}" \ --data-urlencode refresh_url="https://example.com/reauth" \ --data-urlencode return_url="https://example.com/return" \ -d type=account_onboarding ``` ## Redirige tu cuenta a la URL del enlace de la cuenta Un objeto [Account Link](https://docs.stripe.com/api/account_links/object.md) contiene una `url`. Redirige la cuenta a este enlace para enviarla al flujo de onboarding. Cada URL de [Account Link](https://docs.stripe.com/api/account_links.md) 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 conectada Express, completa automáticamente la información de [Conoce a tu cliente](https://support.stripe.com/questions/know-your-customer) (KYC). Después de crear un enlace de cuenta para una cuenta conectada Express, no puedes leer ni actualizar su información de KYC. > 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. ## Gestiona el retorno de la cuenta conectada a tu plataforma El onboarding de Connect requiere que especifiques una `return_url` y una `refresh_url` para gestionar todos los casos en los que se redirige a la cuenta conectada a tu plataforma. Es importante implementarlas correctamente para que la cuenta conectada tenga la mejor experiencia. > 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. #### return_url Stripe redirige al usuario a esta URL cuando la cuenta conectada completa el flujo de onboarding de Connect. Esto no implica que se haya recopilado toda la información ni que no haya requisitos pendientes en la cuenta. Solo significa que se entró y se salió del flujo correctamente. No se transmite ningún estado a través de esta URL. Después de redirigir una cuenta conectada 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](https://docs.stripe.com/connect/webhooks.md). - [Recupera](https://docs.stripe.com/api/accounts/retrieve.md) la cuenta con la API. #### refresh_url Tu cuenta conectada será redirigida a la `refresh_url` en los siguientes casos: - Se venció el enlace (pasaron algunos minutos desde la creación del enlace). - Ya visitaron 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. - La cuenta ha sido rechazada. Configura tu `refresh_url` para activar un método en tu servidor para volver a llamar a [Account Links](https://docs.stripe.com/api/account_links.md) con los mismos parámetros y redirige la cuenta conectada al flujo Connect Onboarding para crear una experiencia fluida. ## Gestiona las cuentas conectadas que no han completado el onboarding. Una cuenta conectada que es redirigida a tu `return_url` puede no haber completado el proceso de onboarding. [Recupera](https://docs.stripe.com/api/accounts/retrieve.md) la cuenta del usuario y verifica `charges_enabled`. Si no se completó el onboarding, proporciona 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 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. ## See also - [Dashboard de Express](https://docs.stripe.com/connect/express-dashboard.md) - [Integrar el Dashboard de Express](https://docs.stripe.com/connect/integrate-express-dashboard.md) - [Personalizar el Dashboard de Express](https://docs.stripe.com/connect/customize-express-dashboard.md)