# Onboarding alojado en Stripe para cuentas Custom

Permite que Stripe recopile información para la verificación de identidad de tus cuentas conectadas Custom.

> #### Nuevas integraciones de Connect
> 
> La información de esta página solo se aplica a las plataformas que ya utilizan tipos de cuentas conectadas heredadas. Para obtener información sobre el onboarding de cuentas conectadas con onboarding alojado en Stripe, consulta [Onboarding alojado en Stripe](https://docs.stripe.com/connect/hosted-onboarding.md).

[Onboarding de Connect para cuentas Custom](https://stripe.com/connect/onboarding) es un formulario web alojado por Stripe que se encarga de recopilar información de verificación de identidad de los usuarios. Ajusta dinámicamente la información que recopila para reflejar las funcionalidades, el país y el tipo de empresa de la cuenta conectada. El *onboarding de Connect* (Connect is Stripe's solution for multi-party businesses, such as marketplace or software platforms, to route payments between sellers, customers, and other recipients) es la solución recomendada para recopilar datos para la verificación de identidad para las cuentas Custom y te garantiza la optimización del flujo para lo siguiente:

- Navegadores para dispositivos móviles
- Accesibilidad
- Internacionalización y localización
- Tasa de conversión
- Cómo solicitar datos en forma inteligente en función de lo que ya se ha suministrado en la cuenta

Este es el aspecto del formulario para la integración de muestra de Stripe, [Furever](https://furever.dev/):
![Captura de pantalla del formulario de Onboarding de Connect](https://b.stripecdn.com/docs-statics-srv/assets/hosted_onboarding_form.e59ba8300f563e43489953f06127f52c.png)

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

1. Ve a la [configuración de onboarding](https://dashboard.stripe.com/settings/connect/onboarding-interface) para personalizar el aspecto del formulario. Debes proporcionar el nombre, los colores y el ícono de tu marca. Debes [recopilar los datos de la cuenta bancaria en el formulario](https://dashboard.stripe.com/settings/connect/payouts/external_accounts), ya sea de forma manual o instantánea con [Stripe Financial Connections](https://docs.stripe.com/financial-connections.md).
1. Crea una nueva cuenta y obtén el ID de la cuenta o utiliza el ID de una cuenta existente (con el formato `acct_XXXXXXXX`).
1. Si tienes información sobre el titular de la cuenta (como su nombre, dirección, etc.), puedes proporcionarla de manera proactiva mediante los [métodos de creación o actualización de cuentas](https://docs.stripe.com/api/accounts.md). Cuanta más información proporciones a través de la API, menos información solicitará el onboarding de Connect al usuario.
1. Llama a la API [Account Links](https://docs.stripe.com/api/account_links.md) con los siguientes parámetros (consulta la [referencia de API](https://docs.stripe.com/api/account_links.md) para obtener más información):
   - `account`
   - `refresh_url`
   - `return_url`
   - `type`
   - `collection_options` (opcional)
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. Gestiona los otros estados de la cuenta redirigiendo al usuario al flujo del onboarding de Connect, en caso de ser necesario. Para administrar las actualizaciones iniciadas por el usuario de la información ya proporcionada, crea una vía para que se redirija al usuario al formulario del onboarding de Connect desde el Dashboard de tu plataforma.

## Determinar la información que debe recopilarse

El onboarding de Connect para cuentas Custom admite un *onboarding gradual* (Incremental onboarding is a type of onboarding where you gradually collect required verification information from your users. You collect a minimum amount of information at sign-up, and you collect more information as the connected account earns more revenue) o inmediato. El *onboarding inmediato* (Upfront onboarding is a type of onboarding where you collect all required verification information from your users at sign-up) recopila los requisitos `eventually_due` de la cuenta, mientras que el onboarding gradual recopila los requisitos `currently_due`. Para obtener información sobre las ventajas y desventajas de cada uno, consulta [la documentación sobre flujos de onboarding](https://docs.stripe.com/connect/identity-verification.md#onboarding-flows).

Los requisitos `currently_due` implican la solicitud de información del usuario que se necesita para la verificación en este momento específico. Los requisitos `eventually_due` incluyen un conjunto más amplio de preguntas que necesitaremos hacer más adelante.

Según las necesidades de tu plataforma, especifica `currently_due` o `eventually_due` como valor del parámetro `collection_options.fields` en tus llamadas a la API [Account Links](https://docs.stripe.com/api/account_links.md). A continuación encontrarás un ejemplo de la solicitud:

```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 \
  -d "collection_options[fields]=eventually_due"
```

## 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`. Redirige al usuario a este enlace para enviarlo al flujo. Puedes usar las URL de Account Link solo 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. Si habilitas **Recopilar información de cuentas externas para cuentas en las que la plataforma es responsable de recopilar los requisitos** en tu [configuración de onboarding de transferencias](https://dashboard.stripe.com/settings/connect/payouts/external_accounts), o si se solicita la funcionalidad `treasury`, el usuario debe configurar la autenticación adicional con Stripe para entrar al flujo de onboarding.

> 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 del usuario que vuelve a tu plataforma

El onboarding de Connect te exige especificar una `return_url` y una `refresh_url` para gestionar todos los casos en que el usuario sea 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 modo de prueba (por ejemplo, testear con localhost), aunque en modo activo solo se acepta HTTPS. Debes actualizar todas las URL de prueba a URL HTTPS antes de pasar a modo activo.

#### return_url

Stripe redirige a este URL cuando el usuario completa el flujo de <i>onboarding</i> de Connect o hace clic en **Guardar para después** en cualquier momento del flujo. Esto *no* implica que se haya recopilado toda la información o que no haya requisitos pendientes en la cuenta. Simplemente significa que se entró y se salió del flujo de manera correcta.

No se transmite ningún estado con esta URL. Después de redirigir al usuario a la `return_url`, verifica el estado del atributo `requirements` en su cuenta. Puedes recibir notificaciones de los webhooks `account.updated` o recuperar el objeto [Account](https://docs.stripe.com/api/accounts.md) e inspeccionar el estado de su atributo `requirements`. Obtén más información en el paso&nbsp;4 que se encuentra a continuación.

#### refresh_url

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

- Se venció el enlace (pasaron algunos minutos desde la creación del enlace)
- Ya se visitó el enlace (el usuario actualizó la página o hizo click en el botón **atrás**/**adelante**)
- El enlace se compartió en una aplicación de terceros, como un cliente de mensajería que intenta acceder a la URL para obtener una vista previa. Muchos clientes visitan automáticamente enlaces, lo que hace que estos caduquen.

La `refresh_url` debe activar 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 de nuevo al flujo de onboarding de Connect para crear una experiencia sin inconvenientes.

## Gestionar el caso de nuevos requisitos que están por vencer

Configura tu integración para recibir notificaciones de los cambios en los requisitos de la cuenta si aún no lo hiciste. Te recomendamos [usar webhooks](https://docs.stripe.com/connect/handling-api-verification.md#verification-process) para este fin. Puedes probar la administración de requisitos nuevos (y cómo podrían deshabilitar cargos y *transferencias* (A payout is the transfer of funds to an external account, usually a bank account, in the form of a deposit)) con nuestras [tarjetas de activación de prueba](https://docs.stripe.com/connect/testing.md#trigger-cards).

Te notificaremos cuando [las próximas actualizaciones de requisitos](https://support.stripe.com/user/questions/onboarding-requirements-updates) afecten a tus cuentas conectadas.

Si utilizas el onboarding integrado o alojado en Stripe, puedes recopilar información de forma proactiva para cumplir con los [requisitos futuros](https://docs.stripe.com/api/accounts/object.md#account_object-future_requirements). Para el onboarding integrado, incluye el atributo `collectionOptions` en el [componente de onboarding integrado](https://docs.stripe.com/connect/supported-embedded-components/account-onboarding.md). Para el onboarding alojado en Stripe, especifica el parámetro `collection_options` al [crear enlaces de cuenta](https://docs.stripe.com/api/account_links/create.md#create_account_link-collection_options).

En función de las necesidades de verificación de tu aplicación, vuelve a remitir al usuario al onboarding de Connect según sea necesario para cumplir con los requisitos `currently_due` o `eventually_due` descritos en el paso 1. Puedes usarlo como señal de *cuándo* devolver al usuario al flujo. Ten en cuenta que al usar el onboarding de Connect, no tendrás que preocuparte por *cuáles* son los requisitos, ya que el reencaminamiento del usuario al onboarding de Connect implica que se recopilará la información correcta.

Por ejemplo, si el usuario comete un error al escribir la información y no puede completar la verificación, se le podría pedir un documento de identidad (por ejemplo, la licencia de conducir en Estados Unidos). Si se remite a este usuario al onboarding de Connect, se le solicitará que cargue ese documento para garantizar que se haga la verificación.

> El onboarding de Connect para cuentas Custom no recopila el requisito `external_account` de forma predeterminada. Para recopilar `external_account`, habilita **Recopilar información de cuentas externas para cuentas en las que la plataforma es responsable de recopilar los requisitos** en tu [configuración de onboarding de transferencias](https://dashboard.stripe.com/settings/connect/payouts/external_accounts). Obtén más información sobre [cómo gestionar las cuentas bancarias y las tarjetas de débito](https://docs.stripe.com/connect/payouts-bank-accounts.md).

## Gestionar el caso de actualizaciones iniciadas por el usuario

La mayor parte del uso del onboarding de Connect analizado hasta ahora se centró en cómo solicitar al usuario que proporcione nueva información. El onboarding de Connect también admite actualizaciones iniciadas por el usuario de la información que ya proporcionó en el parámetro `type` del [Account Link](https://docs.stripe.com/api/account_links.md). El parámetro `type` acepta uno de estos dos valores: `account_onboarding` o `account_update`.

#### account_onboarding

Este valor de `type` proporciona un formulario para ingresar requisitos pendientes. Úsalo durante el onboarding de un nuevo usuario o cuando se necesiten nuevos datos para un usuario existente, como cuando un usuario ya ha proporcionado suficiente información, pero has solicitado una nueva funcionalidad que exige información adicional. Envía al usuario al formulario en este modo para recopilar solo la nueva información que necesitas.

#### account_update

Este valor de `type` muestra los atributos que ya se completaron en el objeto Account y le permite al usuario editar la información proporcionada previamente. Proporciona un punto de acceso a un enlace de cuenta `type=account_update` en el sitio web de tu plataforma para que los propios usuarios realicen las actualizaciones (por ejemplo, para cambiar su dirección). Considera enmarcar el enlace como “editar mi perfil” o “actualizar mi información de verificación”.

## Navegadores compatibles

El onboarding alojado admite el mismo conjunto de navegadores que el [Dashboard de Stripe actualmente](https://docs.stripe.com/dashboard/basics.md):

- Las últimas 20 versiones principales de Chrome y Firefox
- Las últimas dos versiones principales de Safari y Edge
- Las últimas dos versiones principales de Safari para dispositivos móviles en iOS

No se admite el onboarding alojado cuando se integra a través de vistas web. Solo es compatible con navegadores independientes.

## See also

- [Verificación de identidad](https://docs.stripe.com/connect/identity-verification.md)