Saltar al contenido principal
PUT
Respond to a PIX Automatico authorization

Autorizaciones

Authorization
string
header
requerido

JWT bearer token issued by the identity provider.

Parámetros de ruta

idRecorrencia
string
requerido

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

Ejemplo:

"RR0435879820240605njua7shf40o"

Parámetros de consulta

ispb
string

The ISPB of the direct participant this request acts for. OPTIONAL: omit it and the request is answered exactly as before. Named, the recurrence row this write addresses has to be booked in that participant's books, or the answer is 404 PIX-0147 and nothing is sent to JDPI or changed. An ISPB this deployment does not act as is 422 PIX-0128. It is ROUTING DATA you supply, never a credential, and a token confined to one participant has to name it here. Sending it empty (ispb=) reads the same as omitting it.

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

"12345678"

Cuerpo

application/json
accountType
integer<int64>
requerido

tpContaPagador (0..3).

Ejemplo:

0

payerName
string
requerido

Payer name (nomePagador). Blank is 400 PIX-0061.

Ejemplo:

"Fulano de Tal"

result
boolean
requerido

resultadoAutorizacao (true=accept, false=reject).

Ejemplo:

true

authorizedAt
string

Authorization timestamp (dtHrAutorizacaoRecorrencia, an RFC 3339 date-time). Required when result=true, so a retry resends the same value for JD to replay the response; omitted, blank or not a date-time on an acceptance is 400 PIX-0061. Not sent on a rejection.

Ejemplo:

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

ibgeCode
integer<int64>

Municipality IBGE code (codMunIbge; required when accepting).

Ejemplo:

3550308

payerMaxAmount
integer<int64>

Payer max cap in centavos (vlrMaxPagador).

Ejemplo:

200000

rejectionReason
string

Rejection reason (AP13/AP14/AP15). Required when result=false; omitted or blank there is 400 PIX-0061.

Ejemplo:

"AP13"

Respuesta

Accepted

recurrenceId
string
requerido

The recurrence id.

Ejemplo:

"RR0435879820240605njua7shf40o"

requestedAt
string
requerido

JDPI request timestamp (dtHrReqJdPi, UTC).

Ejemplo:

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

idReqJdPi
string

The JDPI request id (36-char GUID; omitted by 4.3.10).

Ejemplo:

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

status
string

The resulting local authorization status.

Ejemplo:

"Accepted"