Cómo usar Connect con cuentas conectadas Express

Antes de hacer el onboarding de tu primera cuenta, ve a la página de configuración de Connect para personalizar el aspecto del formulario con el nombre, el color y el ícono de tu marca. El onboarding de Connect requiere esta información.

Use the Create Account API to create a connected account with type set to express. You can prefill any information, but at a minimum, you must specify the type. The country of the account defaults to the same country as your platform, and the account confirms the selection during onboarding.

curl https://api.stripe.com/v1/accounts \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d type=express

If you know the country and capabilities for your connected account, you can provide that information when you create the account. Connect Onboarding then collects the requirements for those capabilities. To reduce onboarding effort, request only the capabilities you need.

curl https://api.stripe.com/v1/accounts \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d country=US \
  -d type=express \
  -d "capabilities[card_payments][requested]"=true \
  -d "capabilities[transfers][requested]"=true \
  -d business_type=individual \
  --data-urlencode "business_profile[url]"="https://example.com"

Si ya recopilaste información para tus cuentas conectadas, puedes completar automáticamente esa información en el objeto Account. Puedes completar automáticamente todo tipo de información de la cuenta, por ejemplo, los datos personales y de la empresa, la información externa de la cuenta y más.

Connect Onboarding doesn’t ask for the prefilled information. However, it does ask the account holder to confirm the prefilled information before accepting the Connect service agreement.

Cuando haces el onboarding de una cuenta sin su propio sitio web y tu plataforma le proporciona una URL personal, completa automáticamente su business_profile.url. Si la cuenta no tiene una URL, puedes completar automáticamente su business_profile.product_description.

When testing your integration, prefill account information using test data.

Si omites capabilities, el onboarding de Connect usa los parámetros de la sección Parámetros de configuración del Dashboard de Stripe para solicitar funcionalidades automáticamente según el país de la cuenta.

Crea un objeto Account Link 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 https://api.stripe.com/v1/account_links \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -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

Un objeto Account Link contiene una url. Redirige la cuenta a este enlace para enviarla al flujo de onboarding. Cada URL de Account Link solo se puede usar una vez, ya que otorga acceso a los datos personales del titular de la cuenta. Autentica la cuenta en tu aplicación antes de redirigirla a esta URL.

Antes de crear el primer enlace de cuenta para una cuenta conectada Express, completa automáticamente la información de Conoce a tu cliente (KYC). Después de crear un enlace de cuenta para una cuenta conectada Express, no puedes leer ni actualizar su información de KYC.

El onboarding de Connect requiere que especifiques una return_url y una refresh_url para gestionar todos los casos en los que se redirige a la cuenta conectada a tu plataforma. Es importante implementarlas correctamente para que la cuenta conectada tenga la mejor experiencia.

return_url

Stripe redirige al usuario a esta URL cuando la cuenta conectada 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 transmite ningún estado a través de esta URL. Después de redirigir una cuenta conectada a tu return_url, verifica el estado del parámetro details_submitted en su cuenta por medio de uno de los siguientes métodos:

• Escucha los eventos account.updated con un webhook de Connect.
• Recupera la cuenta con la API.

refresh_url

Tu cuenta conectada será redirigida a la refresh_url en los siguientes casos:

• Se venció el enlace (pasaron algunos minutos desde la creación del enlace).
• Ya visitaron la URL (el usuario 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.

Configura tu refresh_url para activar un método en tu servidor para volver a llamar a Account Links con los mismos parámetros y redirige la cuenta conectada al flujo Connect Onboarding para crear una experiencia fluida.

Una cuenta conectada que es redirigida a tu return_url puede no haber completado el proceso de onboarding. Recupera la cuenta del usuario y verifica charges_enabled. Si no se completó el onboarding, proporciona solicitudes de IU para que el usuario pueda continuar el onboarding más tarde. Puede completar la activación de la cuenta a través de 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 ha completado el proceso de onboarding.