> ## 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.
# Transferencias internas (P2P)
> Mueve fondos entre cuentas de tu institución al instante, 24/7, sin enrutamiento por BACEN. El plugin detecta las transferencias internas automáticamente.
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](#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
***
| Aspecto | P2P | TED OUT |
| ------------------------- | ------------------------------------------- | ---------------------------------- |
| **Tiempo de liquidación** | Tiempo real (síncrono) | Vía JD SPB |
| **Horario de operación** | 24/7, incluyendo fines de semana y feriados | Lun–Vie, 06:30–17:00 (por defecto) |
| **Tarifa (por defecto)** | Ninguna | Configurable |
| **Dependencia de BACEN** | Ninguna | Requerida (JD SPB) |
## 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:
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
***
| Estado | Qué significa |
| ------------ | ---------------------------------------------------------- |
| `CREATED` | Transferencia iniciada, esperando confirmación del cliente |
| `PROCESSING` | Transacción atómica de Midaz en curso |
| `COMPLETED` | Transferencia liquidada — los fondos se han movido |
| `FAILED` | Error interno; no se movieron fondos |
| `CANCELLED` | Cancelada por el cliente antes de la confirmación |
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](/es/rails/ted/jd/ted-configuration).
## 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.
* [Initiate Transfer](/es/reference/midaz/plugins/ted/initiate-transfer) — POST /v1/transfers/initiate
* [Process Transfer](/es/reference/midaz/plugins/ted/process-transfer) — POST /v1/transfers/process
* [Get Transfer](/es/reference/midaz/plugins/ted/retrieve-transfer) — GET /v1/transfers/{transferId}
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](/es/reference/midaz/plugins/ted/ted-error-list) para conocer los códigos de error y la guía de recuperación.