Registrar un ack de depósito de liquidación del cliente
Registra el ack de depósito STR del cliente para un aviso de posición retransmitido y lleva la instrucción de liquidación a ACKED para un depósito SENT (desde PENDING o NOTIFIED) (el cliente es dueño de la conexión STR; el SLC no emite ningún LDL0022). Un resultado FAILED se registra pero deja la instrucción sin cambios para que el depósito pueda reejecutarse. Síncrono y definitivo. Idempotente mediante el encabezado Idempotency-Key (un reintento que lleva la misma clave reproduce la respuesta almacenada). result debe ser SENT o FAILED (400 codificado en caso contrario). RBAC: funding:write; el tenant siempre se deriva de la identidad validada de la solicitud, nunca del payload.
Autorizaciones
JWT bearer token issued by the identity provider.
Encabezados
Idempotency key for safe retries; a replay carrying the same key returns the stored response instead of appending a duplicate audit row (scoped to tenant + this instruction's ack route).
Parámetros de ruta
Settlement instruction id (UUID).
"018f8a3e-4b2c-7c1a-9e5d-2f6a1b3c4d5e"
Cuerpo
Client deposit result: SENT (deposited) or FAILED (could not). Case-insensitive — the value is upper-cased before validation, so "sent"/"failed" are accepted (intentionally lenient).
"SENT"
When the client reported the ack (RFC3339). Omitted stores NULL.
"2026-06-28T11:00:00Z"
Deposited amount in cents.
5011
Failure reason when result is FAILED.
"insufficient reserves"
Client reference to its LDL0022 (IF->STR); recorded for audit, outside the SLC.
"LDL0022-2026-06-28-000123"
Respuesta
OK
The settlement instruction id the ack was recorded against.
The accepted ack result (SENT/FAILED), upper-cased.
Whether this ack drove the instruction to ACKED. True only for a SENT ack that matched an instruction in PENDING or NOTIFIED; false for FAILED and for a SENT ack against an instruction not in PENDING/NOTIFIED (already acked/settled). The ack is recorded either way.
The resulting instruction state — present ONLY when this ack drove the transition (always ACKED). Omitted when transitioned is false; do not infer a state from the result.

