Procesar una Transferencia
Utilice este endpoint para confirmar y ejecutar una transferencia previamente iniciada. El sistema valida el initiationId, verifica el saldo del remitente, retiene fondos en Midaz y enruta la transferencia a JD SPB (para TED OUT) o crea una transacción interna en Midaz (para P2P). Enviar el mismo initiationId devuelve el mismo transferId.
Autorizaciones
Autenticación mediante token JWT Bearer. El tenantId se deriva del token bearer o del contexto autenticado de la solicitud y no se proporciona a través de X-Organization-Id.
Encabezados
Alcance de organización Midaz para la solicitud, utilizado para las llamadas posteriores a CRM, Fees y Midaz. Es obligatorio en las rutas de transferencia con alcance de organización en todos los modos de despliegue; un valor faltante o que no sea un UUID devuelve 400. Este no es el identificador del tenant — el tenantId se deriva del JWT bearer o del contexto autenticado, nunca de este header. Los workers en segundo plano (poller de TED IN, conciliación) no tienen header de solicitud y, en modo single-tenant, recurren a la variable de entorno ORGANIZATION_ID del despliegue.
Clave de idempotencia requerida para reintentos seguros. Utilice un UUID v4 o un identificador de negocio único. Si se envía la misma clave nuevamente y la solicitud original ya fue procesada, se devuelve la respuesta almacenada en caché.
Consulte Reintentos e idempotencia para más detalles.
255Cuerpo
- Option 1
- Option 2
El ID de iniciación devuelto por el endpoint Iniciar Transferencia. Expira después de 24 horas.
"019c96a0-aa10-7abc-d1e2-8c9d0e1f2a3b"
Identificador del artefacto de firma congelado devuelto por Prepare Transfer Signature.
"019c96a0-bb10-7def-a1b2-3c4d5e6f7a8b"
Hash SHA-256 del payload canónico que fue firmado.
"8f0c7f5c1c7b4d9f2f5c7d1a0d4c9a2b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f"
Firma codificada en Base64 para tenants que firman fuera del plugin.
"base64-signature-here"
Respuesta
Indica que la transferencia fue confirmada y el procesamiento ha comenzado.
Las llamadas repetidas con la misma clave X-Idempotency reproducen la respuesta en caché.
Consulte Reintentos e idempotencia para más detalles.
El ID único de la transferencia. Utilice este valor para rastrear el estado de la transferencia.
"019c96a0-ab10-7cde-f1a2-0e1f2a3b4c5d"
Un número de confirmación legible. Tiene el formato AAAAMMDD seguido de un sufijo hexadecimal corto derivado del ID de la transferencia (p. ej. 20260201aa10bc3d4e5f).
20"20260201001"
El estado actual de la transferencia. Para transferencias TED_OUT, el estado inmediatamente después del procesamiento es siempre PROCESSING.
CREATED, PENDING, PROCESSING, COMPLETED, REJECTED, FAILED, CANCELLED, RECEIVED "COMPLETED"
El monto de la tarifa calculada durante la iniciación.
1.5
El monto total retenido o transferido, incluyendo la tarifa.
1002
ID del paquete de comisiones aplicado a esta transferencia, si corresponde.
"019c96a0-ad10-7fab-c1d2-3b4c5d6e7f8a"

