Pular para o conteúdo principal
GET
Consult a PIX Automatico authorization situation

Autorizações

Authorization
string
header
obrigatório

JWT bearer token issued by the identity provider.

Parâmetros de caminho

idRecorrencia
string
obrigatório

The recurrence id (29-char, RR...).

Exemplo:

"RR0435879820240605njua7shf40o"

Parâmetros de consulta

idReqJdPi
string

The JDPI request id (GUID) fallback when the idRecorrencia consult 404s.

Exemplo:

""

ispb
string

The ISPB of the direct participant this consult is made AS. It is ROUTING DATA you supply and guarantee - never a credential, never read from a header or a path, and it never widens what your token can reach. While exactly ONE participant of this deployment holds this recurrence, the recorded row names the direct participant whose books it lives in, and that is authoritative: naming that one changes nothing, naming another is refused. It DECIDES when TWO do - this deployment can be both PSPs of one recurrence inside its own economic group, and then it holds one row per side, in two participants' books, with no way to choose between them. OPTIONAL in every other case: omit it and the row, or the tenant default when there is no row, answers. Omitting it with a row on each side is 422 PIX-0127, an ISPB this deployment does not act as is 422 PIX-0128, and one that holds none of the recorded rows is 400 PIX-0061. Sending it empty (ispb=) reads the same as omitting it.

Pattern: ^[0-9A-Z]{8}$
Exemplo:

"12345678"

Resposta

OK

authorizationGiven
boolean
obrigatório

resultadoAutorizacao.

Exemplo:

true

frequency
integer<int64>
obrigatório

tpFrequencia (0..4).

Exemplo:

1

localStatus
string
obrigatório

Local AuthorizationStatus projected from the JDPI situation.

Exemplo:

"Active"

localStatusKnown
boolean
obrigatório

False when the JDPI situation carries no projected local status.

Exemplo:

true

payer
object
obrigatório

The recurrence pagador.

recipient
object
obrigatório

The recurrence recebedor.

recurrenceId
string
obrigatório

The recurrence id.

Exemplo:

"RR0435879820240605njua7shf40o"

retry
integer<int64>
obrigatório

retentativa (0=no retries, 1=up to 3 retries). Always present, including 0.

Exemplo:

1

stJdPi
integer<int64>
obrigatório

JDPI overall situation (-1/0/9/10).

Exemplo:

9

stJdPiProc
integer<int64>
obrigatório

JDPI intermediate situation (0..10).

Exemplo:

9

startDate
string
obrigatório

First payment date (aaaa-mm-dd).

Exemplo:

"2024-01-10"

amount
integer<int64>

Fixed payment amount in centavos.

Exemplo:

110001

authorizedAt
string

Authorization timestamp (UTC).

Exemplo:

"2024-01-06T10:00:00Z"

cancellations
object[] | null

Cancellation history (cancelamentos).

contractDesc
string

Free-text contract description.

Exemplo:

"Conta de energia"

contractNumber
string

Contract/order identifier (nrContrato).

Exemplo:

"1234567890ABC"

debtor
object

The recurrence devedor; absent when the debtor is the payer.

endDate
string

Last payment date (aaaa-mm-dd).

Exemplo:

"2026-01-10"

floorMaxAmount
integer<int64>

Receiver floor in centavos.

Exemplo:

55000

idReqJdPi
string

The JDPI request id (GUID).

Exemplo:

"52c43361-caa1-4ddb-9152-708426a25db3"

journey
integer<int64>

jornada (1..4).

Exemplo:

2

payerMaxAmount
integer<int64>

Payer max cap in centavos.

Exemplo:

200000

requestId
string

The solicitation id (29-char, IS...).

Exemplo:

"IS0435879820240605abcd1234567"

requestedAt
string

JDPI request timestamp (UTC).

Exemplo:

"2024-01-05T10:00:01Z"

situationAt
string

Situation timestamp (UTC).

Exemplo:

"2024-01-06T10:00:00Z"

updatedAt
string

Last-update timestamp (UTC).

Exemplo:

"2024-01-06T10:00:00Z"