Cómo usar Connect con cuentas conectadas Standard

Use the Create Account API to create a connected account with type set to standard. 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. If you know what capabilities the account needs, you can request them when you create it.

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

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.

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

Puedes crear un enlace de cuenta llamando a la API Account Links 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

La respuesta a tu solicitud de Account Links 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 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 (KYC). Completa automáticamente toda la información de KYC antes de crear el primer enlace de cuenta.

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.

return_url

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

No state is passed through this URL. After redirecting a user to your return_url, check the state of the details_submitted parameter on their account by doing either of the following:

• Escuchando los webhooks account.updated
• Llamando a la API Accounts e inspeccionando el objeto devuelto

refresh_url

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

• The link expired (a few minutes went by since the link was created)
• The user already visited the link (they refreshed the page, or clicked back or forward in the browser)
• 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 con los mismos parámetros y redirigir al usuario al flujo de onboarding de Connect para crear una experiencia fluida.

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 charges_enabled. Si la cuenta no ha finalizado todo el proceso de onboarding, presenta un mensaje 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ó la activación.