Por qué Pix Switch
Históricamente, soportar Pix con diferentes proveedores de conectividad significaba mantener plugins separados y aislados — uno por proveedor, cada uno con su propio código, contratos de API y patrones de integración. Esto creaba problemas reales:
- Lógica de negocio duplicada — Las mismas reglas de Pix tenían que implementarse y mantenerse de forma independiente en cada plugin
- Contratos de API diferentes — Cada integración con un proveedor exponía una API diferente al cliente, dificultando cambiar o agregar proveedores
- Mayor costo de mantenimiento — Correcciones de errores, actualizaciones regulatorias y nuevas funcionalidades tenían que aplicarse por separado en cada plugin
- Sin portabilidad — Migrar de un proveedor a otro requería una reintegración completa
Qué proporciona Pix Switch
Pix Switch entrega una capa de orquestación Pix completa que maneja el ciclo de vida comercial completo de las operaciones Pix:
- Flujos de cash-out y cash-in — Envía y recibe pagos Pix con gestión completa del ciclo de vida de mensajes
- Gestión de claves Pix (DICT) — Crea, actualiza, elimina y resuelve la propiedad de claves Pix
- Generación de QR Codes estáticos y dinámicos — Emite QR Codes para iniciación de pagos en todos los formatos soportados
- Orquestación del ciclo de vida MED — Gestiona el Mecanismo Especial de Devolución (Mecanismo Especial de Devolucao) de extremo a extremo
- Manejo de reembolsos — Procesa reembolsos totales y parciales con la secuencia regulatoria adecuada
- Webhooks, procesamiento de eventos y workers en segundo plano — Reacciona a eventos del proveedor en tiempo real y ejecuta trabajos asíncronos de manera confiable
- Integración nativa con Midaz — Midaz es el libro mayor obligatorio para Pix Switch, proporcionando validación de cuentas, verificaciones de saldo, registros de débito/crédito y enrutamiento
Cómo funciona
Pix Switch utiliza una Capa de Adaptador de Proveedor para separar tu integración de las especificidades de cualquier proveedor de conectividad individual. El plugin expone una única API a tu aplicación. Detrás de esa API, un adaptador de proveedor traduce cada operación — transacciones, búsquedas de claves, registros de QR Code, reembolsos — al protocolo y formato requerido por tu proveedor configurado. Tu institución selecciona qué proveedor usar durante la configuración. El plugin resuelve todo lo demás. Esta arquitectura significa que cambiar de proveedor o soportar modelos de participación adicionales no requiere reescribir tu integración. Cambias la configuración. La API permanece igual.
La conectividad regulada siempre es externa. Pix Switch no se conecta a BACEN directamente. Un participante directo o un PSTI certificado proporciona la capa de gateway SPI/DICT. Pix Switch opera por encima de esa capa, manejando toda la lógica de negocio Pix.
Modelos de participación
BACEN define dos modelos regulatorios de participación Pix: directo (tu institución se conecta a BACEN por cuenta propia) e indirecto (te conectas a través de un participante directo licenciado). Para una explicación detallada de cada modelo, consulta Qué es Pix?. En Pix Switch, el modelo de participación es una configuración — no un producto diferente. Ambos modelos son soportados a través de la Provider Adapter Layer. Eliges un proveedor que corresponda a tu estatus regulatorio, y la API del plugin permanece igual. Cambiar de proveedor o actualizar tu modelo de participación no requiere reintegración.
Integraciones en el ecosistema Lerian
Pix Switch requiere Midaz como su libro mayor central. Esta integración nativa simplifica:
- Validación de cuentas
- Verificaciones de saldo
- Registros de débito/crédito
- Enrutamiento
- Reglas de negocio (tarifas, autorizaciones, disparadores antifraude)
- CRM (Midaz CRM) — Gestión de relaciones con clientes y entidades
- Fee Engine — Cálculo y cobro automatizado de tarifas
- Access Manager — Autenticación, autorización y gobernanza de credenciales
- Reporter — Reportes regulatorios y listos para COSIF
- Matcher — Conciliación y emparejamiento de identidad
- Flowker — Orquestación de flujos de trabajo
- Tracer — Observabilidad y trazado distribuido
Modelo de despliegue
Pix Switch se proporciona como software de aplicación independiente que tu institución instala y opera en su propio entorno:
- BYOC (Bring Your Own Cloud) — Despliega en tu proveedor de nube preferido
- On-premise — Ejecuta dentro de tu propio centro de datos
Audiencia objetivo
Pix Switch está diseñado para instituciones que:
- Participan en el arreglo Pix (o pretenden hacerlo)
- Mantienen su propio libro mayor y controlan cuentas y saldos de clientes
- Poseen un ISPB válido (identificador asignado por BACEN a instituciones financieras en Brasil)
- Gestionan sus propios entornos de producción
- Prefieren autonomía sobre procesamiento externalizado
Requisitos para operar
Antes de adoptar Pix Switch, tu institución debe contar con:
- Un ISPB válido registrado ante BACEN
- Un contrato con un proveedor de conectividad — un participante directo (para participación indirecta) o un PSTI certificado (para participación directa), dependiendo de tu modelo regulatorio
- Tu propio entorno cloud u on-premise para alojar el plugin
- Control total del libro mayor — Midaz debe estar desplegado y operativo
- Preparación de DevOps y SRE — tu equipo gestiona despliegue, monitoreo, actualizaciones y respuesta a incidentes
- Propiedad de seguridad y cumplimiento — tu institución es responsable del control de acceso, redundancia, observabilidad y pistas de auditoría
Ventajas
Control total
Ejecuta todo en tu propia infraestructura. Define reglas de enrutamiento, políticas de negocio, límites y prácticas operacionales sin dependencias externas.Seguridad y autonomía
Aplica tus propias políticas IAM, estándares de cifrado y marcos de gobernanza. Tus datos nunca salen de tu entorno.Eficiencia económica
Dimensiona la infraestructura para tu demanda real. Elimina la dependencia de intermediarios multicapa que agregan costo sin agregar control.Integraciones nativas del ecosistema
Conéctate a Midaz, Fee Engine, CRM, Matcher, Flowker, Reporter, Tracer y Access Manager de forma nativa. Cada integración está incorporada en la plataforma, no añadida después.Personalización
Extiende o modifica la lógica de negocio para cumplir con los requisitos específicos de tu institución. Adáptate a cambios regulatorios a tu propio ritmo.Compensaciones
Pix Switch ofrece máximo control, pero ese control viene con responsabilidades.
Requiere madurez técnica
Tu institución necesita capacidades de DevOps, herramientas de observabilidad y experiencia en gestión operacional. Esto no es un servicio gestionado.Requiere disciplina de gobernanza
La seguridad, el tiempo de actividad, el cumplimiento y la preparación para auditorías deben ser mantenidos por tu equipo.Más configuración inicial
La flexibilidad significa más orquestación y parametrización durante la configuración inicial. Planifica un proceso de incorporación estructurado.Responsabilidad operacional
Tu institución gestiona actualizaciones de software, parches, escalado y planes de continuidad. Lerian proporciona el software y la documentación — tu equipo lo opera. Este modelo es más adecuado para instituciones que valoran autonomía, escalabilidad y optimización de costos a largo plazo sobre la simplicidad de la configuración inicial.Casos de uso de Pix con Midaz
Mira cómo Pix Switch y Midaz trabajan juntos en la práctica:
Pix con Rutas de Transacción
Modela flujos de transferencia Pix validados y reutilizables usando Rutas de Transacción y Rutas de Operación — desde transferencias simples hasta cobro de tarifas.
Pix con tarifas automatizadas
Combina Pix Switch con el Fee Engine para una gestión de tarifas transparente y automatizada en fintechs y marketplaces.