Afecta a
Equipos que construyen experiencias de extracto con operaciones de cuenta de Midaz, incluidos integradores, arquitectos de soluciones, ingenieros de backend y equipos de producto que definen vistas de actividad de la cuenta. Esta actualización se aplica al portal de documentación pública. No cambia el comportamiento de la API de Midaz en runtime.
Qué cambió
Nueva guía para construir extractos
Midaz ahora tiene una guía dedicada para construir extractos de cuenta a partir de 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 liquidadas centradas en operaciones con
balanceAffected=true - Agregar contexto de negocio mediante los metadatos de la transacción
Encuadre de cara al cliente más claro
La página hace explícito el modelo central: Midaz devuelve eventos del ledger. El sistema que integra convierte esos eventos en la experiencia de extracto que ven los usuarios finales. Esto evita tratar el endpoint de operaciones como una pantalla de extracto ya lista. Es el dato de origen de un extracto.Ejemplos prácticos
La guía incluye una vista del flujo, el mapeo de campos, reglas de visualización, guía de paginación, ejemplos de metadatos y una salida de extracto de muestra. Antes Los equipos tenían la referencia de API para listar operaciones de cuenta, pero ninguna guía única que conectara esas operaciones con un extracto de cara 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 solo de documentación. No se requiere migración. Las integraciones existentes de Midaz siguen funcionando como hoy. Usa la nueva guía al diseñar, implementar o revisar experiencias de extracto de cuenta que usan operaciones de cuenta de Midaz.
Qué debes hacer
1
Revisa la nueva guía de extractos de cuenta si tu producto muestra actividad de la cuenta, saldos o historial de transacciones a los usuarios finales.
2
Usa
direction, no type, para decidir si un valor aparece como entrante o saliente en el extracto.3
Agrega metadatos de negocio al crear transacciones si tu extracto necesita descripciones legibles, contrapartes, canales, categorías o referencias de pago.
4
Mantén las vistas de extracto liquidadas centradas en operaciones donde
balanceAffected=true.