Crea y completa con anticipación la cuenta conectada

Usa la API Accounts v2 para crear una cuenta conectada especificando las Dashboard y responsabilidades de la cuenta conectada. Como Marketplace, tu plataforma:

• Suele ser comerciante registrado
• Usa cargos indirectos
• 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. Algunos marketplaces también asignan la configuración comerciante.

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 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). Es raro que los marketplaces utilicen este tipo cargos.
• Usa cargos indirectos con el parámetro de parte de (on_behalf_of) para establecer un cuenta conectada como comerciante registrado.

Ejemplo de código

curl -X POST https://api.stripe.com/v2/core/accounts \
  -H "Authorization: Bearer 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
" \
  -H "Stripe-Version: 2025-09-30.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"
    ]
  }'

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.

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 una cuenta, crea una persona con relationship.representative establecido en true (verdadero) para representar a la persona responsable de abrir la cuenta y la información de la cuenta que quieras completar previamente (por ejemplo, su nombre y apellido).

curl https://api.stripe.com/v1/accounts/
{{ACCOUNT_ID}}
/persons \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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.

Cuando pruebes la integración, completa automáticamente la información de la cuenta con los datos de prueba.