Listar cobros

GET https://api.geopagos.io/api/v1.0/charges

Query params (snake_case)

Parámetro	Requerido	Descripción
limit	Sí	—
offset	Sí	—
subscription_id	No	—
status	No	Valores: pending, processing, succeeded, failed, cancelled
created_after	No	—
created_before	No	—
search	No	Búsqueda por nombre, email, documento o referencia externa del cliente

Nota: Estado en el ejemplo original

La tabla de filtros enumera pending, processing, succeeded, failed y cancelled, mientras que el ejemplo de respuesta usa paid. Ambos se conservan tal como aparecen en el PDF; confirmá esta diferencia con el equipo de Sipago al integrar.

Response 200

{
  "data": [
    {
      "charge_id": "chg_123",
      "subscription_id": "sub_123",
      "amount": 1000,
      "currency": "ARS",
      "status": "paid",
      "billing_period_start": "2026-07-01T00:00:00Z",
      "billing_period_end": "2026-08-01T00:00:00Z",
      "attempt_count": 1,
      "max_attempts": 3,
      "created_at": "2026-07-01T00:00:00Z",
      "updated_at": "2026-07-01T00:00:00Z",
      "customer_name": "Juan Pérez",
      "customer_email": "juan@example.com",
      "plan_name": "Plan Mensual",
      "payment_method_last4": "4242",
      "payment_method_brand": "visa"
    }
  ],
  "pagination": { "total": 1, "limit": 20, "offset": 0 }
}

Campos completos: charge_id, subscription_id, amount, currency, status, reference_number?, billing_period_start, billing_period_end, attempt_count, max_attempts, last_attempt_at?, next_attempt_at?, failure_reason?, failure_code?, created_at, updated_at, customer_name, customer_email, plan_name, payment_method_last4, payment_method_brand, external_reference?, attempts?.