Afecta a
Equipos que concilian transacciones Pix con Matcher. Esta actualización aplica al portal de documentación pública. No cambia el comportamiento de la API en tiempo de ejecución, a menos que la documentación de producto enlazada indique lo contrario.
Qué cambió
Publicamos una guía completa de caso de uso para conciliar transacciones Pix con Matcher: Conciliación de Pix con Matcher. Esta guía te lleva por:
- Flujos de transacción — Diagramas de cash-in y cash-out que muestran cómo las transacciones Pix pasan de la iniciación a la liquidación en SPI y a la conciliación en Matcher
- Configuración paso a paso — Crear contextos, fuentes (LEDGER para Midaz, CUSTOM para extractos de BACEN SPI), mapas de campos y reglas de coincidencia
- Operaciones diarias — Sube el extracto de BACEN, ejecuta DRY_RUN antes de COMMIT, revisa las excepciones
- Reglas de coincidencia — Coincidencia EXACT sobre
endToEndIden la prioridad 1, con un respaldo DATE_LAG en la prioridad 10 para liquidaciones D+1 - Ejemplo práctico — Un escenario resuelto con cuatro transacciones: coincidencias exactas, coincidencias con desfase de fecha D+1 y casos de excepción
- Manejo de excepciones — Qué hacer cuando las transacciones aparecen en una fuente pero no en la otra, o cuando los montos o las fechas no coinciden
Corrección
El tipo de fuente de Matcher se corrigió de"type": "MIDAZ" a "type": "LEDGER" en la guía de integración con Midaz.
Impacto
Esta es una actualización de documentación. Las integraciones existentes no necesitan una migración solo por esta nota de versión.
Qué debes hacer
1
Revisa el caso de uso de conciliación de Pix antes de configurar las fuentes, los mapas de campos y las reglas de coincidencia de Matcher para los flujos Pix.