Return a TED credit received before Lerian SPB
Gives back, by STR0010, a TED credit this institution received before Lerian SPB, which holds no operation of it; otherwise as createBankTransferReturnOperation, whose outcome, alçada and idempotency this route shares. A credit Lerian SPB did receive answers SPB-3006, and so does a numCtrlSTROr dated after the cut-over day, the date in the earliest NumCtrlSTR of a TED credit Lerian SPB received, because Lerian SPB may still hold such a credit in its inbound quarantine. The body declares what that route reads from the received credit: its NumCtrlSTR (numCtrlSTROr), its full amount and the ISPB that sent it (originalSenderIspb, which the return credits). BACEN’s error list has the STR refuse an unknown original (ESTR0010) and an amount above the original’s (ESTR0025), which closes the operation FAILED; the catalog binds no refusal of a second return or a smaller amount to STR0010. The 409 for a numCtrlSTROr that already has a standing return covers only returns Lerian SPB sent.
Autorizaciones
JWT bearer token issued by the identity provider.
Encabezados
Idempotency key. Required on every mutation.
Seconds the cached response is kept; it may only shorten IDEMPOTENCY_DEFAULT_TTL_SEC. The key itself lives with the operation.
Cuerpo
The credit's full amount, as a decimal string with exactly two places (VlrLanc of the STR0010). The STR refuses an amount above the original's (ESTR0025); no refusal of a smaller one is documented for STR0010.
^(0|[1-9][0-9]*)\.[0-9]{2}$"150.00"
NumCtrlSTR of the TED credit being returned, as its STR0004R2..STR0008R2 carried it (NumCtrlSTROr of the STR0010; official type Controle, XXXAAAAMMDDnnnnnnnnn, whose date must parse).
20"STR20261020000000123"
ISPB of the institution that sent the credit (its ISPBIFDebtd), which the return credits.
^[0-9A-Z]{8}$"12345678"
BACEN return reason (CodDevTransf) of the STR0010: one of the codes the BACEN dicionário de domínios keeps active, without a leading zero (type CodDevTransf, Catálogo v5.13 Vol IV). The retired 10-14, 78, 79 and 81 are refused.
1, 2, 3, 4, 5, 6, 7, 8, 9, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 31, 40, 51, 52, 53, 61, 63, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 80, 82, 83, 84, 85, 86 "1"
Optional free-text description of the return (Hist).
"Wrong account"
Opaque client-side metadata forwarded verbatim to the legacy submit DTO; not persisted on the return intent.
Respuesta
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 "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, SUBMITTED, SENT, CONFIRMED, REJECTED, FAILED, PENDING_CONFIGURATION, PENDING_RECONCILIATION, RETURN_REQUESTED, RETURNED, CANCEL_REQUESTED, CANCELLED, RECEIVED, DELIVERED "ACCEPTED"
Optional SAFE protocol correlation fields; present once the operation is mapped to STR wire identifiers.