Skip to main content
POST
Request a PIX Automatico authorization

Autorizaciones

Authorization
string
header
requerido

JWT bearer token issued by the identity provider.

Cuerpo

application/json
contractNumber
string
requerido

Contract/order identifier (nrContrato).

Ejemplo:

"1234567890ABC"

frequency
integer<int64>
requerido

tpFrequencia (0=Weekly,1=Monthly,2=Quarterly,3=Semiannual,4=Annual).

Ejemplo:

1

idRecorrencia
string
requerido

Unique recurrence id (29-char, format RR...).

Ejemplo:

"RR0435879820240605njua7shf40o"

payer
object
requerido

The recurrence pagador (account being authorized).

recipient
object
requerido

The recurrence recebedor (authorized charging entity).

startDate
string
requerido

First payment date (dtInicialRecorrencia; aaaa-mm-dd).

Ejemplo:

"2024-01-10"

amount
integer<int64>

Fixed payment amount in centavos (valor; omit/0 for a variable recurrence).

Ejemplo:

110001

contractDesc
string

Free-text contract description (descContrato).

Ejemplo:

"Conta de energia"

createdDateTime
string

Recurrence creation timestamp (dtHrCriacaoRecorrencia, UTC).

Ejemplo:

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

debtor
object

The devedor, sent only when it differs from the payer.

endDate
string

Last payment date (dtFinalRecorrencia; aaaa-mm-dd).

Ejemplo:

"2026-01-10"

expirationDateTime
string

Solicitation expiration timestamp (dtHrExpiracaoSolicitacao, UTC).

Ejemplo:

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

floorMaxAmount
integer<int64>

Receiver floor in centavos (pisoValorMaximo).

Ejemplo:

55000

solicitationDateTime
string

Solicitation creation timestamp (dtHrCriacaoSolicitacao, UTC).

Ejemplo:

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

Respuesta

Accepted

idRecorrencia
string
requerido

The recurrence id (echoed).

Ejemplo:

"RR0435879820240605njua7shf40o"

idReqJdPi
string
requerido

The JDPI request id (36-char GUID).

Ejemplo:

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

requestedAt
string
requerido

JDPI request timestamp (dtHrReqJdPi, UTC).

Ejemplo:

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

status
string
requerido

The resulting local authorization status.

Ejemplo:

"Requested"