# Diseña una integración de Connect avanzada con la API Accounts v1 Conoce las combinaciones de configuración alternativas para una integración de Connect basada en la API Accounts v1. > #### Integraciones de API Accounts v2 > > Esta guía solo se aplica a las plataformas Connect existentes que usan la API Accounts v1. Si eres un nuevo usuario Connect, usa la API Accounts v2. Consulta la [Guía interactiva de la plataforma](https://docs.stripe.com/connect/interactive-platform-guide.md) para obtener información sobre cómo configurar una plataforma Connect usando la API Accounts v2. Usa esta guía para explorar las diferentes integraciones de Connect y crear una lista de pasos de integración personalizados. Antes de comenzar tu integración en un *entorno de prueba* (A sandbox is an isolated test environment that allows you to test Stripe functionality in your account without affecting your live integration. Use sandboxes to safely experiment with new features and changes), debes [crear una cuenta de Stripe o iniciar sesión](https://dashboard.stripe.com) e [integrar tu plataforma a Connect](https://dashboard.stripe.com/settings/connect/platform-profile). ## Seleccionar propiedades ### Crea e integra cuentas Stripe te permite crear cuentas en nombre de usuarios, denominadas cuentas conectadas. Cuando usas Connect, creas cuentas conectadas para cada usuario que recibe dinero en tu plataforma. #### Item 1 Envía las cuentas conectadas a un flujo de onboarding alojado en Stripe. El onboarding alojado en Stripe te permite redirigir al usuario a Stripe para que complete el proceso de onboarding en una interfaz de marca compartida. ![Captura de pantalla del formulario de Onboarding de Connect](https://b.stripecdn.com/docs-statics-srv/assets/Kavholm-Seamless-Standard.78b64d90c0bf87130c8b6ba1ef53df7f.png) Ideal para cuando quieras hacer lanzamientos rápidos con el menor esfuerzo de integración: - Las cuentas conectadas abandonan tu sitio y son redirigidas a Stripe para completar el flujo. - Imagen de marca compartida con Stripe y opciones limitadas de personalización. - Stripe gestiona toda la lógica del flujo de onboarding. - Admite automáticamente más de 46 países y 14 idiomas. #### Item 2 Integra una interfaz de usuario de onboarding muy personalizable con una imagen de marca limitada de Stripe directamente en tu aplicación. Los usuarios de las cuentas conectadas interactúan con el componente integrado sin salir de la aplicación. Puedes incluir el onboarding integrado con unas pocas líneas de código. Note: The following is a preview/demo component that behaves differently than live mode usage with real connected accounts. The actual component has more functionality than what might appear in this demo component. For example, for connected accounts without Stripe dashboard access (custom accounts), no user authentication is required in production. Ideal para cuando quieres mantener a los usuarios en tu sitio con una experiencia más integrada y un esfuerzo de integración bajo: - Las cuentas conectadas permanecen en tu sitio. - Se puede tematizar. Limitado a la ausencia de imagen de marca de Stripe. - Stripe gestiona toda la lógica del flujo de onboarding. - Admite automáticamente más de 46 países y 14 idiomas. #### Item 3 Crea cada aspecto del flujo de onboarding llamando a las API de Stripe correspondientes. Debes crear una lógica personalizada en tu integración para satisfacer toda la información de verificación requerida. > #### Recomendación de Stripe > > Crear y mantener un flujo de onboarding de API requiere muchos recursos y actualizaciones periódicas. Si quieres implementar un flujo de onboarding personalizado, Stripe te recomienda encarecidamente que uses el [onboarding integrado](https://docs.stripe.com/connect/embedded-onboarding.md). (See full diagram at https://docs.stripe.com/connect/design-an-integration) Ideal para cuando quieres tener un control total sobre el flujo de onboarding: - Crea y mantén toda la lógica del flujo de onboarding por tu cuenta. Puede requerir muchos recursos y ser costoso de desarrollar. - Gestionas el riesgo con total responsabilidad por los pasivos de saldo negativo en las cuentas conectadas. - Debes mantener tus flujos actualizados a medida que cambian los requisitos de verificación, y también crear flujos adicionales para comunicar y recopilar dichos requisitos de tus usuarios. Revisa y actualiza los requisitos de onboarding por lo menos cada seis meses para asegurarte de incorporar los requisitos más recientes en tu flujo. - Debes crear un formulario personalizado para recopilar cuentas bancarias o tarjetas de débito para que las cuentas conectadas se puedan configurar con una cuenta para transferencias. ### Configura los flujos del Dashboard Las cuentas conectadas necesitan acceso a un Dashboard para gestionar su cuenta. Proporciona a las cuentas conectadas acceso al Dashboard de Stripe, al Dashboard de Express o a un Dashboard creado con la API de Stripe y componentes integrados. #### Item 1 Proporciona acceso al Dashboard de Stripe a las cuentas conectadas. El Dashboard de Stripe proporciona a las cuentas conectadas un conjunto completo de funciones, que incluyen la visualización de transferencias, la gestión de reembolsos, la gestión de disputas, el acceso a informes y el procesamiento de cargos por su cuenta. Los usuarios pueden iniciar sesión en el Dashboard de Stripe en cualquier momento y pueden acceder al Dashboard visitando Stripe directamente. Los usuarios tienen acceso al soporte de Stripe, y Stripe puede comunicarse con ellos en relación con sus cuentas. Usa el Dashboard de Stripe cuando: - Tus usuarios necesitan acceso a potentes flujos de trabajo de pago y a funciones avanzadas de gestión de usuarios. - Prefieres que Stripe gestione el riesgo de pérdida y asuma la responsabilidad por el pasivo por saldo negativo en las cuentas conectadas. - Te sientes cómodo con imágenes de marca de Stripe e imágenes de marca compartida de plataforma limitada. Siempre puedes agregar [componentes integrados](https://docs.stripe.com/connect/get-started-connect-embedded-components.md) a tu propio sitio web además de proporcionar acceso al Dashboard de Stripe. #### Item 2 Proporciona acceso al Dashboard de Express para que las cuentas conectadas gestionen su cuenta. El Dashboard de Express permite que las cuentas conectadas vean el saldo disponible y las próximas transferencias y hagan un seguimiento de sus ganancias en tiempo real. Los usuarios no pueden gestionar rembolsos ni disputas a través del Dashboard de Express. Los usuarios tienen acceso al soporte de Stripe, y Stripe puede comunicarse con ellos en relación con sus cuentas. Utiliza el Dashboard de Express cuando: - Tus usuarios son vendedores de marketplace que necesitan un acceso limitado a los flujos de trabajo. - A estos usuarios se les envían principalmente las transferencias. Los usuarios no gestionarán los reembolsos ni las disputas en forma directa. - Debes personalizar por completo el aspecto del dashboard. - Te sientes cómodo asumiendo la responsabilidad de la responsabilidad por saldo negativo y gestionando el riesgo de pérdida en las cuentas conectadas. You can always add [Connect embedded components](https://docs.stripe.com/connect/get-started-connect-embedded-components.md) to your own website in tandem with providing access to the Stripe Dashboard. #### Item 3 Crea un Dashboard con las API de Stripe o los componentes integrados para permitir que las cuentas conectadas gestionen sus cuentas. Las cuentas conectadas no tendrán acceso al Dashboard de Stripe ni al Dashboard de Express. Depende de ti proporcionar acceso a estos flujos de trabajo mediante la creación del Dashboard del usuario, los reembolsos, los flujos de trabajo de disputas y la funcionalidad de informes de tu usuario. Es posible que tus usuarios no sepan que tienen una cuenta de Stripe a través de tu plataforma. Recomendamos integrar [componentes incrustados de Connect](https://docs.stripe.com/connect/get-started-connect-embedded-components.md) para añadir funcionalidad Dashboard a su aplicación de plataforma con un bajo esfuerzo de integración. Los componentes incrustados son altamente personalizables y pueden admitir cuentas conectadas con: - Flujos de trabajo de pagos, como la visualización de pagos y transferencias, la gestión de reembolsos y la respuesta a disputas. - Flujos de trabajo de transferencias, como la gestión de calendarios de transferencias, la creación de transferencias manuales o la actualización de cuentas de transferencia. - Flujos de trabajo de elaboración de informes para descargar y exportar pagos y transferencias - Flujos de trabajo de gestión de cuentas, como la actualización de la información de la empresa > For an account without Stripe-hosted Dashboard access where Stripe is liable for negative balances, use Connect embedded components to provide self-serve account updates. You can’t create [Account Links](https://docs.stripe.com/api/account_links.md) of type `account_update` for such accounts. ### Aceptar un pago Creas un cargo para aceptar un pago de un cliente en nombre de tu cuenta conectada. El tipo de cargo que creas: - Determina cómo se dividen los fondos de pagos entre todas las partes involucradas - Afecta cómo aparece el cargo en el extracto bancario o de facturación del cliente (con la información de tu plataforma o tu usuario). - Determina de qué cuenta Stripe debita los reembolsos y contracargos #### Item 1 Un cargo Direct es un pago de un cliente que se hace directamente a una cuenta conectada. Los clientes hacen la transacción directamente con tu cuenta conectada, a menudo sin saber que existe tu plataforma. Este tipo de cargo es el más adecuado para las plataformas que proporcionan software como servicio. Por ejemplo, Shopify proporciona herramientas para crear tiendas en línea, y Thinkific les permite a quienes ofrecen cursos de educación venderlos en línea. #### Item 2 Crea cargos de destino en tu plataforma y transfiere fondos de inmediato a las cuentas conectadas. Los clientes hacen la transacción con tu plataforma por los productos o servicios suministrados por tus cuentas conectadas. Este tipo de cargo es el más adecuado para plataformas como Airbnb, un marketplace de alquiler de alojamientos o Lyft, una aplicación de traslados compartidos. Los cargos a un destino se crean en la plataforma, pero, como parte de la operación del cargo, los fondos se transfieren inmediatamente a la cuenta conectada que especificaste. Puedes decidir si se transfieren algunos o todos los fondos. A menos que seas elegible para [pagos transfronterizos](https://docs.stripe.com/connect/cross-border-payouts.md), tu plataforma y la cuenta conectada a la que transfieres fondos deben estar en la misma región para crear un cargo a un destino. Intentar transferir fondos por una frontera no habilitada arroja un error. #### Item 3 Crea cargos y envíos de fondos separados para transferir fondos de un pago a varias cuentas conectadas, o cuando no se conozca a un usuario específico en el momento del cargo. El cargo en la cuenta de tu plataforma se desasocia de las transferencias a tus cuentas conectadas. Este tipo de cargo es el más adecuado para los marketplaces que tienen que dividir los pagos entre varias partes, por ejemplo DoorDash, que es una plataforma de entrega para restaurantes. Si bien los cargos y envíos de fondos separados ofrecen gran flexibilidad, requieren una integración más compleja para administrar los saldos de las cuentas entre tu plataforma y tus usuarios. Debes controlar atentamente el saldo de tu cuenta de plataforma para asegurarte de que tienes suficientes fondos disponibles para cubrir el importe del envío de fondos. A menos que seas elegible para [pagos transfronterizos](https://docs.stripe.com/connect/cross-border-payouts.md), tu plataforma y la cuenta conectada a la que transfieres fondos deben estar en la misma región para usar cargos y envíos de fondos separados. Intentar transferir fondos por una frontera no habilitada arroja un error. ### Comisiones de Stripe #### Item 1 Stripe cobra las comisiones de Stripe desde la cuenta de tu plataforma, incluidas las comisiones de procesamiento. Tú controlas los importes de comisiones de procesamiento que facturas a las cuentas conectadas. Usa el parámetro de comisiones de la aplicación para cobrar comisiones de procesamiento de tus cuentas conectadas. #### Item 1 (See full diagram at https://docs.stripe.com/connect/design-an-integration) #### Item 2 (See full diagram at https://docs.stripe.com/connect/design-an-integration) #### Item 3 (See full diagram at https://docs.stripe.com/connect/design-an-integration) #### Item 2 Stripe cobra las comisiones de Stripe directamente de tus cuentas conectadas. Puedes cobrar una comisión opcional de la aplicación cuando creas el cargo Direct. (See full diagram at https://docs.stripe.com/connect/design-an-integration) ### Transfiere fondos a tus usuarios Una vez que se acreditan los fondos del pago y la cuenta conectada del usuario tiene saldo positivo en Stripe, puedes transferir esos fondos a su cuenta externa. #### Item 1 Si integras usuarios en tu propio flujo utilizando la API de Stripe, también debes recopilar cuentas bancarias o tarjetas de débito para configurar tus cuentas conectadas con una cuenta de transferencias. Cuando hayas recopilado la información del usuario para la cuenta de transferencia, adjúntala como una cuenta externa. Las transferencias se bloquean si tu cuenta conectada no tiene una cuenta externa verificada. #### Item 2 #### Item 3 De forma predeterminada, Stripe transfiere los fondos que se han acreditado en los saldos de tus cuentas conectadas de forma diaria y continua. Si lo prefieres, puedes configurar diferentes calendarios de transferencias automáticas, activar las transferencias de forma manual en lugar de automática o transferir al instante. ### Responsabilidad por los saldos negativos #### Item 1 Tu plataforma es responsable de las pérdidas incurridas por saldos negativos en tus cuentas conectadas. Tu plataforma es responsable de revisar las nuevas cuentas conectadas durante el onboarding y de determinar el perfil de riesgo de tus usuarios. Recomendado para marketplaces que cobran pagos de compradores para pagarles a los vendedores o para plataformas avanzadas que quieren tener control total sobre cómo se gestionan los riesgos y las responsabilidades negativas en las cuentas conectadas: - Tu plataforma debe monitorear las cuentas conectadas para detectar el riesgo continuo de pérdida. - Tu plataforma tiene que crear flujos para comunicar y rectificar las cuentas conectadas cuando detectas fraude o riesgo. - Dispones tanto del equipo operativo como de los recursos de ingeniería necesarios para establecer procesos con el fin de gestionar el riesgo continuo de pérdida y prevenir el fraude. Antes de crear cuentas con esta configuración, considera y reconoce cuidadosamente las responsabilidades de tu plataforma en relación con los pasivos por saldo negativo. #### Item 2 Stripe monitorea las señales de riesgo en las cuentas conectadas, implementa intervenciones de riesgo en dichas cuentas en respuesta a las señales observadas y trata de recuperar los saldos negativos de tus cuentas conectadas. Para la mayoría de las plataformas de software como servicio, esta es la mejor opción predeterminada, especialmente para aquellas que son nuevas en la integración de pagos: - Stripe supervisa tus cuentas conectadas para detectar el riesgo crediticio y de fraude, así como para protegerse contra el riesgo de pérdida en caso de saldos negativos atribuidos al riesgo empresarial. - Stripe se encarga de todas las comunicaciones y correcciones de extremo a extremo directamente con tus cuentas conectadas a través de flujos alojados o componentes integrados. #### Item 1 #### Componentes integrados requeridos Cuando Stripe es responsable de los saldos negativos de tus cuentas conectadas, debes integrar componentes integrados para el onboarding, la gestión de cuentas y el banner de notificaciones. Stripe utiliza el componente de banner de notificación integrado para notificar a las cuentas conectadas sobre los requisitos pendientes u otras solicitudes relacionadas con el riesgo gestionado. El componente de gestión de cuentas es obligatorio para que tus cuentas conectadas puedan gestionar sus credenciales de autenticación y su información empresarial. Stripe también envía correos electrónicos en tu nombre a tus cuentas conectadas para gestionar el riesgo y confirmar el cumplimiento continuo de la normativa. Puedes personalizar estas comunicaciones por correo electrónico con tu propio dominio de correo electrónico y la imagen de marca de tu plataforma. Para otros componentes opcionales, también puedes usar [componentes integrados](https://docs.stripe.com/connect/get-started-connect-embedded-components.md) o crear tu propia interfaz de usuario. #### Item 2 #### Item 3 ## Pasos de integración para tus selecciones Los siguientes pasos de integración se basan en las opciones seleccionadas anteriormente. Puedes ver los diferentes pasos seleccionando diferentes opciones arriba o en el panel a la derecha de los pasos. Las opciones de esta página solo controlan los pasos que se muestran a continuación. No afectan a la configuración de tu plataforma. El siguiente botón genera un mensaje de LLM establecido en función de tus selecciones. Solo admite el Dashboard alojado de Stripe y la integración alojada.