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_*

La tua chiave pubblica live esiste già. La chiave segreta live no: viene creata solo quando fai clic su Genera chiave segreta in modalità Live in Impostazioni > Chiavi API, e viene mostrata una sola volta, senza possibilità di rivederla — salvala prima di chiudere la finestra.

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. Conferma che il webhook Stripe è registrato. Quando colleghi la tua chiave con restrizioni Stripe live in Impostazioni > Stripe, Selgeo registra automaticamente l'endpoint webhook e lo iscrive agli eventi richiesti — non devi aggiungerlo manualmente nella dashboard Stripe. Assicurati che la tua chiave con restrizioni includa il permesso webhook_endpoints:write. Gli eventi a cui Selgeo si iscrive sono:
   • checkout.session.completed
   • invoice.paid
   • charge.refunded
   • charge.dispute.created
   • charge.dispute.closed

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