Skip to main content
GET
https://api.onepay.la/v1
/
subscriptions
/
{subscription_id}
Detalles de una suscripción
curl --request GET \
  --url https://api.onepay.la/v1/subscriptions/{subscription_id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "9ddfcfc1-7b5e-490c-9731-4aabd986908e",
  "name": "SpectreSaaS",
  "status": "active",
  "description": "<p>1 Free</p><p>2 COP 449.000</p>",
  "internal_id": "SaaSSpectre",
  "plan_id": null,
  "coupon_id": null,
  "reference_price_in_cents": "44900000",
  "currency": "COP",
  "amount_in_cents": 44900000,
  "cicle_frequency": "monthly",
  "cicles": null,
  "current_cicle": 2,
  "allows": {
    "cards": true,
    "accounts": true,
    "card_extra": false,
    "realtime": false,
    "pse": true,
    "transfiya": true
  },
  "suggest_auto_debit": true,
  "start_date": "2025-01-05T00:00:00.000000Z",
  "end_date": null,
  "payment_mode": "request",
  "trial": {
    "has_trial": false,
    "start_trial_date": null,
    "trial_days": 0
  },
  "remember_to_pay_before": 3,
  "cancel_after_no_payment_before": 2,
  "complex_payments": [],
  "features": [],
  "metadata": null,
  "created_at": "2025-01-02T19:24:48.000000Z",
  "updated_at": "2025-02-05T16:01:24.000000Z",
  "customer": {
    "id": "9dd4158b-0e45-42bc-b56f-a4c1f856814d",
    "first_name": "Empresa",
    "last_name": "SAS",
    "email": "empresa@empresa.com",
    "phone": "+573221234567",
    "document": "1234567890",
    "document_type": "RUT"
  }
}

​
Parámetros de Ruta

​
subscription_id
string
required
ID único de la suscripción que deseas consultar

​
Response

​
id
string
Identificador único de la suscripción (UUID).
​
name
string
Nombre comercial de la suscripción.
​
status
string
Estado actual (active, unpaid, pass_due, canceled, finished, frozen).
​
description
string
Descripción enriquecida (puede contener HTML).
​
internal_id
string
Identificador interno que usas en tu sistema.
​
plan_id
string
ID del plan asociado, si aplica.
​
coupon_id
string
ID del cupón aplicado.
​
reference_price_in_cents
string
Precio de referencia en centavos como string.
​
currency
string
Moneda en formato ISO-4217 (ej. COP).
​
amount_in_cents
number
Valor base cobrado en cada ciclo.
​
cicle_frequency
string
Frecuencia de cobro: weekly, monthly, annual, etc.
​
cicles
number
Cantidad máxima de ciclos; null para indefinido.
​
current_cicle
number
Ciclo actual procesado.
​
allows
object
Configuración de métodos de pago permitidos para la suscripción.
​
suggest_auto_debit
boolean
Indica si se sugiere activar débito automático durante el onboarding del cliente.
​
start_date
date
Fecha programada de inicio.
​
end_date
date
Fecha de finalización si aplica.
​
trial
object
Información de periodo de prueba (has_trial, trial_days, start_trial_date).
​
payment_mode
string
Modo de cobro (request, auto_debit, etc.).
​
remember_to_pay_before
number
Días de anticipación para recordatorios de pago.
​
cancel_after_no_payment_before
number
Número de ciclos fallidos antes de cancelar automáticamente.
​
complex_payments
array
Pagos con valores diferenciados por ciclo.
​
metadata
object
Atributos personalizados que acompañan la suscripción.
​
customer
object
Resumen del cliente asociado.
​
plan
object
Información del plan enlazado, cuando existe.
​
created_at
date
Fecha de creación de la suscripción.
​
updated_at
date
Fecha de última actualización.
{
  "id": "9ddfcfc1-7b5e-490c-9731-4aabd986908e",
  "name": "SpectreSaaS",
  "status": "active",
  "description": "<p>1 Free</p><p>2 COP 449.000</p>",
  "internal_id": "SaaSSpectre",
  "plan_id": null,
  "coupon_id": null,
  "reference_price_in_cents": "44900000",
  "currency": "COP",
  "amount_in_cents": 44900000,
  "cicle_frequency": "monthly",
  "cicles": null,
  "current_cicle": 2,
  "allows": {
    "cards": true,
    "accounts": true,
    "card_extra": false,
    "realtime": false,
    "pse": true,
    "transfiya": true
  },
  "suggest_auto_debit": true,
  "start_date": "2025-01-05T00:00:00.000000Z",
  "end_date": null,
  "payment_mode": "request",
  "trial": {
    "has_trial": false,
    "start_trial_date": null,
    "trial_days": 0
  },
  "remember_to_pay_before": 3,
  "cancel_after_no_payment_before": 2,
  "complex_payments": [],
  "features": [],
  "metadata": null,
  "created_at": "2025-01-02T19:24:48.000000Z",
  "updated_at": "2025-02-05T16:01:24.000000Z",
  "customer": {
    "id": "9dd4158b-0e45-42bc-b56f-a4c1f856814d",
    "first_name": "Empresa",
    "last_name": "SAS",
    "email": "empresa@empresa.com",
    "phone": "+573221234567",
    "document": "1234567890",
    "document_type": "RUT"
  }
}