# Stripe in produzione — guida rapida

## 1. Stripe Dashboard (modalità Test per prove, poi Live)

### Prodotti e prezzi
Crea **2 prodotti** in Stripe, ciascuno con **2 prezzi ricorrenti**:

| Piano app | Prodotto Stripe (Dashboard) | Mensile | Annuale | Variabile `.env` |
|-----------|------------------------------|---------|---------|------------------|
| Premium Light | **Match Live TV** | €4,90 | €39,90 | `STRIPE_PREMIUM_LIGHT_MONTHLY_PRICE_ID` / `..._YEARLY_...` |
| Premium Full | **Match Live TV PRO** | €9,90 | €69,90 | `STRIPE_PREMIUM_FULL_MONTHLY_PRICE_ID` / `..._YEARLY_...` |

In Stripe apri ogni prezzo e copia l’**ID prezzo** (`price_...`), non l’ID prodotto.

In Dashboard: Prodotto → **Aggiungi prezzo** (non serve un prodotto per ogni intervallo).

### Webhook (obbligatorio)
**Developers → Webhooks → Aggiungi endpoint**

| Campo | Valore |
|--------|--------|
| URL | `https://www.matchlivetv.it/webhooks/stripe` |
| Eventi | `checkout.session.completed`, `customer.subscription.created`, `customer.subscription.updated`, `customer.subscription.deleted`, `invoice.paid`, `invoice.payment_failed` |

Copia il **Signing secret** (`whsec_...`) — **non** usare il secret di `stripe listen` (solo per locale).

### Chiavi API
- Test: `sk_test_...` + price test
- Live: `sk_live_...` + price live (prodotti creati in modalità Live)

## 2. Server (`/opt/matchlivetv/infra/.env`)

> **Non usare** `~/matchlivetv/infra/.env` — è una copia vecchia (bootstrap).
> Docker in produzione legge solo **`/opt/matchlivetv/infra/.env`**.
> Per aggiungere chiavi mancanti dal template: `./scripts/merge_production_env.sh` con `REMOTE=1`.

```bash
STRIPE_SECRET_KEY=sk_test_...   # o sk_live_...
STRIPE_WEBHOOK_SECRET=whsec_... # dal webhook Dashboard (URL produzione)
STRIPE_PREMIUM_LIGHT_MONTHLY_PRICE_ID=price_...
STRIPE_PREMIUM_LIGHT_YEARLY_PRICE_ID=price_...
STRIPE_PREMIUM_FULL_MONTHLY_PRICE_ID=price_...
STRIPE_PREMIUM_FULL_YEARLY_PRICE_ID=price_...
```

Da PC (senza incollare chiavi in chat):

```bash
./scripts/setup_stripe_production.sh
# oppure, se il webhook è nuovo:
./scripts/setup_stripe_production.sh --webhook-secret whsec_...
```

## 3. Test end-to-end

```bash
# Test scelta mensile/annuale (Docker avviato)
chmod +x scripts/test_billing_intervals.sh
./scripts/test_billing_intervals.sh

# Smoke HTTP su produzione
BASE_URL=https://www.matchlivetv.it ./scripts/test_stripe_e2e.sh

# Test locale completo (Docker avviato)
./scripts/test_billing_flow.sh
```

Checkout: `/clubs/:id/checkout?plan=premium_light&interval=yearly` oppure `interval=monthly`

### Test manuale browser
1. Login titolare società → **Abbonamento**
2. **Completa dati di fatturazione** (P.IVA/CF, SDI o PEC, indirizzo)
3. **Attiva Premium Light** → pagina `checkout.stripe.com`
4. Carta test `4242 4242 4242 4242` (solo con `sk_test_`)
5. Ritorno su `/clubs/.../billing?checkout=success`
6. Verifica in Stripe → Webhooks: risposta **200** su `/webhooks/stripe`

## 4. PCI
- Mai `PaymentMethod.create` con `card[number]` sul server
- Prima attivazione: solo **Stripe Checkout**
- Cambio piano (già abbonato): **Subscription.update** Stripe (carta già salvata da Checkout)

## 5. Passaggio a Live
1. Crea prodotti/prezzi in modalità **Live**
2. Nuovo webhook endpoint (stesso URL, modalità Live) → nuovo `whsec_`
3. Sostituisci `sk_live_` e price live in `.env` produzione
4. `./scripts/setup_stripe_production.sh` e ri-test con carta reale