Skip to main content
Las transferencias P2P mueven fondos entre cuentas dentro de tu institución al instante, sin costo por defecto, las 24 horas del día. Puedes configurar tarifas por organización — consulta Configuración de tarifas a continuación. La transferencia nunca sale de tu sistema, por lo que se liquida de forma síncrona y no necesita la red BACEN.

​
Cuándo usar P2P

P2P es el tipo de transferencia adecuado cuando tanto el remitente como el destinatario tienen cuentas en tu institución. Los escenarios comunes incluyen:
  • Mover dinero entre las propias cuentas de un cliente — un cliente que transfiere desde su cuenta corriente a su cuenta de ahorros, o entre dos cuentas que administra.
  • Pagar a otro cliente de la misma institución — un cliente que envía dinero a un amigo, familiar o empresa que también opera contigo.
  • Movimientos internos de tesorería — división de saldos entre cuentas corporativas dentro de la misma organización.
  • División de pagos — distribución de montos entre múltiples cuentas para nómina, reparto de gastos o cashback.
El plugin detecta P2P automáticamente. Cuando el ISPB del destinatario coincide con el ISPB de tu institución, el plugin enruta la transferencia internamente. Tu integración de API es idéntica a TED OUT, por lo que no necesitas un endpoint ni lógica separados.

​
Ventajas clave

​
Cómo funciona

P2P reutiliza la misma API que TED OUT, por lo que tu integración se mantiene consistente entre los tipos de transferencia. El proceso es de dos pasos desde la perspectiva del cliente: Diagrama de flujo P2P
  1. Iniciar — El cliente envía los datos de la transferencia. El plugin valida al destinatario, verifica el saldo del remitente y confirma la tarifa (típicamente R$ 0,00). El cliente ve el resumen de la transferencia antes de confirmar.
  2. Confirmar — El cliente confirma. El plugin crea un débito + crédito atómico en Midaz. La transferencia se completa de inmediato.
El flujo de dos pasos te brinda un momento natural para mostrar al cliente una pantalla de confirmación con el resumen completo de la transferencia antes de que se muevan fondos.

​
Estados de transferencia

Diagrama de máquina de estados P2P
El estado PENDING no aplica a las transferencias P2P. TED OUT usa PENDING para marcar los fondos que reserva mientras espera la presentación al SPB. Las transferencias P2P se liquidan completamente dentro de Midaz, por lo que la transferencia pasa directamente de PROCESSING a COMPLETED.

​
Configuración de tarifas

El plugin deshabilita las tarifas por defecto. La mayoría de las instituciones ofrecen transferencias internas sin cargo. La configuración de tarifas está disponible si tu modelo de precios lo necesita. Para habilitar las tarifas P2P, consulta Configuración TED.

​
Validación del destinatario

El destinatario debe tener una cuenta en la misma institución. Cuando envías una transferencia, el plugin busca al destinatario en CRM. El plugin usa los datos bancarios que proporcionas: ISPB, sucursal, cuenta y documento del titular. Si el plugin no encuentra al destinatario, rechaza la transferencia y no mueve fondos. El cliente debe verificar los datos de la cuenta e intentarlo de nuevo.

​
Integración técnica

P2P usa los mismos endpoints que TED OUT. No necesitas trabajo de integración adicional más allá del flujo de transferencias salientes que ya construiste.
El campo type en la respuesta de la transferencia es P2P. Las transferencias P2P no tienen controlNumber, porque no pasan por JD SPB.

​
Manejo de errores

Las transferencias P2P son atómicas. El plugin crea el débito y el crédito como una única transacción de Midaz. Si alguna parte falla, Midaz no aplica ninguna de las dos partidas. Ningún estado intermedio mueve fondos parcialmente ni deja una cuenta con fondos faltantes. Si una transferencia falla, el cliente conserva el mismo saldo y puede reintentar. Consulta la lista completa de errores para conocer los códigos de error y la guía de recuperación.