Obtener una programación Pix
Recupera una programación por su identificador único. Las consultas entre cuentas devuelven 404: la existencia nunca se filtra entre cuentas.
Autorizaciones
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Encabezados
Identificador único de la cuenta del Ledger de Midaz (formato UUID).
Parámetros de ruta
ID de la programación (UUID v7)
Respuesta
OK
AccountID refleja el AccountID de entrada para correlación de auditoría / logs.
"019cf6ef-e418-7ced-80c0-7b9816faa798"
Amount es el monto en BRL con 2 decimales.
"100.50"
AttemptCount es la cantidad de intentos de disparo realizados hasta ahora.
0
Attempts es la lista cronológica de intentos de disparo previos fallidos. El intento exitoso no se incluye aquí; queda registrado en la propia programación mediante su TransferID y EndToEndID. Arreglo vacío cuando no se registró ningún fallo.
CancelledAt es el momento en que la programación llegó a CANCELLED. Ausente para filas que no están en CANCELLED.
"2026-05-19T09:15:33Z"
CreatedAt es la marca de tiempo de persistencia (ISO 8601 UTC).
"2026-05-26T12:30:00Z"
Description es el mensaje de transferencia opcional legible para humanos.
"Recurring charge installment 03/12"
Destination es la instantánea del destino capturada en la programación.
EndToEndID es el identificador end-to-end de BACEN de la transferencia liquidada (resuelto mediante TransferID). Ausente para estados que no son EXECUTED.
"E1234567820260815060012345678901"
ExecutedAt es el momento en que la programación llegó a EXECUTED. Ausente para filas que no están en EXECUTED.
"2026-08-15T06:00:04Z"
FailedAt es el momento en que la programación llegó al estado terminal FAILED. Ausente para filas que no están en FAILED. Simétrico con ExecutedAt / CancelledAt.
"2026-08-15T06:00:04Z"
FailureMessage es la descripción de fallo legible para humanos, en texto libre (saneada de PII). Ausente para filas que no están en FAILED.
FailureReason categoriza un fallo terminal. Instantánea del FailureReason de la última entrada de Attempts[]. Ausente para filas que no están en FAILED.
INSUFFICIENT_FUNDS, BTG_REJECTED, MIDAZ_REJECTED, VALIDATION_FAILED, SCHEDULE_STALE_TIMEOUT, SCHEDULE_RETRIES_EXHAUSTED "INSUFFICIENT_FUNDS"
FiredAt es el instante de despacho más reciente. Ausente hasta que la programación empieza a procesarse (PROCESSING / EXECUTED / FAILED).
"2026-08-15T06:00:04Z"
ID es el identificador único de la programación (UUID v7, generado por la aplicación).
"01989f9e-6508-79f8-9540-835be49fbd0d"
InitiationID es la iniciación de pago referenciada al momento de creación (ancla de auditoría). Nunca se reutiliza al momento del disparo; cada intento de disparo usa su propia iniciación, expuesta por intento como Attempts[].InitiationID.
"550e8400-e29b-41d4-a716-446655440010"
InitiationType registra cómo se capturó el destino (MANUAL, KEY, QR_CODE).
MANUAL, KEY, QR_CODE "MANUAL"
MaxAttempts es el tope de reintentos por fila aceptado al momento de creación.
2
RecurrenceID refleja el ancla de la recurrencia padre cuando la programación se creó a partir de un flujo recurrente. Vacío para llamadas directas a POST /v1/schedules.
"01988a7c-1234-7abc-8def-111122223333"
ScheduledFor es el momento de disparo en horario de reloj (ISO 8601 UTC).
"2026-08-15T09:00:00Z"
Status es el estado del ciclo de vida de la programación. Siempre SCHEDULED al crear. Ciclo de vida: SCHEDULED -> PROCESSING -> EXECUTED | FAILED | CANCELLED.
SCHEDULED, PROCESSING, EXECUTED, FAILED, CANCELLED "SCHEDULED"
TransferID es el identificador de la transferencia liquidada. Se completa solo en EXECUTED.
"c8d27e3f-4a5b-6c7d-8e9f-0a1b2c3d4e5f"
UpdatedAt es la marca de tiempo de la última transición de estado (ISO 8601 UTC).
"2026-05-26T12:30:00Z"

