# Crea y completa con anticipación la cuenta conectada Crea cuentas conectadas para tu Marketplace. Una cuenta conectada es una cuenta de Stripe que pertenece a uno de tus usuarios (como un vendedor, un proveedor de servicios o un proveedor). Las cuentas conectadas permiten que tu Marketplace acepte pagos y administre fondos en nombre de tus usuarios, a la vez que mantiene registros financieros separados para cada vendedor. Como Marketplace, debes crear cuentas conectadas para cada vendedor o proveedor de servicios en tu Marketplace para facilitar los pagos, gestionar las transferencias y garantizar el correcto cumplimiento de la normativa y la elaboración de informes. Esta separación permite que cada cuenta conectada tenga su propio historial de transacciones, información de la empresa y calendario de transferencias, mientras le da a tu Marketplace la capacidad de cobrar comisiones de la plataforma y gestionar el flujo de pago general. Los clientes finales ven el nombre de tu Marketplace en los recibos después de hacer una compra, en lugar del nombre del vendedor o proveedor de servicios. En esta guía, se explica cómo crear una cuenta conectada y completar previamente los campos relevantes. ## Before you begin Sigue la guía interactiva de la plataforma para configurar tu [cuenta Marketplace de Stripe](https://docs.stripe.com/connect/interactive-platform-guide.md). ## Crear una cuenta conectada Usa la API Accounts v2 para [crear](https://docs.stripe.com/api/v2/core/accounts/create.md) una cuenta conectada especificando las [Dashboard y responsabilidades de la cuenta conectada](https://docs.stripe.com/connect/accounts-v2/connected-account-configuration.md). Como Marketplace, tu plataforma: - Suele ser comerciante registrado - Usa *cargos indirectos* (A charge type where customers transact directly with your platform instead of with a connected account. Indirect charges include destination charges and separate charges and transfers) - Gestiona disputas y reembolsos - Obtiene ingresos al recibir una parte de cada transacción mediante comisiones de la plataforma. Estas funcionalidades afectan los parámetros que estableces cuando crear tus cuentas conectadas. ### Asignar configuraciones de la cuenta Las cuentas conectadas interactúan con tu plataforma y Stripe dependiendo de las configuraciones que les asignaste. La mayoría de los marketplaces asignan a sus cuentas conectadas la configuración [destinatario](https://docs.stripe.com/api/v2/core/accounts/create.md#v2_create_accounts-configuration-recipient). Algunos marketplaces también asignan la configuración [comerciante](https://docs.stripe.com/api/v2/core/accounts/create.md#v2_create_accounts-configuration-merchant). La configuración del destinatario (`recipient`) incluye la funcionalidad balance de stripe.transferencias de stripe (`stripe_balance.stripe_transfers`), lo que permite al balance de Stripe para la Cuenta (`Account`) recibir Transferencias [Transfers](https://docs.stripe.com/api/transfers/object.md?api-version=preview) del saldo de la plataforma. Debes asignar la funcionalidad balance de stripe.transferencias de stripe (`stripe_balance.stripe_transfers`) para usar cargas indirectas. También debes asignar el atributo comerciante (`merchant`) a tus cuentas conectadas en los siguientes casos: - Usa cargos directos ([direct charges](https://docs.stripe.com/connect/direct-charges.md)). Es raro que los marketplaces utilicen este tipo cargos. - Usa [cargos indirectos con el parámetro de parte de](https://docs.stripe.com/connect/charges.md#on_behalf_of) (on_behalf_of) para establecer un cuenta conectada como *comerciante registrado* (The legal entity responsible for facilitating the sale of products to a customer that handles any applicable regulations and liabilities, including sales taxes. In a Connect integration, it can be the platform or a connected account). ### Ejemplo de código ```curl curl -X POST https://api.stripe.com/v2/core/accounts \ -H "Authorization: Bearer <>" \ -H "Stripe-Version: 2026-03-25.preview" \ --json '{ "contact_email": "testaccount@example.com", "display_name": "Test account", "defaults": { "responsibilities": { "fees_collector": "application", "losses_collector": "application" } }, "dashboard": "express", "identity": { "country": "us" }, "configuration": { "recipient": { "capabilities": { "stripe_balance": { "stripe_transfers": { "requested": true } } } } }, "include": [ "configuration.recipient", "identity", "requirements" ] }' ``` | Parámetro | Valor | Descripción | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [defaults.responsibilities.fees_collector](https://docs.stripe.com/api/v2/core/accounts/create.md#v2_create_accounts-defaults-responsibilities-fees_collector) | `application` | Tu Marketplace paga todas las comisiones de Stripe, incluidas las comisiones por procesar pagos. | | [defaults.responsibilities.losses_collector](https://docs.stripe.com/api/v2/core/accounts/create.md#v2_create_accounts-defaults-responsibilities-losses_collector) | `application` | Tu Marketplace es *responsable de los saldos negativos* (The responsibility for managing risk and recovering negative balances on connected accounts. Stripe or the Connect platform can be liable for negative balances on connected accounts) y gestiona el riesgo de crédito y fraude en la cuenta conectada. Esto requiere que revises y reconozcas tus responsabilidades en el Dashboard. | | [dashboard](https://docs.stripe.com/api/v2/core/accounts/create.md#v2_create_accounts-dashboard) | `express` | La cuenta conectada puede acceder al Dashboard de Express. | | [configuration.recipient.capabilities](https://docs.stripe.com/api/v2/core/accounts/create.md#v2_create_accounts-configuration-recipient-capabilities) | ‘stripe_balance.stripe_transfers’ | La cuenta conectada puede recibir fondos de tu Marketplace. | La respuesta incluye el ID, que se utiliza para hacer referencia a la Cuenta (`Account`) a lo largo de tu integración. Una vez que la solicitud se realiza correctamente, la cuenta existe en un estado pendiente. A continuación, usa la información que ya tienes para completar previamente el formulario de onboarding de la cuenta conectada. ## Completar previamente la información de la cuenta 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 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). ## Próximos pasos Después de completar previamente la información de la empresa, configura el [acceso al Dashboard](https://docs.stripe.com/connect/marketplace/tasks/dashboard.md) para la cuenta conectada.