Skip to main content
GET
/
customers
/
session
/
charges
/
{chargeId}
curl https://api.onepay.la/v1/customers/session/charges/9e02966f-2ddf-4ee7-a391-5b5b7653e232 \
  -H "Authorization: Bearer sk_test_xxx" \
  -H "x-customer-token: 12|a1b2c3d4e5f6..."

{
  "charge_id": "9e02966f-2ddf-4ee7-a391-5b5b7653e232",
  "status": "created",
  "amount": 50000,
  "currency": "COP",
  "description": "Pago mensualidad marzo",
  "remarks": null,
  "paid_at": null,
  "created_at": "2026-03-17T21:30:00+00:00"
}
Consulta el estado actual de un cargo previamente creado con POST /customers/session/charges. Útil para hacer polling del estado del cargo mientras el cliente aprueba o rechaza vía WhatsApp.
Solo puedes consultar cargos que pertenezcan al cliente autenticado. Intentar consultar un cargo de otro cliente retorna 404.

​
Headers

​
Authorization
string
required
Bearer token de tu empresa.
​
X-Customer-Token
string
required
Token de sesión del cliente obtenido en /customers/login/verify.

​
Path Parameters

​
chargeId
string
required
ID del cargo a consultar. Retornado al crear el cargo con POST /customers/session/charges.

​
Response

​
charge_id
string
Identificador único del cargo.
​
status
string
Estado actual del cargo. Valores posibles:
  • created — Pendiente de aprobación
  • paid — Aprobado y cobrado exitosamente
  • failed — Rechazado o expirado
​
amount
integer
Monto del cargo en centavos.
​
currency
string
Moneda del cargo (COP, USD).
​
description
string
Descripción del cargo.
​
remarks
string | null
Motivo del fallo cuando status es failed. null en otros estados.
​
paid_at
string | null
Fecha y hora del pago en formato ISO 8601. null si aún no ha sido pagado.
​
created_at
string
Fecha y hora de creación del cargo en formato ISO 8601.
curl https://api.onepay.la/v1/customers/session/charges/9e02966f-2ddf-4ee7-a391-5b5b7653e232 \
  -H "Authorization: Bearer sk_test_xxx" \
  -H "x-customer-token: 12|a1b2c3d4e5f6..."

{
  "charge_id": "9e02966f-2ddf-4ee7-a391-5b5b7653e232",
  "status": "created",
  "amount": 50000,
  "currency": "COP",
  "description": "Pago mensualidad marzo",
  "remarks": null,
  "paid_at": null,
  "created_at": "2026-03-17T21:30:00+00:00"
}