Resumen
Se mejora el manejo de errores en transacciones con el método de pago Nuvei cuando una factura incluye más de un grupo de impuesto de IVA. Antes, el sistema devolvía un error genérico y poco claro; ahora se agrega una validación específica que informa al cliente el motivo exacto por el que la transacción no puede completarse.
Detalles
Situación previa:
- El método de pago Nuvei no permite aplicar más de un grupo de impuesto de IVA distinto de 0% en una misma transacción.
- Cuando esto ocurría, Nuvei devolvía un error genérico, sin mayor detalle sobre la causa.
- Ese mensaje se mostraba directamente en el wizard de pagos, sobre el cual no se tenía control de presentación.
- Lo único visible era un texto pequeño en la esquina inferior, casi imperceptible, que solo indicaba ValidationError, sin ninguna explicación adicional.
- Esto generaba confusión, ya que el cliente no entendía por qué su pago no podía procesarse.
Se realizó:
Identificación del caso de error
Se detectó que el problema se presentaba en facturas con productos gravados con distintos porcentajes de IVA (por ejemplo, IVA 15% e IVA 5%) dentro de una misma factura.
Validación específica antes de iniciar el pago
Se incorporó una validación que revisa los grupos de impuesto de IVA presentes en la factura antes de intentar iniciar la transacción con Nuvei. Si se detecta más de un grupo de impuesto distinto de 0%, el sistema detiene el proceso y muestra un mensaje claro al usuario.
Mensaje de error controlado
En lugar de dejar que el error genérico de Nuvei llegue sin control al wizard de pagos, ahora se genera un mensaje propio, explicando:
- Que el método de pago Nuvei no permite más de un grupo de impuesto de IVA diferente de 0% en la misma transacción.
- Los impuestos concretos encontrados en la factura (por ejemplo: IVA 15%, IVA 5%).
- La recomendación de separar las facturas para que cada una tenga un único tipo de impuesto de IVA, o de utilizar un método de pago diferente.
Sección de información para soporte
Se agrega además un bloque adicional con la información técnica del error, pensado para el equipo de soporte, de modo que se pueda dar seguimiento o diagnóstico sin depender únicamente del mensaje mostrado al cliente.
Resultado esperado
Con esta mejora:
- El cliente recibe un mensaje claro y específico sobre por qué no puede completar su pago.
- Se elimina la dependencia del mensaje genérico ValidationError que antes aparecía casi invisible en el wizard de pagos.
- Se reduce la confusión y los tickets de soporte relacionados a pagos fallidos sin explicación.
- El equipo de soporte cuenta con información técnica adicional para dar seguimiento al caso.
¿Qué cambia?
- Se agrega una validación previa al inicio de la transacción con Nuvei que revisa los grupos de impuesto de IVA de la factura.
- El error genérico de Nuvei deja de mostrarse sin control en el wizard de pagos.
- Se genera un mensaje de error propio y descriptivo, indicando los impuestos encontrados y la acción recomendada.
- Se incorpora una sección adicional de información técnica para el equipo de soporte.
Detalle técnico (Opcional)
Módulo: Método de pago Nuvei
- Se agrega validación previa a la creación de la transacción, revisando los grupos de impuesto de IVA presentes en la factura.
- Se controla la excepción antes de que el mensaje genérico de Nuvei llegue al wizard de pagos.
- Se construye un mensaje de error propio, específico y legible para el usuario final.
- Se incluye un bloque adicional de información técnica orientado al equipo de soporte.
Ajustar cálculo de impuestos y agregar validaciones para transacciones Nuvei con múltiples impuestos