Registrar o ack de depósito de liquidação de um cliente
Registra o ack de depósito no STR do cliente para um aviso de posição repassado e leva a instrução de liquidação a ACKED para um depósito SENT (a partir de PENDING ou NOTIFIED) (o cliente é dono da conexão com o STR; o SLC NÃO emite LDL0022). Um resultado FAILED é registrado, mas deixa a instrução inalterada para que o depósito possa ser reacionado. Síncrono e definitivo. Idempotente por meio do header Idempotency-Key (uma nova tentativa carregando a mesma chave reproduz a resposta armazenada). result deve ser SENT ou FAILED (400 codificado caso contrário). RBAC: funding:write; o tenant é sempre derivado da identidade validada da requisição, nunca do payload.
Autorizações
JWT bearer token issued by the identity provider.
Cabeçalhos
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 caminho
Settlement instruction id (UUID).
"018f8a3e-4b2c-7c1a-9e5d-2f6a1b3c4d5e"
Corpo
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"
Resposta
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.

