Si no puedes encontrar ninguna cuenta conectada que acabe de hacer el onboarding después de completar OAuth, es probable que se deba a un problema de configuración. Esta guía te ayudará a comprobar tu configuración y a corregir cualquier problema para garantizar que las conexiones de las cuentas funcionen sin problemas.

---

Causa habitual

La falta de una cuenta conectada suele ocurrir cuando:

• El URI de redireccionamiento de OAuth está configurado incorrectamente o falta.
• El punto de conexión de redireccionamiento lleva automáticamente a los usuarios a una página de pago efectuado correctamente sin completar el flujo de conexión de la cuenta.
• Tu plataforma sigue utilizando Express OAuth, que ha quedado obsoleto.

Qué se debe comprobar

1. Configuración de OAuth
   • Dirígete a tu Dashboard de Stripe → Configuración → Connect → Opciones de onboarding → Configuración de OAuth.
   • Comprueba que el URI de redireccionamiento apunte a un punto de conexión que pueda gestionar correctamente la respuesta de autorización de OAuth.
2. Comportamiento del URI de redireccionamiento
   • Asegúrate de que el URI de redireccionamiento capture y procese la respuesta de OAuth (código de autorización y estado).
   • Evita redirigir inmediatamente a los usuarios a una página de pago efectuado correctamente (por ejemplo, /billing-success/) sin procesar la respuesta de OAuth.
3. Finalización de OAuth
   • Confirma que tu integración finaliza la conexión con la cuenta después de recibir la respuesta de autorización.
   • Vuelve a verificar los registros de tu servidor o de Stripe para asegurarte de que account_id se ha generado y vinculado.
4. Obsolescencia de Express OAuth
   • Si sigues usando Express OAuth, te recomendamos que aproveches la API Account/AccountLink

Cómo corregirlo

• Actualiza el URI de redireccionamiento a un punto de conexión activo capaz de gestionar correctamente la respuesta de OAuth.
• Reinicia el onboarding de OAuth para la(s) cuenta(s) conectada(s) afectada(s).
• Prueba el flujo para asegurarte de que las cuentas se conectan y aparecen correctamente en tu Dashboard.

Consejos adicionales

• Usa los registros de OAuth de Stripe para rastrear la solicitud de autorización y la respuesta.
• Revisa tu gestión de los parámetros code y state de OAuth por parte del servidor para asegurarte de que se está creando o actualizando la cuenta.
• Considera la posibilidad de añadir un registro básico en tus puntos de conexión de OAuth para detectar y diagnosticar problemas futuros con antelación.

Recursos relacionados

• Documentación de OAuth de Stripe Connect
• OAuth de Connect: vinculación de cuentas con Stripe
• Onboarding de OAuth estándar: cómo funciona
• Gestión del redireccionamiento de OAuth y el intercambio de código
• Cómo probar los flujos de OAuth en Stripe
• Configuración de las URI de redireccionamiento para OAuth de Connect