Pay BACEN an amount SLB never demanded

Submits an SLB0007 paying BACEN an amount no SLB0001 charged, including the return of a credit BACEN made with an SLB0005 — name that credit’s control number to make the payment a return (RSLB0008). Unlike the charge authorisation this command is bounded by nothing but its own fields, which is why it carries its own scope. When the deployment configures an alçada band covering the amount, the message parks in PENDING_APPROVAL until the required signatures are collected. Idempotent — the X-Idempotency key lives with the payment: the same key and parsed request (member order and whitespace do not count; any other difference, such as number spelling, null for an absent field, or an unknown member, is another request) answer the stored payment with X-Idempotency-Replayed: true, also after X-TTL has dropped the cached response, and the same key with another request answers 422.

POST /v1/str/slb-bacen-payments

Pay BACEN an amount SLB never demanded

cURL

curl --request POST \
  --url https://api.example.com/v1/str/slb-bacen-payments \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Idempotency: <x-idempotency>' \
  --data '
{
  "amount": "2500.75",
  "description": "DEVOLUCAO DE CREDITO",
  "purpose": "01",
  "agreementCnpj": "00038166000105",
  "controlNumberSLBOriginal": "SLB20260915000000009",
  "preferenceLevel": "0001"
}
'

202

{
  "correlationId": "req-7a3f9c2e",
  "id": "46026562202609150000001",
  "messageType": "SLB0002",
  "movementDate": "2026-09-15",
  "numCtrlPart": "20260915000000000001",
  "status": "SUBMITTED",
  "submittedAt": "2026-09-15T12:00:00Z"
}

Autorizações

Authorization · string · header · obrigatório

JWT bearer token issued by the identity provider.

Cabeçalhos

X-Idempotency · string · obrigatório

Idempotency key. Required on every mutation.

X-TTL · string

Seconds the cached response is kept; it may only shorten IDEMPOTENCY_DEFAULT_TTL_SEC. The key itself lives with the payment.

Corpo

application/json

amount · string · obrigatório

Payment amount in decimal reais (VlrLanc).

Pattern: ^[1-9][0-9]{0,15}\.[0-9]{2}$|^0\.(0[1-9]|[1-9][0-9])$

Exemplo:

"2500.75"

description · string · obrigatório

Free text (Hist). Mandatory on this message — SLB0002 declares no Hist at all, and that asymmetry is BACEN's.

Required string length: 1 - 200

Exemplo:

"DEVOLUCAO DE CREDITO"

purpose · string · obrigatório

BACEN finalidade code (FinlddSLB) of the payment. Mandatory on this message.

Required string length: 1 - 4

Exemplo:

"01"

agreementCnpj · string

Optional agreement CNPJ (CNPJConv).

Maximum string length: 14

Exemplo:

"00038166000105"

controlNumberSLBOriginal · string

Control number of the SLB0005 credit being returned (RSLB0008). Omit it for a spontaneous payment.

Maximum string length: 20

Exemplo:

"SLB20260915000000009"

preferenceLevel · string

Optional processing preference (NivelPref).

Maximum string length: 4

Exemplo:

"0001"

Resposta

202

application/json

Accepted

correlationId · string · obrigatório

Request-scoped correlation identifier echoing X-Request-ID.

Exemplo:

"req-7a3f9c2e"

id · string · obrigatório

Correlation id (the outbound NUOp). The answer leg is correlated to it.

Exemplo:

"46026562202609150000001"

messageType · string · obrigatório

The SLB wire code that was submitted.

Exemplo:

"SLB0002"

movementDate · string · obrigatório

BACEN business date (DtMovto) stamped on the frame, derived server-side.

Exemplo:

"2026-09-15"

numCtrlPart · string · obrigatório

This participant's own control number for the message — the handle BACEN quotes back on the answer.

Exemplo:

"20260915000000000001"

status · string · obrigatório

SUBMITTED when the message was queued for the rail, PENDING_APPROVAL when the configured alçada band parked it awaiting signatures.

Exemplo:

"SUBMITTED"

submittedAt · string · obrigatório

RFC3339 UTC timestamp the message was submitted.

Exemplo:

"2026-09-15T12:00:00Z"