# 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) 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 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 su Dashboard de Stripe en cualquier momento y pueden acceder al Dashboard visitando Stripe directamente. Además, tienen acceso al soporte de Stripe y Stripe puede contactar y comunicarse con ellos sobre su cuenta. Usa el Dashboard de Stripe cuando: - Tus usuarios necesiten tener acceso a potentes flujos de trabajo de pagos y a funciones avanzadas de gestión de usuarios. - Prefieras que Stripe gestione el riesgo de pérdida y asuma la responsabilidad del saldo negativo de las cuentas conectadas. - Te sientes a gusto con la imagen de marca de Stripe y la marca compartida limitada de la plataforma. 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 permite a las cuentas conectadas consultar su saldo disponible, ver las próximas transferencias y hacer un seguimiento de sus ingresos en tiempo real. Los usuarios no pueden gestionar reembolsos ni disputas a través del Dashboard de Express, pero tienen acceso al soporte de Stripe y Stripe puede contactar y comunicarse con ellos sobre su cuenta. Utiliza el Dashboard de Express cuando: - Tus usuarios sean vendedores de marketplaces que necesiten acceso limitado a los flujos de trabajo. - Envíes pagos principalmente a estos usuarios. Los usuarios no gestionarán los reembolsos ni las disputas directamente. - Quieres que la apariencia del Dashboard tenga solo tu marca. - Te sientes a gusto asumiendo la responsabilidad de la responsabilidad del saldo negativo y gestionando el riesgo de pérdida en las cuentas conectadas. Siempre puedes añadir [componentes integrados de Connect](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 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. ### 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 con los requisitos para recibir [transferencias transfronterizas](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 indirecto. Intentar transferir fondos a través de una frontera no permitida devuelve 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 con los requisitos para las [transferencias transfronterizas](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 a través de una frontera no permitida devuelve 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) #### 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 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) ### 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 compradores 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 #### 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.