> ## 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. # Transacciones > Sigue una transacción Pix de extremo a extremo: inicio, autenticación, liquidación en el SPI, ID E2E y crédito instantáneo, más los patrones de cash-in y cash-out. Representan el movimiento en tiempo real de fondos entre cuentas de todos los participantes de Pix, según los estándares técnicos y regulatorios del Banco Central de Brasil (BACEN). Las transacciones Pix apuntan a velocidad, trazabilidad e interoperabilidad. Mantienen un comportamiento consistente sin importar la institución o el canal de front-end. # Características clave *** Las transacciones Pix comparten una base común en todas las instituciones: ### Liquidación instantánea Los fondos típicamente liquidan en **10 segundos**. El SPI garantiza la finalización o maneja el timeout de forma transparente. ### Disponibilidad 24/7 Pix opera de forma continua, incluidos fines de semana, feriados y fuera del horario comercial. ### Irrevocabilidad Después de que un Pix se completa y acredita al receptor, solo los flujos regulados pueden revertirlo (devoluciones, Devoluções, MED). ### ID de extremo a extremo (E2E) Cada transacción Pix recibe un identificador E2E único para auditabilidad, conciliación y manejo de disputas. ### Interoperabilidad Cualquier participante de Pix puede enviar o recibir Pix de cualquier otro, independiente de la institución, la plataforma o el canal. ### Límites configurables Las instituciones deben aplicar límites regulatorios e internos para seguridad y control de fraude. # Cómo funciona una transacción Pix (flujo de extremo a extremo) *** Flujo de extremo a extremo de una transacción Pix entre la institución pagadora y la receptora A continuación, una vista simplificada entre instituciones de una transacción Pix: 1. **Inicio** El usuario empieza una transferencia Pix con uno de los métodos de direccionamiento disponibles: * Clave Pix * Código QR (estático o dinámico) * Datos bancarios manuales * Código EMV para copiar y pegar Para saber más sobre los códigos QR de Pix, visita la [documentación de códigos QR](/es/interfaces/pix/main-domains-qrcodes). 1. **Autenticación y autorización** La institución emisora debe autenticar al usuario con mecanismos fuertes (por ejemplo, biometría, 2FA, confianza del dispositivo). El consentimiento del usuario es obligatorio. 2. **Validación y verificaciones de riesgo** Antes de enviar cualquier cosa al SPI, la institución debe validar: * Condición de la cuenta (activa, no bloqueada, KYC verificado) * Disponibilidad de saldo * Límites (por transacción, diario, nocturno, mensual) * Validez de la clave Pix (si aplica) * Evaluaciones de riesgo (indicadores antifraude, verificaciones de velocidad) 3. **Intento de liquidación (SPI)** La institución envía la transferencia al **SPI (Sistema de Pagos Instantáneos de BACEN)**, que: * Valida el mensaje * Lo enruta a la institución receptora * Liquida la transacción entre instituciones 4. **Crédito al receptor** La institución receptora debe acreditar la cuenta **de inmediato**, incluso si: * Ocurre fuera del horario comercial * Los sistemas están bajo carga * El monto es alto (excepto en casos marcados por antifraude) 5. **Notificaciones y generación del E2E** * Ambas instituciones reciben el estado actualizado de la transacción * La transacción recibe un **ID E2E** único * Los webhooks o las notificaciones internas actualizan los sistemas y a los usuarios # Tipos de transacción Pix *** Las transacciones Pix caen en unas pocas categorías estandarizadas que BACEN rige. ## 1. Cash-out (enviar Pix) El pagador envía fondos a otra cuenta con una clave Pix, un código QR o datos bancarios. **Flujo (resumen):** 1. El usuario inicia la transferencia 2. La institución revisa saldo + límites + clave 3. La institución envía la transacción al SPI 4. El receptor acredita al instante 5. Ambas partes reciben actualizaciones + ID E2E Escenarios comunes: * Transferencias P2P * Pagos a comercios * División de cuentas * Pagos divididos de marketplace (cuando se combinan con Pix Cobrança) ## 2. Cash-in (recibir Pix) El cliente recibe una transferencia Pix de cualquier otra institución. **Flujo (resumen):** 1. El SPI notifica a la institución receptora 2. La institución debe acreditar la cuenta de inmediato 3. La institución despacha notificaciones para la conciliación 4. La institución registra la transacción con un ID E2E Escenarios comunes: * Pagos de salarios o desembolsos corporativos * Liquidaciones de comercios * Pagos recurrentes de clientes ## 3. Devolución (Devolução) Flujo regulado que permite a las instituciones regresar fondos al remitente original. Lo siguiente puede disparar una devolución: * Solicitud del cliente * Devoluciones de comercios * Pagos duplicados * Errores operativos * Casos MED relacionados con fraude Una devolución debe: * Usar la mensajería estándar de BACEN * Ligarse a la transacción original * Seguir las reglas de valor y de elegibilidad ## 4. Reversión (chargeback / pacs.004) Se usa en casos regulados especiales, a menudo ligados a MED o a correcciones operativas. Las reversiones siguen reglas estrictas de BACEN y **no** son lo mismo que las devoluciones de comercios. # Cash-out: patrón de transferencia en dos fases *** La plataforma Lerian procesa un cash-out Pix con un **patrón de dos fases** que separa la validación del movimiento de fondos. ## Por qué dos fases Una transferencia Pix involucra varias validaciones: consulta de clave, verificación de cuenta, revisión de saldo, aplicación de límites y evaluación antifraude. Un paso único que las ejecuta todas crea riesgo. Si algo falla después de una ejecución parcial, la reversión se vuelve compleja. El patrón de dos fases resuelve esto al dividir el proceso: 1. **Fase 1 (iniciar)**: Validar todo sin mover fondos 2. **Fase 2 (procesar)**: Ejecutar la transferencia de fondos con los datos validados Esta separación da varias ventajas: * **Validación antes del compromiso**: Todas las verificaciones (saldo, límites, validez de la clave, antifraude) ocurren antes de que se mueva dinero * **Confirmación del usuario**: La aplicación que inicia puede mostrar al usuario los datos validados del destino antes de que confirme la transferencia * **Soporte de idempotencia**: La aplicación puede reintentar cada fase de forma independiente, sin transferencias duplicadas * **Cumplimiento**: La plataforma completa y registra las validaciones regulatorias antes de que empiece el movimiento de fondos ## Cómo funciona ### Fase 1: Iniciar La fase de inicio crea un registro de transferencia. Obtiene y valida la información del destino. No se mueven fondos en esta etapa. La plataforma admite tres tipos de inicio: | Tipo | Descripción | Entrada | | --------- | -------------------------------------------------------------- | -------------------------------------------------------------- | | `MANUAL` | Datos completos de la cuenta de destino dados de forma directa | Banco, sucursal, número de cuenta, documento, nombre | | `DICT` | Destino resuelto por consulta de clave Pix (DICT) | Valor de la clave Pix (CPF, correo electrónico, teléfono, EVP) | | `QR_CODE` | Destino extraído del payload de un código QR | Cadena BR Code (EMV) | Para los inicios `DICT` y `QR_CODE`, la plataforma consulta DICT para resolver la cuenta de destino. El inicio devuelve el nombre del titular de la cuenta, el documento y la institución, que la aplicación puede mostrar para la confirmación del usuario. El inicio devuelve un identificador único y un timestamp de vencimiento. La aplicación usa este identificador en la fase siguiente. ### Fase 2: Procesar La fase de procesamiento toma el inicio validado y ejecuta el movimiento de fondos real: * Verifica que el inicio sigue válido (no vencido, no procesado antes) * Debita la cuenta de origen en el ledger * Envía el pago a la infraestructura de liquidación de Pix (SPI) * Registra la transferencia con trazabilidad completa (ID de extremo a extremo, timestamps, estado) Después de que empieza el procesamiento, la transferencia sigue el flujo estándar de liquidación de Pix. No puedes cancelarla. El proceso regulado de devolución es la única forma de revertirla. ## Resumen del ciclo de vida | Paso | Qué pasa | ¿Se mueven fondos? | | ----------------------- | ------------------------------------------------------------------------ | :----------------: | | **Iniciar** | Validar el destino, revisar la clave/QR, resolver los datos de la cuenta | No | | **El usuario confirma** | La aplicación muestra los detalles, el usuario aprueba la transferencia | No | | **Procesar** | Debitar la cuenta de origen, enviar al SPI, acreditar el destino | Sí | | **Completar** | ID de extremo a extremo asignado, ambas partes notificadas | — | # Capas de validación (regulatorias + operativas) *** Cada transacción Pix pasa por varias validaciones antes de llegar al SPI: ### 1. Verificaciones de cuenta * Cuenta activa * No bloqueada * KYC completo ### 2. Disponibilidad de fondos * Saldo suficiente * Retenciones temporales liberadas ### 3. Validación de la clave Pix Si el usuario paga con una clave, la institución debe obtener y confirmar los datos del receptor desde DICT. ### 4. Límites regulatorios * Por transacción * Límite diario * Límite nocturno (obligatorio) ### 5. Verificaciones de riesgo y fraude Las instituciones pueden aplicar: * Verificaciones de velocidad * Fingerprinting de dispositivo * Analítica de comportamiento * Marcadores de fraude conocido ### 6. Idempotencia Cada transferencia Pix debe tener un ID de transacción único. Esto evita transferencias duplicadas durante los reintentos. # Controles operativos y seguridad *** ### Requisitos de autenticación La autenticación fuerte del cliente es obligatoria para todas las operaciones de envío de Pix. ### Notificaciones y webhooks Después de acreditar, las instituciones deben notificar a los sistemas y a los usuarios. Los webhooks permiten la conciliación en tiempo real. ### Manejo de errores Las categorías comunes de error incluyen: * Timeout * Clave inválida * Fondos insuficientes * Límite diario/nocturno excedido * Transacción sospechosa bloqueada ### Auditabilidad Pix exige trazabilidad completa: * Logs * Timestamps * ID E2E * Metadatos de la cuenta # Límites de transacción (reglas de BACEN) *** Los límites de transacción de Pix existen para reducir el riesgo de fraude, proteger a los usuarios finales y mantener la seguridad operativa en todo el ecosistema de pagos instantáneos. BACEN define **estándares mínimos de seguridad**, y las instituciones pueden agregar restricciones según su apetito de riesgo. Los límites de Pix caen en dos grupos: **límites regulatorios obligatorios** y **límites definidos por la institución**. ## 1. Límites regulatorios obligatorios (BACEN) ### Límite nocturno (tope por transacción) Las instituciones **deben** aplicar un límite máximo menor entre las **20:00 y las 06:00**. Requisitos regulatorios: * Máximo predeterminado: **R\$ 1.000** * Las instituciones pueden fijar un predeterminado menor (por ejemplo, R$ 500 o R$ 200) * Los clientes pueden **reducir** este límite al instante * Los clientes pueden **aumentar** este límite **solo después de una espera mínima de 24 horas** * Los clientes pueden **ajustar la ventana nocturna** (por ejemplo, extenderla a 18h–08h) Esta regla aplica a: * Transferencia Pix (cash-out) * Pago con código QR de Pix * Pix Saque/Troco * Pagos de Pix Cobrança iniciados de noche Su propósito es prevenir el fraude durante las horas de mayor riesgo. ### Permiso para límites controlados por el cliente Las instituciones deben ofrecer a los clientes la capacidad de **configurar sus propios límites**, por: * Transacción * Día * Máximo nocturno * Otras formas de segmentación basada en riesgo Estos cambios deben respetar las reglas de tiempo de BACEN: * **Reducciones** → deben tener efecto **de inmediato** * **Aumentos** → solo pueden tener efecto **después de un mínimo de 24 horas** (retraso de seguridad) ### Obligación de analizar las solicitudes de aumento de límite Cada institución debe: * Aceptar las solicitudes de los clientes para aumentar límites * Evaluarlas mediante criterios de riesgo * Conceder o denegar según la política de fraude * Aplicar los aumentos solo **después del período de espera regulatorio (24h+)** ### Límites de Saque/Troco (cash-out en comercios) Pix Saque y Pix Troco tienen sus propios topes: * Predeterminado: **R\$ 500** por transacción * Las instituciones pueden ofrecer de forma voluntaria hasta **R\$ 3.000** por transacción * Los clientes pueden reducir este límite al instante * Los aumentos siguen la misma regla de 24h Estos límites *no* afectan las transferencias normales. Son específicos de las modalidades de retiro de efectivo. ### Obligaciones de crédito (independientes de los límites) Incluso si una transferencia excede los límites, después de que el receptor recibe el **crédito**: * La transacción se vuelve **irrevocable** * Solo los flujos de MED o de devolución pueden revertirla * Las instituciones no pueden “deshacer” un Pix completado por iniciativa propia ## 2. Límites definidos por la institución (configurables) Más allá de las reglas obligatorias, las instituciones pueden agregar sus propios controles, como: ### Límite por transacción Monto máximo permitido para una sola operación Pix. ### Límite diario Tope del monto total de Pix por usuario por día calendario. ### Límite mensual (opcional) Lo usan sobre todo las cuentas corporativas o los modelos de riesgo de fintechs. ### Segmentación basada en riesgo Las instituciones pueden ofrecer: * Límites más estrictos para clientes nuevos (ej.: primeros 7 días) * Límites distintos para usuarios de alto riesgo o cuentas marcadas * Límites dinámicos ajustados por el comportamiento del cliente Estos controles internos nunca deben entrar en conflicto con los requisitos de BACEN. Solo los complementan. ## 3. Reglas operativas que exige BACEN ### Reducción inmediata de límite Los clientes pueden bajar sus límites al instante. ### Aumento de límite con retraso Todos los aumentos deben respetar: * **24 horas como mínimo** antes de tener efecto * Un período de espera adicional opcional (elección de la institución) ### Horas de riesgo pico Los límites nocturnos aplican específicamente a los **flujos de cash-out**, ya que representan el vector principal de pérdidas por fraude. ### Aplicación en tiempo real Las instituciones deben revisar los límites *antes* de enviar una transacción al SPI. La institución debe rechazar **localmente** un Pix que viola los límites, antes de que llegue al SPI. ## 4. Comportamiento de los límites en el ciclo de vida de la transacción ### Durante el inicio de un Pix La institución emisora debe verificar: * Saldo disponible * Límite por transacción * Límite diario * Límite nocturno * Límite de Saque/Troco (si aplica) * Límites de fraude/velocidad * Límites configurados por el cliente Si una transacción viola alguna regla, la institución debe rechazarla con un código apropiado. ### Durante los reintentos La institución debe validar los límites otra vez. La idempotencia evita transferencias duplicadas, pero **no** omite las verificaciones de límites. ### Durante los flujos de comercios Los códigos QR dinámicos también deben respetar: * Límites del cliente * Reglas de horario * Topes de Saque/Troco Incluso si el comercio fija un monto, la institución del pagador decide si aprueba. ## 5. Comunicación recomendada al cliente BACEN exige que las instituciones: * Expliquen los límites con claridad * Ofrezcan autoservicio al cliente para ajustar límites * Muestren los aumentos pendientes y las fechas de activación * Notifiquen a los clientes en caso de comportamiento sospechoso ## 6. Tabla resumen | Tipo de límite | ¿Obligatorio? | Predeterminado (BACEN) | Controles del cliente | Reglas de activación | | ------------------ | ------------- | --------------------------- | ----------------------------- | ------------------------------------ | | Por transacción | Opcional | Definido por la institución | Aumentar/reducir | Reducir = inmediato / Aumentar = 24h | | Diario | Opcional | Definido por la institución | Aumentar/reducir | Reducir = inmediato / Aumentar = 24h | | Nocturno (20h–06h) | **Sí** | **Máx. R\$ 1.000** | Personalizable por el cliente | Aumentar = retraso de 24h | | Saque/Troco | **Sí** | Predeterminado de R\$ 500 | Configurable por el cliente | Aumentar = retraso de 24h | | Mensual | Opcional | Definido por la institución | Aumentar/reducir | Definido por la institución | **Referencia regulatoria** Esta página da un resumen práctico de cómo funciona Pix. Para detalles técnicos, legales y regulatorios más profundos, consulta siempre la [documentación oficial](https://www.bcb.gov.br/estabilidadefinanceira/pix-normas) que publica el **Banco Central de Brasil (BACEN)**. Cubre cambios de reglas, plazos y requisitos oficiales. Los materiales de BACEN son la fuente autorizada para las regulaciones de Pix y contienen las especificaciones más completas y actualizadas.