Ir a contenido
Crea una cuenta
 o
Inicia sesión
Logotipo de Stripe Docs
/
Crear una cuenta
Iniciar sesión

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.

Copiar página

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 y puede procesar cobros por sí sola.

El modelo de integración de Stripe, Kavholm, te muestra cómo usar el onboarding de Connect para tener una experiencia de onboarding de usuarios fluida.

Captura de pantalla del formulario de Onboarding de Connect

Empezar

Si eres nuevo en Connect, comienza con una guía sobre el uso de cuentas Standard para habilitar a otras empresas a aceptar pagos directamente.

Cómo usar el onboarding de Connect para cuentas Standard

  1. 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 necesita esta información.

  2. Usa la API /v1/accounts para crear 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

    Nota

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

  3. Llama a la API Account Links para crear un enlace para que la cuenta se incorpore.

  4. En el flujo de onboarding de tu plataforma, redirige al usuario a la url devuelta por Account Links.

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

  6. 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 en el Dashboard.

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

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.

Nota

This example includes only some of the fields you can set when creating an account. For a full list of the fields you can set, such as address and website_url, see the Create Account API reference.

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

If you’ve already collected information for your connected accounts, you can prefill that information on the Account object. You can prefill any account information, including personal and business information, external account information, and so on.

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.

Crear un enlace de cuenta

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
Command Line
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

Redirigir al usuario a la URL del enlace de cuenta

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.

Consejo de seguridad

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.

Nota

Puedes usar HTTP para tu return_url y refresh_url mientras estás en un entorno de prueba (por ejemplo, para probar con localhost), pero solo puedes usar HTTPS en modo activo. Asegúrate de cambiar las URL de prueba por 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 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:

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

Consulta también

¿Te fue útil esta página?
SíNo
¿Necesitas ayuda? Ponte en contacto con soporte.
Únete a nuestro programa de acceso anticipado.
Echa un vistazo a nuestro registro de cambios.
¿Tienes alguna pregunta? Contacto.
¿LLM? Lee llms.txt.
Con tecnología de Markdoc