Skip to main content
GET
Read an SLB payment

Autorizações

Authorization
string
header
obrigatório

JWT bearer token issued by the identity provider.

Parâmetros de caminho

nuOp
string
obrigatório

Correlation id returned by POST /v1/str/slb-payments or POST /v1/str/slb-bacen-payments (the outbound NUOp; 23 characters: ISPB[8]+DATE[8]+SEQ[7]).

Required string length: 23
Pattern: ^[0-9A-Z]{8}[0-9]{15}$

Resposta

OK

amount
string
obrigatório

Payment amount (VlrLanc), verbatim as text — never parsed or summed.

Exemplo:

"1500.00"

correlationId
string
obrigatório

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

Exemplo:

"req-7a3f9c2e"

id
string
obrigatório

Correlation id (the outbound NUOp).

Exemplo:

"46026562202609150000001"

movementDate
string
obrigatório

Business date (DtMovto) stamped on the frame.

Exemplo:

"2026-09-15"

numCtrlPart
string
obrigatório

This participant's own control number for the payment.

Exemplo:

"20260915000000000001"

status
enum<string>
obrigatório

PENDING until an answer arrives AND that answer reports a settlement. An answer carrying a pending-class situation (the entry was taken, not yet settled) leaves this PENDING with sitLancSLB recorded — it is never read as payment.

Opções disponíveis:
PENDING,
SETTLED,
REJECTED,
CANCELLED
Exemplo:

"PENDING"

wireCode
enum<string>
obrigatório

SLB0002 pays a charge BACEN raised; SLB0007 pays BACEN an amount SLB never demanded.

Opções disponíveis:
SLB0002,
SLB0007
Exemplo:

"SLB0002"

agreementCnpj
string

Agreement CNPJ (CNPJConv), verbatim.

Exemplo:

"00038166000105"

description
string

Free text (Hist). Present on SLB0007 only — SLB0002 declares none.

Exemplo:

"DEVOLUCAO DE CREDITO"

numCtrlSLB
string

Entry BACEN minted for the payment, from an SLB0007R1. Blank on the SLB0002 path, where the entry already existed.

Exemplo:

"SLB20260915000000020"

numCtrlSTR
string

STR entry the settlement rode, verbatim.

Exemplo:

"STR20260915000000009"

originalControlNumber
string

On SLB0002, the charge being paid (mandatory). On SLB0007, the SLB0005 credit being returned (optional).

Exemplo:

"SLB20260915000000001"

preferenceLevel
string

Processing preference (NivelPref), verbatim.

Exemplo:

"0001"

purpose
string

BACEN finalidade code (FinlddSLB). Present on SLB0007 only — SLB0002 declares none.

Exemplo:

"01"

rejectionReason
string

Operator-facing text of a refusal, verbatim.

Exemplo:

"saldo insuficiente"

settledAt
string<date-time>

RFC3339 UTC timestamp the payment became terminal. Empty while PENDING.

Exemplo:

"2026-09-15T18:00:01Z"

sitLancSLB
string

Situation code the answer carried, verbatim. It is BACEN's word on the entry, and it — not the fact that we sent the request — is what decides the status above.

Exemplo:

"1"