Stripe - Obtener Suscripciones

Descripcion

Este módulo permite consultar las suscripciones activas y pasadas en Stripe. Puede obtener una suscripción específica o listar múltiples con filtros.

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	No	ID específico (sub_xxx)
customer_id	string	No	Filtrar por cliente
price_id	string	No	Filtrar por precio
status	select	No	Filtrar por estado
created_gte	string	No	Creado después de (timestamp Unix)
limit	number	No	Límite de resultados (default: 10)
starting_after	string	No	ID del último objeto para paginación

Estados de Suscripción

• active: Activa
• past_due: Pago atrasado
• unpaid: No pagada
• canceled: Cancelada
• incomplete: Incompleta
• incomplete_expired: Expirada incompleta
• trialing: En período de prueba
• paused: Pausada

Salida

{
  "success": true,
  "subscriptions": [...],
  "count": 10,
  "has_more": true,
  "message": "10 suscripciones obtenidas"
}

Campos de Suscripción

• id: ID de la suscripción (sub_xxx)
• status: Estado actual
• customer: ID del cliente
• items: Productos/precios suscritos
• current_period_start: Inicio del período actual
• current_period_end: Fin del período actual
• cancel_at_period_end: Si se cancelará al final
• trial_start: Inicio de prueba
• trial_end: Fin de prueba

Ejemplo de Uso

Obtener por ID

{
  "subscription_id": "sub_1MowQVLkdIwHu7ixeRlqHVzs"
}

Suscripciones activas de un cliente

{
  "customer_id": "cus_NffrFeUfNV2Hib",
  "status": "active"
}

Suscripciones con pago atrasado

{
  "status": "past_due",
  "limit": 50
}

API Utilizada

• Endpoint: GET /v1/subscriptions
• Documentación: Stripe Subscriptions API

Notas

• Una suscripción past_due intentará cobrar automáticamente
• current_period_end indica cuándo se renovará o cancelará
• Las suscripciones trialing no cobran hasta que termine la prueba

Nodos relacionados

• StripeCreateSubscription - Crear nuevas suscripciones
• StripeCancelSubscription - Cancelar suscripciones activas
• StripeGetCustomers - Obtener datos del cliente de la suscripcion
• StripeGetInvoices - Obtener facturas generadas por suscripciones