![[IMP][MA] payment_nuvei: Procedimiento manual para conciliación de pagos post-procesamiento](/web/image/blog.post/122/author_avatar/%5BIMP%5D%5BMA%5D%20payment_nuvei:%20Procedimiento%20manual%20para%20conciliaci%C3%B3n%20de%20pagos%20post-procesamiento?unique=30125c9)
Contexto:
- Cuando se realiza una transaccion con Nuvei, se crear primero un registro de "Transaccion de pago", cuando se valida este registro (transaccion exitosa) se ejecutan diferentes procesos llamados postprocesamiento, entre estos procesos se encuentran por ejemplo la creacion de la factura cuando el pago es de una venta, o la conciliacion del pago con la factura, estas proceso son suceptibles a fallos si en algun punto existen restricciones para la creacion de facturas o conciliaciones de pago, lo que causa que el flujo de pagos se quede sin completar.
Detalles (Obligatorio)
Propósito de la sección:
Cuando un pago se confirma en Nuvei, el sistema debe completar automáticamente pasos adicionales como generar una factura o registrar el pago. Si alguno de estos pasos fallaba, el proceso quedaba incompleto y era difícil identificar la causa.- Ahora, el sistema gestiona estos errores de forma más controlada, facilitando su detección y corrección sin afectar el resto del flujo de pagos.
Qué debe contener:
- 1 o 2 párrafos cortos (no bullets).
- Lenguaje no técnico o mínimamente técnico.
- Enfocado en el problema que existía y la mejora introducida.
- Si aplica, mencionar el área/módulo donde se encuentra el cambio (sin usar nombres internos de módulos).
- Debe contener por lo menos una imagen.
Guía para redactar (estructura sugerida):
- Situación previa (breve):
- “Antes, los usuarios experimentaban…”
- Qué se hizo (resumen del cambio):
- “Se mejoró / corrigió / ajustó…”
- Resultado esperado (beneficio general):
- “Esto permite…”, “Con esto se logra…”.
¿Qué cambia? (Obligatorio)
Propósito de la sección:
Desglosar de forma clara y accionable los cambios más relevantes en formato de lista.
Qué debe contener:
- Entre 1 y 5 bullets como máximo.
- Cada punto debe iniciar con un verbo en pasado:
- “Se mejoró…”, “Se corrigió…”, “Se optimizó…”, “Se agregó…”, “Se ajustó…”
- Enfocado en cambios visibles o relevantes para el usuario.
Guía para redactar:
Cada bullet debe responder a una de estas preguntas:
- ¿Qué ahora funciona mejor?
- ¿Qué error se corrigió?
- ¿Qué nueva capacidad tiene el usuario?
Detalle técnico (Opcional)
Propósito de la sección:
Documentar cambios internos relevantes que no son necesarios para todos los usuarios, pero sí útiles para soporte, auditoría o desarrollo.
Usar cuando:
- Hay cambios de librerías, arquitectura o lógica interna.
- El cambio puede ser relevante para troubleshooting futuro.
- Se requiere trazabilidad técnica.
Qué debe contener:
- 1 a 3 bullets como máximo.
- Lenguaje técnico aceptable.
- Evitar detalles excesivamente bajos (logs, funciones internas específicas).
Cambios:
- Se crea una acción manual para permitir reintentar el postprocesamiento de la transacción, se informan los errores por los cuales no se logra realizar el postprocesamiento de la transaccion:
Acción:
Manejo de errores durante el postprocesamiento:
Postprocesamiento terminado:
[IMP][MA] payment_nuvei: Procedimiento manual para conciliación de pagos post-procesamiento