Create bank transfer cancellation operation
Prerequisite: the parent operation must exist and admit cancellation — read its state via getOperation (GET /v1/str/operations/); the path segment structurally ties the cancellation to its parent. The handler resolves the original by operationId, gates lifecycle (SPB-3006 if status forbids), and delegates to the STR0011 cancellation path.
Authorizations
JWT bearer token issued by the identity provider.
Headers
Bearer JWT token.
Idempotency key (canonical).
Idempotency key (legacy alias).
Idempotency key TTL in seconds.
Path Parameters
Original bank-transfer operation UUID.
Body
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"
Response
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.

