Saltar al contenido principal
POST
Procesar una Transferencia

Autorizaciones

Authorization
string
header
requerido

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

X-Organization-Id
string<uuid>
requerido

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.

X-Idempotency
string
requerido

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.

Maximum string length: 255

Cuerpo

application/json
initiationId
string<uuid>
requerido

El ID de iniciación devuelto por el endpoint Iniciar Transferencia. Expira después de 24 horas.

Ejemplo:

"019c96a0-aa10-7abc-d1e2-8c9d0e1f2a3b"

signingArtifactId
string<uuid>

Identificador del artefacto de firma congelado devuelto por Prepare Transfer Signature.

Ejemplo:

"019c96a0-bb10-7def-a1b2-3c4d5e6f7a8b"

payloadHash
string

Hash SHA-256 del payload canónico que fue firmado.

Ejemplo:

"8f0c7f5c1c7b4d9f2f5c7d1a0d4c9a2b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f"

signature
string

Firma codificada en Base64 para tenants que firman fuera del plugin.

Ejemplo:

"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.

transferId
string<uuid>
requerido

El ID único de la transferencia. Utilice este valor para rastrear el estado de la transferencia.

Ejemplo:

"019c96a0-ab10-7cde-f1a2-0e1f2a3b4c5d"

confirmationNumber
string
requerido

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).

Maximum string length: 20
Ejemplo:

"20260201001"

status
enum<string>
requerido

El estado actual de la transferencia. Para transferencias TED_OUT, el estado inmediatamente después del procesamiento es siempre PROCESSING.

Opciones disponibles:
CREATED,
PENDING,
PROCESSING,
COMPLETED,
REJECTED,
FAILED,
CANCELLED,
RECEIVED
Ejemplo:

"COMPLETED"

feeAmount
number<decimal>
requerido

El monto de la tarifa calculada durante la iniciación.

Ejemplo:

1.5

totalAmount
number<decimal>
requerido

El monto total retenido o transferido, incluyendo la tarifa.

Ejemplo:

1002

packageAppliedId
string<uuid> | null

ID del paquete de comisiones aplicado a esta transferencia, si corresponde.

Ejemplo:

"019c96a0-ad10-7fab-c1d2-3b4c5d6e7f8a"