Suscripción

Una Subscription liga a un Customer con un Plan y es la entidad que Rekurra usa para agendar y ejecutar los cobros recurrentes sobre tu cuenta de Wompi.

Campos

Campo	Tipo	Descripción
`id`	string	Identificador único
`customer_id`	string	Cliente dueño de la suscripción
`plan_id`	string	Plan al que está suscrito
`status`	string	`trialing` · `active` · `past_due` · `paused` · `paused_insufficient_balance` · `canceled`
`cycle`	string	`monthly` o `annual`
`current_period_start`	datetime	Inicio del periodo de facturación actual
`current_period_end`	datetime	Fin del periodo de facturación actual
`next_charge_date`	datetime	Próxima fecha de cobro programada
`default_payment_method_id`	string	Método de pago usado para los cobros
`trial_end`	datetime?	Fin del periodo de prueba, si aplica
`cancel_at_period_end`	boolean	Si se cancelará al terminar el periodo actual
`failed_attempts`	integer	Intentos de cobro fallidos consecutivos
`created_at`	datetime	Fecha de creación

Estados

trialing — dentro del periodo de prueba (trial_days), sin cobros.
active — al día, cobros ejecutándose en cada ciclo.
past_due — el último cobro falló; Rekurra reintenta durante un periodo de gracia.
paused — pausada manualmente vía POST /{id}/pause.
paused_insufficient_balance — Rekurra pausó los cobros porque tu saldo prepago no alcanza para cubrir el fee proyectado. Ver Saldo prepago.
canceled — cancelada, ya sea inmediatamente o al final del periodo (cancel_at_period_end).

Acciones disponibles

POST /{id}/cancel — cancela, con at_period_end: true opcional.
POST /{id}/pause / POST /{id}/resume — pausa y reanuda manualmente.
POST /{id}/change-plan — cambia de plan/ciclo, con prorrateo opcional.
POST /{id}/charge-now — fuerza un reintento manual de cobro.

Todas las creaciones de suscripción (POST /v1/subscriptions) respetan el header Idempotency-Key para evitar duplicados por reintentos de red.

Ver la referencia completa en API → Subscriptions y la guía Crear una suscripción.

Plan Cliente