Listar transacciones
Recupera transacciones Pix con filtrado opcional. Puedes filtrar por múltiples criterios, incluyendo cuenta, estado, tipo y marcas de tiempo.
Autorizaciones
Autenticación con token JWT Bearer. Obtén el token desde el endpoint /v1/login/oauth/access_token
usando credenciales de cliente (clientId y clientSecret).
Incluye el token en el encabezado Authorization:
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
El token expira después de 3600 segundos (1 hora).
Parámetros de consulta
Filtra las transacciones por un UUID de cuenta específico.
Filtra por el identificador único de punta a punta de la transacción (E2E ID).
Filtra por tipo de transacción. Usa el valor numérico: 1=PIX.
Identificador del tipo de transacción. Código numérico que especifica el tipo de transacción de pago.
Valores válidos:
1= PIX (Pago instantáneo a través del sistema Pix brasileño)
1 1
Filtra por estado de la transacción. Valores posibles: PENDING, PENDING_CONFIRM, EXECUTED, REVERSAL, REPROVED, SCHEDULE, CANCELLED, ERROR.
Estado del procesamiento de la transacción. Valores en texto que indican el estado actual de una transacción Pix.
Valores válidos:
PENDING= La transacción fue iniciada y está a la espera de procesamiento por el sistema de pagosPENDING_CONFIRM= La transacción está esperando la confirmación finalEXECUTED= La transacción se completó con éxito y los fondos fueron transferidosREVERSAL= La transacción fue revertida (reembolsada)REPROVED= La transacción fue rechazada o no pasó la validaciónSCHEDULE= La transacción está programada para una ejecución futuraCANCELLED= La transacción fue cancelada por el usuario antes de ejecutarseERROR= Ocurrió un error de procesamiento durante la ejecución de la transacción
PENDING, PENDING_CONFIRM, EXECUTED, REVERSAL, REPROVED, SCHEDULE, CANCELLED, ERROR "EXECUTED"
Filtra transacciones de reembolso.
Filtra transacciones internas.
Filtra por fecha de creación.
Filtra por fecha de actualización.
Respuesta
Lista de transacciones recuperada correctamente
Identificador único de la transacción.
"txn_123456789"
Identificador de la cuenta asociada con la transacción.
"acc_123"
Identificador end-to-end de la transacción.
"E1234567820230615123456789012345"
Estado del procesamiento de la transacción. Valores en texto que indican el estado actual de una transacción Pix.
Valores válidos:
PENDING= La transacción fue iniciada y está a la espera de procesamiento por el sistema de pagosPENDING_CONFIRM= La transacción está esperando la confirmación finalEXECUTED= La transacción se completó con éxito y los fondos fueron transferidosREVERSAL= La transacción fue revertida (reembolsada)REPROVED= La transacción fue rechazada o no pasó la validaciónSCHEDULE= La transacción está programada para una ejecución futuraCANCELLED= La transacción fue cancelada por el usuario antes de ejecutarseERROR= Ocurrió un error de procesamiento durante la ejecución de la transacción
PENDING, PENDING_CONFIRM, EXECUTED, REVERSAL, REPROVED, SCHEDULE, CANCELLED, ERROR "EXECUTED"
Monto de la transacción.
100.5
Descripción de la transacción.
"Pago"
Dirección del flujo de la transacción. Código numérico que indica si el dinero ingresa, sale o se transfiere internamente.
Valores válidos:
1= CASH_IN (Recepción de pago: dinero que entra a la cuenta)2= CASH_OUT (Envío de pago: dinero que sale de la cuenta)3= INTRA_PSP (Transferencia interna dentro del mismo proveedor de servicios de pago)
1, 2, 3 1
Identificador del tipo de transacción. Código numérico que especifica el tipo de transacción de pago.
Valores válidos:
1= PIX (Pago instantáneo a través del sistema Pix brasileño)
1 1
Marca de tiempo de creación de la transacción.
"2023-06-15T10:30:00Z"
Marca de tiempo de la última actualización de la transacción.
"2023-06-15T10:30:05Z"

