Lane · Documentación

Referencia

Suscripciones

Se crean desde el panel. La API las lee.

GET/v1/subscriptions

Las suscripciones del entorno.

Query

CampoTipoObligatorioDescripción
statustextonoUno o varios separados por coma: incomplete, trialing, active, past_due, paused o canceled.
customer_idUUIDnoLas de un cliente.
limitenteronoPor defecto 25, máximo 100.
starting_aftercursornoPaginación.

El objeto

CampoTipoObligatorioDescripción
plan_idUUIDnoEl plan al que está suscrito.
statustextonoUno de los seis del filtro. past_due es un cobro pendiente después de agotar los reintentos.
quantityenteronoCuántas unidades del plan se cobran en cada ciclo.
price_amountenteronoEl precio por unidad de esta suscripción, en centavos. null si sigue el precio del plan.
customer_idUUIDnoEl cliente.
payment_instrument_idUUIDnoLa tarjeta que se cobra.
current_period_startfechanoInicio del ciclo en curso.
current_period_endfechanoFin del ciclo en curso.
next_charge_atfechanoCuándo sale el próximo cobro.
started_atfechanoCuándo empezó.
cancelled_atfechanoCuándo se canceló, si se canceló.
metadataobjetonoSin las llaves que empiezan por lane_ o blink_.

Listar

curl "https://api.lane.money/v1/subscriptions?status=active" \
  -H "Authorization: Bearer sk_test_…"
Los avisos importantes llegan por webhook. Cuando un cobro recurrente falla llega subscription.payment_failed con la fecha del próximo intento, y cuando se agotan los reintentos, subscription.past_due o, si el comercio eligió cancelar, subscription.canceled. Ver Webhooks.

Esta página en markdown: /docs/api/suscripciones.md · Toda la documentación: /docs/llms-full.txt