> ## Documentation Index > Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt > Use this file to discover all available pages before exploring further. # Pix Switch > Pix Switch es el plugin Pix unificado de Lerian: una capa de aplicación, cualquier proveedor, con orquestación, llaves, QR Codes y disputas. Pix Switch es el plugin Pix de Lerian. Le da a tu institución todo lo que necesita para operar Pix en la capa de aplicación -- orquestación de transacciones, gestión de claves, QR Codes, reembolsos, resolución de disputas y más -- a través de un único producto unificado. La idea central: **un plugin, cualquier proveedor**. Tú eliges el proveedor de conectividad que se ajuste a tu modelo de participación. Pix Switch se encarga del resto. Lerian es un **proveedor de tecnología**. No somos un PSP, no somos un PSTI, y no proporcionamos conectividad SPI/DICT. La conectividad regulada siempre es realizada por un proveedor externo -- ya sea un participante directo o un PSTI certificado contratado por tu institución. La arquitectura y los contratos descritos en esta página reflejan el diseño actual del producto Pix Switch. # 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 Pix Switch resuelve esto centralizando toda la lógica Pix en un único producto con una **API unificada** y una **Provider Adapter Layer** que maneja la traducción específica de cada proveedor. El resultado: una integración, cualquier proveedor, sin retrabajo cuando tus necesidades de conectividad cambien. # 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?](/es/rails/pix/pix-overview). 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) Pix Switch también se conecta con otros productos del ecosistema Lerian: * **CRM (Midaz CRM)** -- Gestión de relaciones con clientes y entidades * **Fees 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 Juntos, forman un stack operacional completo para entornos Pix de alto volumen. # Modelo de despliegue *** Pix Switch sigue los mismos modelos de despliegue disponibles en toda la plataforma Lerian: **SaaS** y **BYOC** (Bring Your Own Cloud). Ambos dan acceso al producto completo — la diferencia es quién opera la infraestructura. * **SaaS** -- Lerian aloja y opera Pix Switch en un entorno completamente gestionado. Tu equipo se enfoca en la configuración del producto y la integración. Lerian se encarga de la infraestructura, actualizaciones y disponibilidad. * **BYOC** -- Tu institución despliega y opera Pix Switch en su propia infraestructura — ya sea en una nube pública, nube privada u on-premises. Para una comparación detallada de ambos modelos, consulta [SaaS y BYOC](/es/deployment-models). # Audiencia objetivo *** Pix Switch está diseñado para instituciones que: * Participan en el arreglo Pix (o pretenden hacerlo) * Poseen un **ISPB** válido (identificador asignado por BACEN a instituciones financieras en Brasil) * Son propietarias del libro mayor a nivel de negocio -- tu institución controla cuentas y saldos, independientemente de dónde se ejecute la infraestructura Ya sea que tu equipo gestione su propia infraestructura (BYOC) o prefiera un entorno completamente gestionado (SaaS), Pix Switch se adapta a tu modelo operativo. **No es adecuado para** instituciones donde un tercero controla el libro mayor o la gestión de cuentas a nivel de negocio. Si tus cuentas y saldos residen dentro del dominio de un proveedor BaaS -- no solo de su infraestructura -- Pix Switch no es la opción adecuada. La institución debe ser propietaria de la capa de libro mayor a nivel lógico, independientemente del modelo de despliegue. # 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 * **Propiedad lógica del libro mayor** -- Midaz debe estar desplegado y operativo, con tu institución controlando cuentas y saldos **Requisitos adicionales para BYOC:** * Tu propio **entorno cloud u on-premise** para alojar el plugin * **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 En el modelo **SaaS**, Lerian gestiona la infraestructura, el despliegue y la disponibilidad operativa. Tu institución sigue siendo responsable de la **conectividad regulada** y la **configuración de negocio**. # Ventajas *** ### Integraciones nativas del ecosistema Conéctate a Midaz, Fees 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. ### Eficiencia económica Elimina la dependencia de intermediarios multicapa que agregan costo sin agregar control. En SaaS, llega a producción sin inversión inicial en infraestructura. En BYOC, dimensiona la infraestructura para tu demanda real. ### Camino más rápido a producción (SaaS) Entra en producción sin aprovisionar ni gestionar infraestructura. Lerian se encarga de las operaciones, actualizaciones y disponibilidad -- tu equipo se enfoca en construir productos financieros. ### Control total y soberanía de datos (BYOC) Ejecuta todo en tu propia infraestructura. Aplica tus propias políticas IAM, estándares de cifrado y marcos de gobernanza. Define reglas de enrutamiento, políticas de negocio y prácticas operacionales. Tus datos nunca salen de tu entorno. # Compensaciones *** Cada modelo de despliegue tiene diferentes compensaciones. ### SaaS * **Menos control sobre la infraestructura** -- Lerian gestiona el entorno. Tú configuras el producto, no la plataforma subyacente. * **Datos alojados por Lerian** -- Tus datos residen en infraestructura cloud gestionada por Lerian. Si tus requisitos regulatorios exigen residencia de datos en tu propio entorno, elige BYOC. ### BYOC * **Requiere madurez técnica** -- Tu institución necesita capacidades de DevOps, herramientas de observabilidad y experiencia en gestión operacional. * **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 las herramientas -- tu equipo lo opera. Para ayuda eligiendo el modelo adecuado, consulta [SaaS y BYOC](/es/deployment-models#which-model-is-right-for-you). # Casos de uso de Pix con Midaz *** Mira cómo Pix Switch y Midaz trabajan juntos en la práctica: 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. Combina Pix Switch con el Fees Engine para una gestión de tarifas transparente y automatizada en fintechs y marketplaces.