Afecta
Equipos que construyen experiencias de extracto con operaciones de cuenta de Midaz, incluyendo integradores, arquitectos de soluciones, ingenieros de backend y equipos de producto que definen vistas de actividad de cuenta. Esta actualización se aplica al portal de documentación pública. No cambia el comportamiento del API en tiempo de ejecución de Midaz.
Qué cambió
Nueva guía para construir extractos
Midaz ahora cuenta con una guía dedicada para construir extractos de cuenta a partir de las operaciones del ledger. La guía explica cómo:- Recuperar las operaciones de cuenta de un período específico
- Aplicar filtros de consulta y paginación
- Transformar cada operación en una fila del extracto
- Usar
directionpara mostrar valores entrantes y salientes - Tratar
ON_HOLDyRELEASEcomo eventos de bloqueo y liberación de saldo - Mantener las vistas de extracto liquidado enfocadas en operaciones con
balanceAffected=true - Añadir contexto de negocio mediante metadata de la transacción
Encuadre orientado al cliente más claro
La página explicita el modelo central: Midaz devuelve eventos del ledger. El sistema integrador transforma esos eventos en la experiencia de extracto que los usuarios finales ven. Esto evita tratar el endpoint de operaciones como una pantalla de extracto lista para usar. Son los datos de origen para un extracto.Ejemplos prácticos
La guía incluye una vista de flujo, mapeo de campos, reglas de visualización, orientación sobre paginación, ejemplos de metadata y una salida de ejemplo del extracto. Antes Los equipos contaban con la referencia API para listar operaciones de cuenta, pero no había una única guía que conectara esas operaciones con un extracto orientado al usuario. Después Los equipos pueden seguir una sola página para pasar de las operaciones de cuenta a una vista de extracto renderizada.Impacto
Esta es una actualización exclusivamente de documentación. No se requiere migración. Las integraciones existentes de Midaz siguen funcionando como hasta ahora. Usa la nueva guía al diseñar, implementar o revisar experiencias de extracto de cuenta que utilicen operaciones de cuenta de Midaz.
Qué necesitas hacer
Revisa la nueva guía de extracto de cuenta si tu producto muestra actividad de cuenta, saldos o historial de transacciones a usuarios finales.
Añade metadata de negocio al crear las transacciones si tu extracto necesita descripciones amigables al usuario, contrapartes, canales, categorías o referencias de pago.