# Diseña una integración avanzada de Connect utilizando la API Accounts v1 Más información sobre combinaciones de configuración alternativas para la integración de Connect basada en la API Accounts v1. > #### Integraciones de la API Accounts v2 > > Esta guía solo se aplica a las plataformas Connect existentes que utilizan la API Accounts v1. Si eres un nuevo usuario de Connect, utiliza la API Accounts v2. Consulta la [guía de plataformas interactivas](https://docs.stripe.com/connect/interactive-platform-guide.md) para obtener información sobre cómo configurar una nueva plataforma Connect usando la API Accounts v2. Usa esta guía para explorar diferentes integraciones de Connect y crear una lista de pasos de integración personalizados. Antes de comenzar tu integración en un entorno de *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 en Connect](https://dashboard.stripe.com/settings/connect/platform-profile). ## Seleccionar propiedades ### Crear y activar cuentas Stripe te permite crear cuentas en nombre de los usuarios, que se denominan cuentas conectadas. Cuando usas Connect, creas cuentas conectadas por 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 a tu usuario a Stripe para completar 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 desees hacer una implantación rápidamente con el menor esfuerzo de integración: - Las cuentas conectadas abandonan tu sitio y se las redirige a Stripe para completar el proceso. - Marca compartida con Stripe y opciones limitadas para personalizar. - Stripe se encarga de toda la lógica de flujo de onboarding. - Compatible automáticamente en más de 46 países y 14 idiomas. #### Item 2 Integra directamente en tu aplicación una interfaz de usuario de onboarding muy personalizable con una imagen de marca limitada de Stripe. Los usuarios de las cuentas conectadas interactúan con el componente integrado sin tener que salir de tu 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 web con una experiencia más integrada y un menor esfuerzo de integración: - Las cuentas conectadas permanecen en tu sitio. - Muy personalizable. Con imagen de marca de Stripe limitada o nula. - Stripe maneja toda la lógica del flujo de onboarding. - Compatible automáticamente en más de 46 países y 14 idiomas. #### Item 3 Desarrolla cada aspecto del flujo de onboarding llamando a las API de Stripe correspondientes. Debes crear una lógica personalizada en tu integración para cumplir con toda la información de verificación requerida. > #### Recomendación de Stripe > > La creación y el mantenimiento de un flujo de onboarding de API requieren diversos 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) ```text [Invita a hacer el onboarding de nuevas cuentas conectadas] --> [Muestra la interfaz de usuario para recolectar requirements de tu cuenta conectada] [Muestra la interfaz de usuario para recolectar requirements de tu cuenta conectada] --> [Crea una cuenta conectada] [Crea una cuenta conectada] --> [Si requirements.currently_due no está vacío] [Recupera la cuenta conectada] --> [Si requirements.currently_due no está vacío] [Presentar formularios para recopilar información y validar campos] --> [Actualizar la cuenta conectada con la información recopilada] [Vuelve a hacer el onboarding de una cuenta conectada existente] --> [Recupera la cuenta conectada] [Actualizar la cuenta conectada con la información recopilada] --> [Si requirements.currently_due no está vacío] [Si requirements.currently_due no está vacío] --> [Presentar formularios para recopilar información y validar campos] ``` Ideal para cuando quieras tener el control total del flujo de onboarding: - Crea y mantén tú mismo toda la lógica del flujo de onboarding. Puede requerir muchos recursos y ser caro desarrollarlo. - Gestionas el riesgo con plena responsabilidad por los pasivos de saldo negativo en las cuentas conectadas. - Debes mantener tus flujos actualizados a medida que cambien 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 al menos cada seis meses para asegurarte de incluir 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 de transferencias. ### Configurar 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 los componentes integrados. #### Item 1 Proporciona acceso al Dashboard de Stripe a las cuentas conectadas. El Dashboard de Stripe ofrece a las cuentas conectadas acceso sin restricciones a todas las funciones de Stripe utilizando 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 en relación con su cuenta. Usa el Dashboard de Stripe cuando tus cuentas conectadas: - Necesiten gestionar sus propias claves API, webhooks o integraciones para desarrolladores. - Requieran informes financieros detallados o la exportación de datos. - Dispongan de equipos con diferentes necesidades de acceso (por ejemplo, funciones separadas de administrador y analista). - Usen Stripe Apps. Siempre puedes añadir [componentes integrados](https://docs.stripe.com/connect/get-started-connect-embedded-components.md) a tu propio sitio web y al mismo tiempo proporcionar acceso al Dashboard de Stripe. #### Item 2 Proporciona acceso al Dashboard de Express para que las cuentas conectadas puedan gestionar su cuenta. El Dashboard de Express es un Dashboard con funcionalidad limitada alojado en Stripe que puedes personalizar con tu imagen de marca y configurando las funciones que son compatibles. Las cuentas conectadas que utilizan el Dashboard de Express tienen acceso al servicio de asistencia de Stripe, y Stripe puede comunicarse con ellas en relación con su cuenta. Usa el Dashboard de Express cuando tus cuentas conectadas: - Principalmente necesiten hacer un seguimiento de sus transferencias y su actividad de pagos. - No requieran herramientas de desarrollador ni informes avanzados. - Puedan usar una interfaz de usuario sencilla y optimizada. Puedes [configurar el Dashboard de Express](https://docs.stripe.com/connect/customize-express-dashboard.md#customize-features) para personalizar a qué funciones, 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 en dashboard.stripe.com directamente. Siempre puedes añadir [componentes integrados de Connect](https://docs.stripe.com/connect/get-started-connect-embedded-components.md) a tu propio sitio web al mismo tiempo que ofreces acceso al Dashboard de Express. #### Item 3 Crea un Dashboard utilizando las API o componentes integrados de Stripe para permitir que las cuentas conectadas gestionen su cuenta. 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, los reembolsos, los flujos de trabajo de disputas y las funciones de informes de tu usuario. Es posible que tus usuarios no se den cuenta de que tienen una cuenta de Stripe a través de tu plataforma. Recomendamos integrar [componentes integrados de Connect](https://docs.stripe.com/connect/get-started-connect-embedded-components.md) para añadir las funciones del Dashboard a tu solicitud de acceso con un bajo esfuerzo de integración. Los componentes integrados son muy personalizables y pueden admitir cuentas conectadas con: - Flujos de trabajo de pagos, como consultar pagos y transferencias, gestionar reembolsos y responder a disputas - Flujos de transferencias, como gestionar calendarios de transferencias, crear pagos manuales o actualizar cuentas de pago - Informes de flujos de trabajo para descargar y exportar pagos y transferencias - Flujos de trabajo de gestión de cuentas, como actualizar la información de la empresa > Para una cuenta sin acceso al Dashboard alojado en Stripe en la que Stripe es responsable de los saldos negativos, utiliza los componentes integrados de Connect para proporcionar actualizaciones de cuenta de autoservicio. No puedes crear [enlaces de cuentas](https://docs.stripe.com/api/account_links.md) de tipo `account_update` para dichas cuentas. > #### El tipo de Dashboard es inmutable > > El Dashboard que especificas al crear una cuenta conectada es permanente, así que ten en cuenta los requisitos a largo plazo de tu empresa a la hora de decidir el tipo de Dashboard. Para cambiar el Dashboard de una cuenta conectada, debes crear un nuevo objeto `Cuenta`. ### 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 pago entre todas las partes involucradas - Afecta a la forma en que aparece el cargo en el extracto bancario o de facturación del cliente (con la información de tu plataforma o de tu usuario) - Determina en qué cuenta carga Stripe los reembolsos y contracargos #### Item 1 Un cargo directo es un pago del cliente realizado 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 plataformas que proporcionan software como servicio. Por ejemplo, Shopify proporciona herramientas para crear escaparates en línea, y Thinkific permite a los docentes vender cursos en línea. #### Item 2 Crea cargos indirectos en tu plataforma y transfiere fondos inmediatamente a las cuentas conectadas. Los clientes hacen la transacción con tu plataforma por 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 para compartir coche. Los cargos indirectos se crean en la plataforma, pero como parte de la operación de cargo, los fondos se transfieren inmediatamente a la cuenta conectada que especificaste. Puedes decidir si se transfieren todos los fondos o solo algunos. A menos que cumplas los requisitos para realizar [transferencias transfronterizas de Connect](https://docs.stripe.com/connect/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 indirecto. Si intentas transferir fondos a través de una frontera no permitida, se emitirá 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 desacopla de los envíos de fondos a tus cuentas conectadas. Este tipo de cargo es el más adecuado para los marketplaces que necesitan dividir los pagos entre varias partes, como DoorDash, una plataforma de reparto de restaurantes. Aunque los cargos y envíos de fondos separados proporcionan mucha flexibilidad, requieren una integración más compleja para administrar los saldos de las cuentas entre tu plataforma y tus usuarios. Debes supervisar atentamente el saldo de tu cuenta de la plataforma para asegurarte de que tienes suficientes fondos disponibles para cubrir el importe del envío de fondos. A menos que cumplas los requisitos para realizar [transferencias transfronterizas de Connect](https://docs.stripe.com/connect/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. Si intentas transferir fondos a través de una frontera no permitida, se emitirá un error. ### Comisiones de Stripe #### Item 1 Stripe cobra las comisiones de Stripe de tu cuenta de la plataforma, incluidas las comisiones de procesamiento. Tú controlas los importes de la comisión de procesamiento que facturas a las cuentas conectadas. Utiliza el parámetro de la comisión de la plataforma para cobrar las comisiones de procesamiento de tus cuentas conectadas. #### Item 1 (See full diagram at https://docs.stripe.com/connect/design-an-integration) ```text [customer] -- Cargo directo --> [Cargo de 10 USD] [Cargo de 10 USD] --> [Comisión de la plataforma de 0,59 USD] [Cargo de 10 USD] -- 9,41 USD netos --> [bank] [Comisión de la plataforma de 0,59 USD] -- (0,23 USD) Stripe --> [stripe] [Comisión de la plataforma de 0,59 USD] -- 0,36 USD netos --> [bank] [account] [platform] ``` #### Item 2 (See full diagram at https://docs.stripe.com/connect/design-an-integration) ```text [customer] --> [Cargo de 10 USD] [Cargo de 10 USD] --> [Transferencia de 10 USD] [Transferencia de 10 USD] --> [Pago de 10 USD] [Pago de 10 USD] --> [(1,23 USD) Comisión de la plataforma] [(1,23 USD) Comisión de la plataforma] --> [8,77 USD netos] [(1,23 USD) Comisión de la plataforma] --> [Comisión de la plataforma de 1,23 USD] [Comisión de la plataforma de 1,23 USD] --> [(0,59 USD) Comisiones de Stripe] [(0,59 USD) Comisiones de Stripe] --> [stripe] [(0,59 USD) Comisiones de Stripe] --> [0,64 USD netos] [platform] [account] ``` #### Item 3 (See full diagram at https://docs.stripe.com/connect/design-an-integration) ```text [customer] --> [Cargo de 100 USD] [Cargo de 100 USD] --> [(70 USD) Transferencia] [(70 USD) Transferencia] --> [Pago de 70 USD] [(70 USD) Transferencia] --> [(20 USD) Transferencia] [(20 USD) Transferencia] --> [Pago de 20 USD] [(20 USD) Transferencia] --> [(3,20 USD) Comisiones de Stripe] [(3,20 USD) Comisiones de Stripe] --> [stripe] [(3,20 USD) Comisiones de Stripe] --> [6,80 USD netos] [platform] [account] [account] ``` #### Item 2 Stripe cobra las comisiones de Stripe directamente desde tus cuentas conectadas. Puedes cobrar una comisión de la plataforma opcional cuando crees el cargo directo. (See full diagram at https://docs.stripe.com/connect/design-an-integration) ```text [customer] -- Cargo directo --> [Cargo de 10 USD] [Cargo de 10 USD] --> [(1,23 USD) Comisión de la plataforma] [(1,23 USD) Comisión de la plataforma] --> [Comisión de la plataforma de 1,23 USD] [Comisión de la plataforma de 1,23 USD] --> [platform] [(1,23 USD) Comisión de la plataforma] --> [(0,59 USD) Comisiones de Stripe] [(1,23 USD) Comisión de la plataforma] --> [8,18 USD netos] [(0,59 USD) Comisiones de Stripe] --> [stripe] [account] ``` ### Haz transferencias a los usuarios Una vez que se acreditan los fondos de la liquidación del pago y la cuenta conectada del usuario tiene saldo positivo en Stripe, puedes transferir esos fondos a su cuenta externa. #### Item 1 Si haces el onboarding a 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 transferencias, 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 diariamente los fondos que se han liquidado en los saldos de tus cuentas conectadas. Si lo prefieres, puedes configurar diferentes calendarios de transferencias automáticos, activar las transferencias manualmente en lugar de automáticamente o transferir al instante. ### Responsabilidad por saldos negativos #### Item 1 Tu plataforma es responsable de las pérdidas incurridas por los saldos negativos de 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 clientes a vendedores de transferencias, o para plataformas avanzadas que desean un control total sobre cómo se gestionan el riesgo y los pasivos negativos en cuentas conectadas: - Tu plataforma debe supervisar las cuentas conectadas para detectar un riesgo continuo de pérdida. - Tu plataforma tiene que crear flujos para comunicar y remediar las cuentas conectadas cuando detectes fraude o riesgo. - Tienes tanto el equipo operativo como los recursos de ingeniería para establecer procesos para 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 por los pasivos de saldo negativo. #### Item 2 Stripe supervisa las señales de riesgo en las cuentas conectadas, implementa intervenciones de riesgo en las cuentas conectadas en respuesta a las señales observadas y busca 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 las que son nuevas en la integración de pagos: - Stripe supervisa tus cuentas conectadas en busca de riesgo de crédito y fraude, así como protección contra el riesgo de pérdida en caso de saldos negativos atribuidos al riesgo comercial. - Stripe gestiona todas las comunicaciones y soluciones de extremo a extremo directamente con tus cuentas conectadas a través de flujos alojados o componentes integrados. #### Item 1 > #### Se requiere una versión preliminar de la API con el Dashboard de Express > > La combinación del acceso al Express Dashboard con la responsabilidad de Stripe por los saldos negativos está disponible en versión [preliminar pública](https://docs.stripe.com/release-phases.md). Cuando crees cuentas conectadas, usa la cadena de la versión preliminar actual (`2026-10-28.preview`) en la configuración del SDK de Stripe. > > El código y el prompt generados en esta página utilizan la versión actual de la API con disponibilidad general. Reemplaza esa versión por la cadena de la versión beta si utilizas esta combinación. #### Item 2 #### Item 3 #### Item 1 #### Componentes integrados necesarios Cuando Stripe es responsable de los saldos negativos en tus cuentas conectadas, debes integrar componentes integrados para el onboarding, la administración de cuentas y el banner de notificaciones. Stripe utiliza el componente integrado del banner de notificaciones para notificar a las cuentas conectadas los requisitos pendientes u otras solicitudes relacionadas con el riesgo gestionado. El componente de administración de cuentas es necesario para que tus cuentas conectadas puedan gestionar sus credenciales de autenticación y su información comercial. Stripe también envía correos electrónicos a tus cuentas conectadas en tu nombre para gestionar el riesgo y confirmar el cumplimiento continuo de la normativa. Puedes personalizar estas comunicaciones por correo electrónico e incluir en ellas tu propio dominio de correo electrónico y tu imagen de marca de la plataforma. Para cualquier otro componente opcional, 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 para la integración se basan en las opciones que has seleccionado 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 aviso LLM basado en tus selecciones. Solo es compatible con el Dashboard alojado por Stripe y el onboarding alojado.