Onboarding alojado en Stripe para cuentas Custom

El onboarding de Connect para cuentas Custom admite un onboarding gradual o inmediato. El onboarding inmediato 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.

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. A continuación encontrarás un ejemplo de la solicitud:

curl https://api.stripe.com/v1/account_links \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d account=
{{CONNECTED_ACCOUNT_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

La respuesta a tu solicitud de Account Links 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, o si se solicita la funcionalidad treasury, el usuario debe configurar la autenticación adicional con Stripe para entrar al flujo de onboarding.

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.

return_url

Stripe redirige a esta URL cuando el usuario completa el flujo de onboarding de Connect o hace click 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 correctamente.

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 e inspeccionar el estado de su atributo requirements. Obtén más información en el paso 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, con los mismos parámetros, y redirigir al usuario de nuevo al flujo de onboarding de Connect para crear una experiencia sin inconvenientes.

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 para este fin. Puedes probar la administración de requisitos nuevos (y cómo podrían deshabilitar cargos y transferencias) con nuestras tarjetas de activación de prueba.

Te notificaremos cuando las próximas actualizaciones de requisitos 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. Para el onboarding integrado, incluye el atributo collectionOptions en el componente de onboarding integrado. Para el onboarding alojado en Stripe, especifica el parámetro collection_options al crear enlaces de cuenta.

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.

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. 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”.