Como solucionar 'El intento de pago de Stripe fallo porque se requiere una accion adicional'

Si encuentras el error de Stripe "el intento de pago fallo porque se requiere una accion adicional", esta guia explica que lo causa y como resolverlo.

Que causa este error

Este error ocurre tipicamente debido a los requisitos de Autenticacion Reforzada de Cliente (SCA) segun las regulaciones europeas PSD2. La SCA requiere autenticacion de dos factores para muchos pagos en linea, lo que significa que los clientes deben verificar su identidad a traves de su banco antes de que se complete el pago.

Cuando un pago requiere SCA pero tu integracion no gestiona el flujo de autenticacion, Stripe devuelve este error.

Como solucionarlo

Para clientes

1. Revisa tu aplicacion bancaria o correo electronico. Tu banco puede haber enviado una solicitud de autenticacion que necesita aprobacion.
2. Intenta el pago de nuevo. Algunos bancos requieren que apruebes explicitamente la transaccion a traves de su aplicacion movil o sitio web.
3. Contacta a tu banco. Si el problema persiste, tu banco puede estar bloqueando la transaccion y puede ayudar a autorizarla.
4. Usa un metodo de pago diferente. Si tu tarjeta principal sigue fallando, prueba con una tarjeta alternativa o un metodo de pago diferente.

Para desarrolladores

1. Implementa la API de Payment Intents de Stripe. La API de Charges antigua no soporta SCA. Payment Intents gestiona el flujo de autenticacion automaticamente.
2. Usa Stripe.js y Stripe Elements. Estas herramientas del lado del cliente gestionan el popup de autenticacion 3D Secure que los bancos requieren.
3. Gestiona el estado requires_action. Cuando un PaymentIntent devuelve este estado, usa stripe.confirmCardPayment() en el lado del cliente para activar el flujo de autenticacion del banco.
4. Actualiza los manejadores de webhooks. Asegurate de que tu backend gestione el evento payment_intent.succeeded que se activa despues de una autenticacion exitosa, no solo el evento de creacion inicial.

Flujo de ejemplo

1. El cliente envia el pago
2. Stripe devuelve PaymentIntent con estado: requires_action
3. Tu frontend llama a stripe.confirmCardPayment(clientSecret)
4. El cliente completa la autenticacion bancaria (popup 3D Secure)
5. Stripe confirma el pago y activa el webhook
6. Tu backend procesa el pago exitoso

Prevencion de problemas futuros

• Siempre usa la API de Payment Intents para nuevas integraciones
• Prueba con los numeros de tarjeta de prueba SCA de Stripe (por ejemplo, 4000 0027 6000 3184 para autenticacion requerida)
• Implementa un manejo de errores adecuado para todos los estados de pago
• Mantiene actualizadas las versiones de tu biblioteca de Stripe

El requisito de SCA afecta a todos los negocios que procesan pagos de clientes europeos. Implementar la autenticacion de pagos adecuada no es opcional -- es un requisito regulatorio.