Componer y enviar un mensaje STR curado
Superficie de composición de mensajes curada, restringida por catálogo, enrutada por maker-checker y por tipo. El capabilityId elegido debe estar en la lista de permitidos de composición (STR0004/STR0005/STR0006/STR0007/STR0008/STR0053), resolverse en el catálogo y ser PUBLICLY_SUBMITTABLE; de lo contrario la solicitud se rechaza con SPB-0003 (HTTP 400). El mensaje se construye a través del pipeline de composición compartido y hereda la compuerta de emisión de alçada: un monto por encima de su banda queda retenido en PENDING_APPROVAL (visible en GET /v1/str/emission-approvals, con emissionApprovalId establecido) y se despacha al alcanzar el quórum; por debajo de la banda queda SUBMITTED. Idempotente: reenviar la misma clave X-Idempotency devuelve la misma emisión. El monto declarado se reenvía de forma literal; no se suma ninguna posición.
Autorizaciones
JWT bearer token issued by the identity provider.
Encabezados
Bearer JWT token (the maker subject is derived from it for the alçada gate).
Idempotency key (canonical; legacy alias X-Idempotency-Key).
Idempotency key (legacy alias).
Idempotency key TTL in seconds.
Cuerpo
Transfer amount as a decimal string in BRL, minor-unit precision (two decimal places). Forwarded VERBATIM into the submit DTO and the alçada gate — Lerian SPB performs NO arithmetic on it.
^[0-9]+(\.[0-9]+)?$"150000.00"
STR capability code to compose. Must resolve in the catalog, be PUBLICLY_SUBMITTABLE, and be in the compose allowlist (STR0004/STR0005/STR0006/STR0007/STR0008/STR0053).
"STR0008"
BACEN STR purpose code (finalidade), exactly 5 digits. When 99999 (Outros) a description is mandatory (RSTR0034).
^[0-9]{5}$"00001"
Crediting (creditor) participant account receiving the transfer.
Debiting (debtor) participant account originating the transfer.
Optional free-text description; mandatory when purposeCode or finlddCli is 99999 (RSTR0034). Serialized into the STR Hist element.
"Wire transfer for invoice 2026-Q2-A47"
Optional client-level purpose code (5 digits) carried on STR0004/STR0008. When 99999 the description is required (RSTR0034).
^[0-9]{5}$"00001"
Opaque client-side metadata forwarded verbatim to the submit DTO (NOT sent to BACEN). Do not include sensitive fields.
Respuesta
Accepted
14-digit STR control number identifying the message on the SPB network.
"20260621000001"
Request-scoped correlation identifier echoing X-Request-ID, for pivoting from response to trace.
"req-7a3f9c2e"
Internal outbound-message id assigned at persistence time; the key for the approval queue when parked.
"6f2c8a1e-..."
23-digit STR operation number stamped on the composed message (protocol correlation).
"12345678202606210000001"
Emission status: SUBMITTED (dispatched / liquidatable) or PENDING_APPROVAL (parked awaiting maker-checker quorum).
"PENDING_APPROVAL"
Set ONLY when the emission parked: the maker-checker queue id (equal to messageId). Poll GET /v1/str/emission-approvals to track it. Empty when SUBMITTED immediately.
"6f2c8a1e-..."
N-of-M distinct-actor quorum the parked emission must collect (the alçada band requirement). Omitted/0 when SUBMITTED immediately.
2

