# Cómo usar Connect con cuentas conectadas Standard

Usa cuentas conectadas Standard para empezar a usar Connect de inmediato y permite que Stripe gestione la mayor parte de la experiencia de la cuenta conectada.

> #### Nuevas integraciones de Connect
> 
> La información de esta página solo se aplica a plataformas que ya usan tipos de cuentas conectadas heredadas. Si estás configurando una nueva plataforma Connect o tu integración usa la API Accounts v2, consulta [Configurar el comportamiento de cuentas conectadas](https://docs.stripe.com/connect/accounts-v2/connected-account-configuration.md) para obtener más información sobre las configuraciones de cuentas conectadas. Si tu integración usa la API Accounts v1, consulta [Propiedades del controlador de cuentas](https://docs.stripe.com/connect/migrate-to-controller-properties.md#account-controller-properties).

El proceso que se describe aquí es el método recomendado para la creación de cuentas Standard. Si tienes una extensión o una aplicación que necesita acceder a una cuenta existente para que puedas prestar servicios a tus usuarios, igualmente puedes usar [OAuth](https://docs.stripe.com/connect/oauth-reference.md).

Una cuenta *Standard* conectada es una cuenta de Stripe convencional en la que tu cuenta conectada tiene relación con Stripe, puede iniciar sesión en el [Dashboard](https://dashboard.stripe.com) y puede procesar cobros por sí sola.

El modelo de integración de Stripe, [Kavholm](https://github.com/stripe-samples/connect-onboarding-for-standard), te muestra cómo usar el [onboarding de Connect](https://stripe.com/connect/onboarding) para tener una experiencia de onboarding de usuarios fluida.
![Captura de pantalla del formulario de Onboarding de Connect](https://b.stripecdn.com/docs-statics-srv/assets/Kavholm-Seamless-Standard.78b64d90c0bf87130c8b6ba1ef53df7f.png)

## Cómo usar el onboarding de Connect para cuentas Standard

1. Ve a la [página de configuración de Connect](https://dashboard.stripe.com/account/applications/settings) para personalizar el aspecto del formulario con el nombre, el color y el ícono de tu marca. El onboarding de Connect necesita esta información.

1. Usa la API `/v1/accounts` para [crear](https://docs.stripe.com/api/accounts/create.md) una cuenta nueva y obtener el ID de la cuenta. Puedes completar la información del objeto Account correspondiente al usuario automáticamente antes de generar el enlace de cuenta. Debes especificar el siguiente parámetro:

   - `type` = `standard`

   > Después de haber creado una cuenta nueva, comprueba que esta figure en el Dashboard.

1. Llama a la API [Account Links](https://docs.stripe.com/api/account_links.md) para crear un enlace para que la cuenta se incorpore.

1. En el flujo de onboarding de tu plataforma, redirige al usuario a la `url` devuelta por [Account Links](https://docs.stripe.com/api/account_links.md).

1. Para gestionar otros estados de la cuenta, redirige la cuenta al flujo del onboarding de Connect, en caso de ser necesario.

1. *Opcional*: puedes agregar procedimientos adicionales, como Tax o Climate, al proceso de onboarding de Connect a través de las [opciones de onboarding de Connect](https://dashboard.stripe.com/settings/connect/onboarding-options) en el Dashboard.

## Crear una cuenta Standard y completar automáticamente la información

Usa la API [Create Account](https://docs.stripe.com/api/accounts/create.md) para crear una cuenta conectada cuyo `type` esté establecido en `standard`. Puedes completar previamente cualquier información, pero como mínimo, debes especificar el `type`. El país de la cuenta por defecto es el mismo que el de tu plataforma, y la cuenta confirma la selección durante el onboarding. Si sabes qué [funcionalidades](https://docs.stripe.com/connect/account-capabilities.md) necesita la cuenta, puedes solicitarlas al crearla.

> En este ejemplo, se incluyen solo algunos de los campos que puedes configurar al crear una cuenta. Para obtener una lista completa de los campos que puedes configurar, como `address` y `website_url`, consulta la [referencia sobre la API Create Account](https://docs.stripe.com/api/accounts/create.md).

```curl
curl https://api.stripe.com/v1/accounts \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d type=standard
```

### Información previamente completada (Optional)

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 "<<YOUR_SECRET_KEY>>:" \
  -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).

## Crear un enlace de cuenta

Puedes crear un enlace de cuenta llamando a la API [Account Links](https://docs.stripe.com/api/account_links.md) con los siguientes parámetros:

- `account` - usa el ID de cuenta recibido de la API en el paso anterior
- `refresh_url`
- `return_url`
- `type` = `account_onboarding`

```curl
curl https://api.stripe.com/v1/account_links \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "account={{CONNECTEDACCOUNT_ID}}" \
  --data-urlencode "refresh_url=https://example.com/reauth" \
  --data-urlencode "return_url=https://example.com/return" \
  -d type=account_onboarding
```

## Redirigir al usuario a la URL del enlace de cuenta

La respuesta a tu solicitud de [Account Links](https://docs.stripe.com/api/account_links.md) incluye un valor para la clave `url`. Para enviar al usuario al flujo, redirígelo a este enlace. Solo puedes usar las URL de los [enlaces de cuenta](https://docs.stripe.com/api/account_links.md) una vez, ya que otorgan acceso a los datos personales del titular de la cuenta. Autentica al usuario en tu aplicación antes de redirigirlo a esta URL. Después de crear un enlace de cuenta en una cuenta Standard, no podrás leer ni escribir los datos de [Conoce a tu cliente](https://support.stripe.com/questions/know-your-customer) (KYC). Completa automáticamente toda la información de KYC antes de crear el primer enlace de cuenta.

> No envíes por correo electrónico, ni por mensaje de texto ni por ningún otro medio las URL del enlace de la cuenta fuera de la aplicación de la plataforma. En lugar de eso, envíalas al titular de la cuenta autenticado dentro de tu aplicación.

## Gestionar el caso de un usuario que vuelve a la plataforma

El onboarding de Connect te exige especificar una `return_url` y una `refresh_url` para gestionar todos los casos en que el usuario es redirigido a tu plataforma. Es importante implementarlas correctamente para brindarle la mejor experiencia al usuario.

> Puedes usar HTTP para tu `return_url` y `refresh_url` mientras estés en un entorno de pruebas (por ejemplo, testear con localhost), aunque en modo activo solo puedes usar HTTPS. Debes actualizar las URL de prueba a URL HTTPS antes de pasar a modo activo.

#### return_url

Stripe redirige al usuario a esta URL cuando dicho usuario completa el flujo de onboarding de Connect. Esto no implica que se haya recopilado toda la información ni que no haya requisitos pendientes en la cuenta. Solo significa que se entró y se salió del flujo correctamente.

No se especifica ningún estado a través de esta URL. Después de redirigir al usuario a tu `return_url`, verifica el estado del parámetro `details_submitted` en su cuenta por medio de uno de los siguientes métodos:

- Escuchando los *webhooks* (A webhook is a real-time push notification sent to your application as a JSON payload through HTTPS requests) `account.updated`
- Llamando a la API [Accounts](https://docs.stripe.com/api/accounts.md) e inspeccionando el objeto devuelto

#### refresh_url

Tu usuario será redirigido a la `refresh_url` en estos casos:

- Se venció el enlace (pasaron algunos minutos desde su creación).
- El usuario ya visitó el enlace (actualizó la página o se desplazó de página en el navegador)
- Tu plataforma ya no puede acceder a la cuenta
- La cuenta ha sido rechazada

La `refresh_url` activa un método en tu servidor para volver a llamar a la API [Account Links](https://docs.stripe.com/api/account_links.md) con los mismos parámetros y redirigir al usuario al flujo de onboarding de Connect para crear una experiencia fluida.

## Gestionar los casos de usuarios que no han completado el onboarding

Es posible que un usuario redirigido a tu `return_url` no haya completado el proceso de onboarding. Usa el punto de conexión `/v1/accounts` para recuperar la cuenta del usuario y comprueba si hay `charges_enabled`. Si la cuenta no ha finalizado todo el proceso de onboarding, proporciona indicaciones de interfaz de usuario para que el usuario pueda continuarlo más tarde. Podrá completar la activación de su cuenta con un nuevo enlace de cuenta (generado por tu integración). Puedes verificar el estado del parámetro `details_submitted` en su cuenta para ver si se completó el proceso de onboarding.

## Optional: Habilitar el monitoreo de la obligación fiscal de Stripe Tax

Usa Stripe Tax para permitir que las cuentas conectadas supervisen sus [obligaciones fiscales](https://docs.stripe.com/tax/monitoring.md) durante el procesamiento de pagos. Stripe envía [notificaciones](https://docs.stripe.com/tax/monitoring.md#tax-threshold-notifications) a estas cuentas cuando superan umbrales fiscales específicos. Para habilitar el monitoreo de obligaciones, activa Stripe Tax en tus [opciones de onboarding de Connect](https://dashboard.stripe.com/settings/connect/onboarding-options). Esto habilita un paso adicional que solicita información fiscal básica, como el [código fiscal predefinido](https://docs.stripe.com/tax/products-prices-tax-codes-tax-behavior.md#product-tax-code) de tu cuenta conectada, que aparece durante el proceso de onboarding para cuentas conectadas que tengan acceso al Dashboard de Stripe. Stripe Tax utiliza esta información para calcular cuándo se pueden cruzar los umbrales fiscales.

Aprende a [cobrar impuestos como plataforma](https://docs.stripe.com/tax/connect.md).

## See also

- [Creación de cargos](https://docs.stripe.com/connect/charges.md)
- [Autenticación](https://docs.stripe.com/connect/authentication.md)
- [Referencia de OAuth](https://docs.stripe.com/connect/oauth-reference.md)