Skip to main content
Las transferencias P2P mueven fondos entre cuentas dentro de tu institución al instante, sin costo de forma predeterminada, las 24 horas del día. Puedes configurar comisiones por organización. Consulta Configuración de comisiones más abajo. La transferencia nunca sale de tu sistema, así que liquida de forma síncrona y no necesita la red de BACEN.

​
Cuándo usar P2P

P2P es el tipo de transferencia correcto cuando tanto el remitente como el destinatario tienen cuentas en tu institución. Los escenarios comunes incluyen:
  • Mover dinero entre las cuentas de un mismo cliente: un cliente que transfiere de su cuenta corriente a su cuenta de ahorro, o entre dos cuentas que administra.
  • Pagar a otro cliente de la misma institución: un cliente que envía dinero a un amigo, un familiar o un negocio que también opera contigo.
  • Movimientos internos de tesorería: repartir saldos entre cuentas corporativas de la misma organización.
  • División de pagos: distribuir montos entre varias cuentas para nómina, gastos compartidos o cashback.
El plugin detecta P2P de forma automática. 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 la de TED OUT, así que no necesitas un endpoint ni una lógica aparte.

​
Ventajas principales

​
Cómo funciona

P2P reusa la misma API que TED OUT, así tu integración se mantiene consistente entre los tipos de transferencia. El proceso tiene dos pasos desde la perspectiva del cliente: Diagrama de flujo de P2P
  1. Iniciar: el cliente envía los datos de la transferencia. El plugin valida al destinatario, revisa el saldo del remitente y confirma la comisión (por lo general R$ 0.00). El cliente ve el resumen de la transferencia antes de comprometerse.
  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 da un momento natural para mostrarle al cliente una pantalla de confirmación con el resumen completo de la transferencia antes de que se mueva ningún fondo.

​
Estados de la transferencia

Diagrama de la máquina de estados de P2P
El estado PENDING no aplica a las transferencias P2P. TED OUT usa PENDING para marcar los fondos que reserva mientras espera el envío al SPB. P2P liquida por completo dentro de Midaz, así que la transferencia pasa directo de PROCESSING a COMPLETED.

​
Configuración de comisiones

El plugin desactiva las comisiones de forma predeterminada. La mayoría de las instituciones ofrecen las transferencias internas sin cargo. La configuración de comisiones está disponible si tu modelo de precios la necesita. Para habilitar las comisiones de P2P, consulta Configuración de 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 el CRM. Coteja los datos bancarios que entregas: ISPB, sucursal, cuenta y documento del titular. Si el plugin no encuentra al destinatario, rechaza la transferencia y no mueve fondos. El cliente debe revisar los datos de la cuenta e intentar de nuevo.

​
Integración técnica

P2P usa los mismos endpoints que TED OUT. No necesitas trabajo de integración extra más allá del flujo de transferencia saliente 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 sola transacción de Midaz. Si alguna parte falla, Midaz no aplica ninguna de las dos patas. Ningún estado intermedio mueve fondos de forma parcial ni deja una cuenta con saldo insuficiente. Si una transferencia falla, el cliente mantiene el mismo saldo y puede reintentar. Consulta la lista completa de errores para los códigos de error y la guía de recuperación.