/api/v6/account/paymentsHistorial de pagos
Recargas de saldo prepago y pagos de factura postpago, en una sola fuente.
Alcance y límites
API key con la capacidad account concedida
30 solicitudes por minuto
- Paginación con
limit(por defecto 20, máximo 100) yoffset(por defecto 0). La respuesta traedata.itemsydata.pagination.
Historial de pagos: recargas de saldo prepago y pagos de factura postpago vienen de la misma fuente. El campo kind distingue entre recharge e invoice_payment. Los montos vienen con 6 decimales.
Paginación con limit (por defecto 20, máximo 100) y offset (por defecto 0). La respuesta trae data.items y data.pagination.
Información financiera sensible
La API key debe tener habilitada explícitamente la capacidad account. Tener acceso a todos los servicios NO la concede: se otorga aparte, por clave, desde el portal de clientes (Desarrolladores → Claves API). Una key sin la capacidad recibe 403.
Parámetros de consulta
limitPor defecto: 20
offsetPor defecto: 0
statusRespuestas
Página de pagos.
{
"success": true,
"data": {
"items": [
{
"reference": "HBL-3WWG4VEH92",
"kind": "recharge",
"amount": "50000.000000",
"currency": "COP",
"status": "approved",
"method": "new_card",
"processor": "epayco",
"createdAt": "2026-05-18 12:30:00",
"approvedAt": "2026-05-18 12:31:15",
"expiresAt": null
}
],
"pagination": { "limit": 20, "offset": 0, "returned": 1, "hasMore": false }
},
"meta": {
"requestId": "b9b1704baffab21150213c02fd853975",
"timestamp": "2026-06-02T19:43:59+00:00",
"responseTimeMs": 4.1
}
}Credenciales inválidas o faltantes.
La API key no tiene la capacidad requerida, o la organización no puede ejecutar la solicitud.
Se excedió el límite de solicitudes. Espera lo que indique Retry-After.
Errores posibles
Códigos que este endpoint puede devolver en error.code. El detalle completo está en el catálogo.
AUTH_REQUIREDNo se envió un token Bearer y cada llamada lo requiere.401AUTH_INVALID_KEYLa API key no se reconoce: formato equivocado, revocada o vencida.401AUTH_SERVICE_NOT_ALLOWEDLa key no tiene permitido el servicio detrás de este endpoint.403ACCOUNT_NOT_ACTIVETu organización está suspendida o cerrada.403ACCOUNT_BLOCKEDHay un bloqueo total activo: cada llamada se rechaza.403ACCOUNT_CONFIG_NOT_FOUNDNo pudimos cargar la organización de tu key.403FORBIDDEN403 genérico: alternativa cuando no aplica un `ACCOUNT_*`.429RATE_TPS_EXCEEDEDExcediste el cupo de tu organización para este endpoint.