# 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 les da a las cuentas conectadas acceso ilimitado a todo el conjunto de funcionalidades de Stripe mediante sus propias credenciales de inicio de sesión. Las cuentas conectadas pueden iniciar sesión directamente en dashboard.stripe.com en cualquier momento. Tienen acceso al soporte de Stripe, y Stripe puede comunicarse con ellas sobre su cuenta. Usa el Dashboard de Stripe cuando suceda lo siguiente con tus cuentas conectadas: - Necesiten administrar sus propias claves de API, webhooks o integraciones de desarrollador. - Requieran informes financieros detallados o exportaciones de datos. - Tengan equipos con diferentes necesidades de acceso (por ejemplo, roles separados de administrador y analista). - Usen Stripe Apps. 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 administren su cuenta. El Dashboard de Express es un Dashboard alojado por Stripe de funcionalidades limitadas que puedes personalizar con tu imagen de marca y configurando qué funcionalidades admite. Las cuentas conectadas que usan el Dashboard de Express tienen acceso al soporte de Stripe, y Stripe puede comunicarse con ellas sobre su cuenta. Usa el Dashboard de Express cuando suceda lo siguiente con tus cuentas conectadas: - Principalmente necesiten hacer un seguimiento de sus transferencias y actividad de pago. - No requieran herramientas de desarrollador o informes avanzados. - Puedan usar una interfaz de usuario (IU) simple y optimizada. Puedes [configurar el Dashboard de Express](https://docs.stripe.com/connect/customize-express-dashboard.md#customize-features) para personalizar a qué funcionalidades, como disputas, reembolsos y transferencias manuales, pueden acceder tus cuentas conectadas. Las cuentas conectadas acceden al Dashboard de Express a través de un [enlace de inicio de sesión](https://docs.stripe.com/api/accounts/login_link/create.md) que tú generas, en lugar de iniciar sesión directamente en dashboard.stripe.com. Siempre puedes agregar los [componentes integrados de Connect](https://docs.stripe.com/connect/get-started-connect-embedded-components.md) a tu propio sitio web, a la vez que proporcionas acceso al Dashboard de Express. #### 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 > Para una cuenta sin acceso al Dashboard alojado por Stripe, en la que Stripe es responsable de los saldos negativos, usa componentes integrados de Connect para permitir que los usuarios actualicen su cuenta por sí mismos. No puedes crear [enlaces de cuenta](https://docs.stripe.com/api/account_links.md) del tipo `account_update` para este tipo de cuentas. > #### El tipo de Dashboard es inmutable > > El Dashboard que especificas al crear una cuenta conectada es permanente, por lo que debes considerar los requisitos a largo plazo de tu empresa al decidir el tipo de Dashboard. Para cambiar el Dashboard de una cuenta conectada, debes crear un nuevo objeto `Account`. ### 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.