Skip to main content
GET
Obter uma autorização do Pix Automático

Autorizações

Authorization
string
header
obrigatório

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Cabeçalhos

X-Account-Id
string
obrigatório

Identificador único da Conta do Ledger Midaz (formato UUID).

Parâmetros de caminho

id
string
obrigatório

ID da autorização (formato UUID)

Resposta

OK

accountId
string
Exemplo:

"019cf6ef-e418-7ced-80c0-7b9816faa798"

amount
object
approvedAt
string<date-time>
authorizationRequestId
string
Exemplo:

"019cf6ef-e418-7ced-80c0-7b9816faa798"

cancelReason
enum<string>
Opções disponíveis:
PAYER,
FRAUD,
EXPIRED,
RECEIVER
cancellationReason
string

CancellationReason é a justificativa em texto livre registrada no momento do cancelamento (obrigatória para FRAUD). Nil quando ausente.

Exemplo:

"Customer reported unauthorized charge"

cancellationReasonKind
enum<string>

CancellationReasonKind é o motivo estruturado do cancelamento (PAYER, FRAUD, EXPIRED, RECEIVER). Nil quando a autorização não foi cancelada.

Opções disponíveis:
PAYER,
FRAUD,
EXPIRED,
RECEIVER
Exemplo:

"FRAUD"

cancelledAt
string<date-time>
cancelledByOperatorId
string

CancelledByOperatorID é o operador (subject) que realizou um cancelamento FRAUD. Nil para cancelamentos iniciados pelo pagador/sistema.

Exemplo:

"op-9"

createdAt
string<date-time>
destination
object
expiredAt
string<date-time>
externalAuthorizationId
string
Exemplo:

"AUT-2026-04-001"

id
string
Exemplo:

"019cf6ef-e418-7ced-80c0-7b9816faa798"

nextChargeAmount
string
Exemplo:

"29.90"

nextChargeAt
string<date-time>
periodicity
object
receiverMaxAmount
string
Exemplo:

"500.00"

retryPolicy
string
Exemplo:

"RETRY_3X_7D"

status
enum<string>
Opções disponíveis:
AUTHORIZED,
CANCELLED,
EXPIRED
Exemplo:

"AUTHORIZED"

updatedAt
string<date-time>