Cancelar una suscripción

post/v1/subscriptions/{id}/cancel

Cancela la suscripción de inmediato o al final del período actual (at_period_end).

Request

BASH

curl -X POST https://api.cauril.com/v1/subscriptions/<id>/cancel \
  -H "Authorization: Bearer sk_test_..." \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "at_period_end": false
  }'

Parámetros

idpathreq

string

Cuerpo CancelSubscription

at_period_end boolean Si es true, la cancelación se programa para el final del período actual. Default: false.

Respuestas

200	Suscripción cancelada (o programada para cancelar)	Subscription
404	Error	Error
409	Error	Error

Ejemplo de respuesta · 200

JSON

{
  "object": "subscription",
  "id": "sub_01J...",
  "status": "incomplete",
  "customer_id": "cus_01J...",
  "plan_id": "plan_01J...",
  "provider": "stripe",
  "engine": "native",
  "current_period_start": "2026-06-01T12:00:00Z",
  "current_period_end": "2026-06-01T12:00:00Z",
  "cancel_at_period_end": true,
  "trial_end": null,
  "provider_subscription_id": null,
  "metadata": {},
  "latest_invoice": null,
  "created_at": "2026-06-01T12:00:00Z",
  "updated_at": "2026-06-01T12:00:00Z"
}