Listar los movimientos de saldo
El libro mayor detrás de GET /balance: cargos por guías, reembolsos por cancelación, recargas y ajustes manuales, del más reciente al más antiguo. Es la respuesta a "¿en qué se fue el saldo?".
Mismo principal que GET /balance, por construcción. Sin header: el saldo PERSONAL del usuario de la llave. Con X-PDV-ID validado (llaves admin, misma allowlist): el libro mayor de ese fondo de punto de venta. Las consultas cruzadas por user_id del endpoint interno NO existen aquí: una llave lee exactamente el fondo que cargarían sus envíos.
amount viene con SIGNO en MXN (negativo = salió dinero) y balance_after es el saldo tras ese movimiento. type usa un vocabulario público de cuatro palabras (charge, refund, topup, adjustment) que resume el enum interno; los detalles internos (qué reventa, qué pierna de una corrección, qué programa) no se exponen.
En modo de prueba el listado se DERIVA de los envíos sandbox — un cargo al crear, un reembolso al cancelar — de modo que la suma cuadra exactamente con el saldo computado del sandbox. Requiere scope balance:read.
Request
- Base URL: https://api.enviadores.com.mx/api/v1
- URL: https://api.enviadores.com.mx/api/v1/transactions
- Auth: HTTP bearer
Query parameters
Filtra por tipo público de movimiento — exactamente el mismo valor que devuelve el campo type de cada fila. charge = cargo (salió saldo), refund = devolución, topup = recarga en línea, adjustment = cualquier otro abono (alta manual, promoción, liquidación). Un valor fuera del enum es 422 VALIDATION_ERROR, nunca una lista vacía silenciosa.
Día calendario INCLUSIVO (zona horaria de negocio America/Mexico_City) desde el cual listar movimientos. Solo YYYY-MM-DD.
Día calendario INCLUSIVO (America/Mexico_City) hasta el cual listar — el día completo. from posterior a to es 422.
Headers
Solo llaves de cuentas admin: el punto de venta cuyo fondo se carga/consulta. Requiere que la llave tenga una allowlist de PDVs configurada por un administrador (pdv_allowlist); sin allowlist, todo PDV real es denegado por defecto. Validado además contra los PDV activos. Cualquier violación → 403 PDV_NOT_ALLOWED. El valor personal_account equivale a omitir el header.
Response
Página de movimientos.
Changes
No recorded changes to this operation across all 1 revision of this API.