Criar operação de cancelamento de transferência bancária
Pré-requisito: a operação pai deve existir e admitir cancelamento; leia seu estado via getOperation (GET /v1/str/operations/); o segmento de rota vincula estruturalmente o cancelamento ao seu pai. O handler resolve a original por operationId, controla o ciclo de vida (SPB-3006 se o status proibir) e delega à rota de cancelamento STR0011.
Autorizações
JWT bearer token issued by the identity provider.
Cabeçalhos
Bearer JWT token.
Idempotency key (canonical).
Idempotency key (legacy alias).
Idempotency key TTL in seconds.
Parâmetros de caminho
Original bank-transfer operation UUID.
Corpo
ISPB of the participant requesting the cancellation, the 8-digit BACEN institution identifier.
"12345678"
Opaque client-side metadata forwarded verbatim to the legacy submit DTO; not persisted on the cancellation intent.
Optional free-text reason for the cancellation.
"Client requested cancellation"
Resposta
Created
UTC RFC 3339 timestamp at which the command was accepted.
"2026-05-06T18:30:00Z"
STR capability identifier resolved for the accepted operation (e.g. STR0004).
"STR0004"
Request correlation identifier for tracing the accept across logs and traces.
"req-7c8b3a2e-9f1d-4a55-9b8e-1e1234567890"
True when this response replays a prior idempotent accept rather than creating a new operation.
false
Operation family the accepted command belongs to (e.g. bankTransfer).
"bankTransfer"
Server-assigned operation aggregate UUID used for subsequent status, return, and cancellation calls.
"7c8b3a2e-9f1d-4a55-9b8e-1e1234567890"
Current control-plane lifecycle status of the operation; ACCEPTED on initial accept.
"ACCEPTED"
Optional SAFE protocol correlation fields; present once the operation is mapped to STR wire identifiers.

