> ## 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 en menos de 2 segundos, 24/7, sin pasar por BACEN — detección automática y sin integración extra.
Las transferencias P2P permiten a tus clientes mover fondos entre cuentas dentro de tu institución de forma instantánea, generalmente sin costo, las 24 horas del día. Las tarifas pueden configurarse por organización — consulta [Configuración de tarifas](#configuración-de-tarifas) a continuación. Como la transferencia nunca sale de tu sistema, se liquida en menos de 2 segundos y no requiere la participación de 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 enviando dinero a un amigo, familiar o empresa que también opera contigo.
* **Movimientos internos de tesorería** — distribució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, la transferencia se enruta internamente. Tu integración de API es idéntica a TED OUT — no se requiere un endpoint ni lógica separados.
## Ventajas clave
***
| Aspecto | P2P | TED OUT |
| ------------------------- | ------------------------------------------- | -------------------- |
| **Tiempo de liquidación** | Menos de 2 segundos | 5–10 minutos |
| **Horario de operación** | 24/7, incluyendo fines de semana y feriados | Lun–Vie, 06:30–17:00 |
| **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 permanece consistente entre 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 comprometerse.
2. **Confirmar** — El cliente confirma. El plugin crea un débito + crédito atómico en Midaz. La transferencia se completa de inmediato — típicamente en 2 segundos.
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. `PENDING` se usa en TED OUT para indicar fondos reservados mientras se espera la presentación al SPB. Las transferencias P2P se liquidan completamente dentro de Midaz, por lo que pasan directamente de `PROCESSING` a `COMPLETED` — típicamente en menos de 2 segundos.
## Configuración de tarifas
***
Las tarifas P2P están deshabilitadas por defecto. La mayoría de las instituciones ofrecen transferencias internas sin costo, pero la configuración está disponible si tu modelo de precios lo requiere. Para habilitar tarifas para P2P, consulta [Configuración TED](/es/rails/ted/jd/ted-configuration).
## Validación del destinatario
***
El destinatario debe ser una cuenta registrada dentro de la misma institución. Cuando envías una transferencia, el plugin busca al destinatario en CRM usando los datos bancarios que proporcionas (ISPB, sucursal, cuenta y documento del titular).
Si no se encuentra al destinatario, la transferencia se rechaza y no se mueven 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 se requiere trabajo de integración adicional más allá de lo que ya construiste para las transferencias salientes.
* [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 será `P2P`. Las transferencias P2P no tienen `controlNumber`, ya que no pasan por JD SPB.
## Manejo de errores
***
Las transferencias P2P son atómicas: el débito y el crédito se crean en una sola transacción de Midaz. Si alguna parte de la operación falla, toda la transacción se revierte. No existe un estado intermedio en el que los fondos estén parcialmente movidos o temporalmente ausentes de una cuenta.
Si una transferencia falla, el saldo del cliente no cambia y puede reintentar. Consulta la [lista completa de errores](/es/reference/midaz/plugins/ted/ted-error-list) para conocer los códigos de error específicos y la guía de recuperación.