Stripe - Cancelar Suscripción

Descripcion

Este módulo permite cancelar suscripciones existentes. Puede cancelar inmediatamente o programar la cancelación para el final del período de facturación actual.

Configuración

Credenciales Requeridas

• Secret Key: Clave secreta de Stripe

Parámetros

Parámetro	Tipo	Requerido	Descripción
credentials_id	credential	Sí	Credenciales de Stripe
subscription_id	string	Sí	ID de la suscripción (sub_xxx)
cancel_at_period_end	boolean	No	Cancelar al final del período (default: true)
cancellation_reason	string	No	Motivo de la cancelación
prorate	boolean	No	Prorratear el período restante
invoice_now	boolean	No	Generar factura inmediatamente

Salida

Cancelación al final del período

{
  "success": true,
  "subscription": {...},
  "subscription_id": "sub_1MowQVLkdIwHu7ixeRlqHVzs",
  "status": "active",
  "cancel_at_period_end": true,
  "current_period_end": 1682288167,
  "message": "Suscripción sub_1MowQV... se cancelará al final del período"
}

Cancelación inmediata

{
  "success": true,
  "subscription": {...},
  "subscription_id": "sub_1MowQVLkdIwHu7ixeRlqHVzs",
  "status": "canceled",
  "canceled_at": 1679609767,
  "message": "Suscripción sub_1MowQV... cancelada inmediatamente"
}

Ejemplo de Uso

Cancelar al final del período (recomendado)

{
  "subscription_id": "sub_1MowQVLkdIwHu7ixeRlqHVzs",
  "cancel_at_period_end": true,
  "cancellation_reason": "Cliente solicitó cancelación"
}

Cancelación inmediata

{
  "subscription_id": "sub_1MowQVLkdIwHu7ixeRlqHVzs",
  "cancel_at_period_end": false,
  "prorate": true
}

Cancelación inmediata con factura

{
  "subscription_id": "sub_1MowQVLkdIwHu7ixeRlqHVzs",
  "cancel_at_period_end": false,
  "invoice_now": true
}

API Utilizada

• Endpoint: DELETE /v1/subscriptions/{id} o POST /v1/subscriptions/{id}
• Documentación: Stripe Cancel Subscription

Notas

• cancel_at_period_end: true mantiene el acceso hasta el final del período pagado
• La cancelación inmediata puede generar un prorrateo de crédito
• El motivo de cancelación se guarda en cancellation_details
• Una suscripcion cancelada no puede reactivarse (crear nueva)

Nodos relacionados

• StripeCreateSubscription - Crear nuevas suscripciones
• StripeGetSubscriptions - Obtener y buscar suscripciones existentes
• StripeGetCustomers - Obtener datos del cliente de la suscripcion