Skip to main content
GET
Obtener una autorización de Pix Automático

Autorizaciones

Authorization
string
header
requerido

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

Encabezados

X-Account-Id
string
requerido

Identificador único de la cuenta del Ledger de Midaz (formato UUID).

Parámetros de ruta

id
string
requerido

ID de la autorización (formato UUID)

Respuesta

OK

accountId
string
Ejemplo:

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

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

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

cancelReason
enum<string>
Opciones disponibles:
PAYER,
FRAUD,
EXPIRED,
RECEIVER
cancellationReason
string

CancellationReason es la justificación en texto libre registrada al momento de cancelar (obligatoria para FRAUD). Nil cuando no está presente.

Ejemplo:

"Customer reported unauthorized charge"

cancellationReasonKind
enum<string>

CancellationReasonKind es el motivo de cancelación estructurado (PAYER, FRAUD, EXPIRED, RECEIVER). Nil cuando la autorización no fue cancelada.

Opciones disponibles:
PAYER,
FRAUD,
EXPIRED,
RECEIVER
Ejemplo:

"FRAUD"

cancelledAt
string<date-time>
cancelledByOperatorId
string

CancelledByOperatorID es el operador que realizó una cancelación por FRAUD. Nil para cancelaciones iniciadas por el pagador o por el sistema.

Ejemplo:

"op-9"

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

"AUT-2026-04-001"

id
string
Ejemplo:

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

nextChargeAmount
string
Ejemplo:

"29.90"

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

"500.00"

retryPolicy
string
Ejemplo:

"RETRY_3X_7D"

status
enum<string>
Opciones disponibles:
AUTHORIZED,
CANCELLED,
EXPIRED
Ejemplo:

"AUTHORIZED"

updatedAt
string<date-time>