Stripe - Crear Suscripción

Descripcion

Este módulo permite crear suscripciones recurrentes para clientes, vinculándolos a un precio/producto y configurando opciones como período de prueba, cupones y método de cobro.

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
customer_id	string	Sí	ID del cliente (cus_xxx)
price_id	string	Sí	ID del precio (price_xxx)
quantity	number	No	Cantidad (default: 1)
default_payment_method	string	No	Método de pago por defecto
trial_period_days	number	No	Días de período de prueba
collection_method	select	No	Método de cobro
days_until_due	number	No	Días para pagar factura
coupon	string	No	Código de cupón
cancel_at_period_end	boolean	No	Cancelar al final del período
metadata	string	No	Metadatos personalizados (JSON)

Salida

{
  "success": true,
  "subscription": {...},
  "subscription_id": "sub_1MowQVLkdIwHu7ixeRlqHVzs",
  "status": "active",
  "current_period_start": 1679609767,
  "current_period_end": 1682288167,
  "message": "Suscripción sub_1MowQV... creada (active)"
}

Ejemplo de Uso

Suscripción simple

{
  "customer_id": "cus_NffrFeUfNV2Hib",
  "price_id": "price_1MoC3cLkdIwHu7ixFd9J0pzG"
}

Suscripción con período de prueba

{
  "customer_id": "cus_NffrFeUfNV2Hib",
  "price_id": "price_1MoC3cLkdIwHu7ixFd9J0pzG",
  "trial_period_days": 14,
  "default_payment_method": "pm_1234567890"
}

Suscripción con cupón

{
  "customer_id": "cus_NffrFeUfNV2Hib",
  "price_id": "price_1MoC3cLkdIwHu7ixFd9J0pzG",
  "coupon": "DESCUENTO20",
  "metadata": "{\"plan_name\": \"Premium\"}"
}

Suscripción con factura

{
  "customer_id": "cus_NffrFeUfNV2Hib",
  "price_id": "price_1MoC3cLkdIwHu7ixFd9J0pzG",
  "collection_method": "send_invoice",
  "days_until_due": 30
}

API Utilizada

• Endpoint: POST /v1/subscriptions
• Documentación: Stripe Create Subscription

Notas

• El cliente debe tener un método de pago válido
• Los precios deben estar configurados previamente en Stripe
• El período de prueba no cobra al cliente
• collection_method: send_invoice envia factura por email

Nodos relacionados

• StripeGetSubscriptions - Obtener y buscar suscripciones existentes
• StripeCancelSubscription - Cancelar suscripciones activas
• StripeGetCustomers - Obtener datos del cliente
• StripeCreateCustomer - Crear el cliente antes de suscribir
• StripeGetInvoices - Obtener facturas generadas por la suscripcion