# Stripe Subscriptions

**ID:** payments-stripe-subscriptions
**Version:** 2.5.0
**Estado:** production
**Categoria:** payments
**Ultima actualizacion:** 2026-01-04

---

## Descripcion

Manejo completo de suscripciones con Stripe. Incluye billing portal, manejo de planes, proration, y ciclo de vida de suscripciones.

## Caracteristicas

- Crear/cancelar suscripciones
- Billing portal (Stripe hosted)
- Proration handling
- Usage-based billing
- Trial periods
- Multiple planes/tiers
- Webhooks para lifecycle events

## Variables de Entorno

```env
STRIPE_SECRET_KEY=sk_test_...
STRIPE_WEBHOOK_SECRET=whsec_...
STRIPE_BILLING_PORTAL_RETURN_URL=https://myapp.com/account
```

## Eventos Webhook Manejados

- `customer.subscription.created`
- `customer.subscription.updated`
- `customer.subscription.deleted`
- `invoice.payment_succeeded`
- `invoice.payment_failed`

## Proyectos que lo Usan

- trading-platform (planes: free, basic, premium)

## Referencias

| Proyecto | Ubicacion |
|----------|-----------|
| trading-platform | `apps/backend/src/modules/subscriptions/` |

---

**Mantenedor:** @PERFIL_BACKEND