Checklist di messa in produzione

Segui questa checklist quando sei pronto a passare dalla modalità test a quella live. Completa ogni voce prima di abilitare il tuo programma per partner e clienti reali. Tutti gli endpoint fanno riferimento a API versione v1.

1. Sostituire le chiavi di test con le chiavi live

Sostituire	Con
pk_test_* (nello snippet di tracciamento)	pk_live_*
sk_test_* (nel codice lato server / variabili di ambiente)	sk_live_*

Dove controllare:

• Attributo data-merchant dello snippet di tracciamento nel tuo HTML/template
• Variabili di ambiente lato server per l'API di conversione
• Segreti della pipeline CI/CD o configurazione di deployment
• Qualsiasi script o cron job che chiama l'API Selgeo

pericolo

Non committare mai le chiavi segrete live (sk_live_*) nel controllo versione. Usa variabili di ambiente o un gestore di segreti.

2. Verificare la connessione live di Stripe

1. Nella dashboard Selgeo, vai su Impostazioni > Stripe.
2. Conferma che il tuo account Stripe live è connesso.
3. Verifica che i seguenti eventi siano abilitati nel tuo webhook Stripe:
   • checkout.session.completed
   • invoice.paid
   • charge.refunded

3. Rimuovere i dati di test

• Rimuovere i partner di test che non devono essere trasferiti
• Archiviare o eliminare i programmi di test
• Cancellare gli endpoint webhook di test che puntano a localhost

4. Verificare gli endpoint webhook

1. Vai su Impostazioni > Webhooks nella dashboard.
2. Crea (o verifica) i tuoi endpoint webhook in modalità live. Gli endpoint live devono usare HTTPS.
3. Iscriviti agli eventi di cui la tua applicazione ha bisogno.
4. Fai clic su Invia ping di test per ogni endpoint.
5. Conserva il segreto di firma (whsec_...) in modo sicuro.
6. Verifica che il tuo server validi correttamente le firme webhook.

5. Verificare i limiti di velocità

Zona	Limite
Tracciamento (POST /v1/clicks)	1.000 req/min per chiave pk_*
API di conversione (POST /api/v1/conversions)	120 req/min per chiave sk_*
API generale	300 req/min per indirizzo IP

6. Verificare le regole di commissione

Vai su Programmi > [Il Tuo Programma] > Regole di commissione e verifica che le percentuali, gli importi fissi, i periodi di attesa e le impostazioni di approvazione automatica siano corretti per la produzione.

7. Testare il flusso completo un'altra volta

1. Apri il tuo link di referral in un browser.
2. Completa un acquisto reale (puoi rimborsarlo in seguito).
3. Verifica che il clic, la conversione e la commissione appaiano nella dashboard.
4. Verifica che gli eventi webhook siano stati consegnati ai tuoi endpoint.
5. Rimborsa la transazione in Stripe e conferma che l'evento commission.refunded si attivi.

8. Attivare il tuo programma

1. Imposta lo stato del tuo programma su Attivo nella dashboard.
2. Condividi i link di invito al programma con i tuoi partner.
3. Monitora la dashboard per le prime registrazioni di partner e conversioni reali.

Monitoraggio post-lancio

• Registro di consegna webhook — controlla le consegne fallite o dead-letter
• Registro di audit dell'attribuzione — esamina le decisioni di attribuzione
• Avvisi di frode — monitora gli eventi conversion.fraud_detected
• Coda di revisione delle commissioni — approva o rifiuta le commissioni che richiedono revisione manuale