Modalità test
Selgeo offre un ambiente di test completo che ti permette di verificare la tua integrazione dall'inizio alla fine, senza elaborare pagamenti reali né inviare e-mail a partner reali. Tutte le funzionalità della modalità test usano l'API versione v1.
Confronto test vs. live
| Aspetto | Modalità test | Modalità live |
|---|---|---|
| Chiavi API | pk_test_*, sk_test_* | pk_live_*, sk_live_* |
| Dati | Completamente isolati — i dati di test non compaiono mai nei report live | Dati di produzione |
| Stripe | Si connette al tuo ambiente test di Stripe | Si connette al tuo ambiente live di Stripe |
| Soppresse — non viene inviata alcuna e-mail a partner o merchant | Consegnate normalmente | |
| Webhook | Consegnati agli endpoint in modalità test (HTTPS obbligatorio) | Consegnati agli endpoint in modalità live (HTTPS obbligatorio) |
| Limiti di velocità | Limiti identici in entrambe le modalità | Limiti identici in entrambe le modalità |
| Rilevamento frodi | Attivo — stesse regole della modalità live | Attivo |
| Cancellazione GDPR | Pienamente funzionante | Pienamente funzionante |
Le modalità test e live sono completamente separate. Partner, clic, conversioni, commissioni ed endpoint webhook creati in modalità test sono invisibili in modalità live, e viceversa. Puoi eseguire liberamente scenari di test senza intaccare i dati di produzione.
Ottenere le chiavi di test
- Accedi alla dashboard merchant di Selgeo.
- Vai su Impostazioni > Chiavi API.
- La tua chiave pubblica di test (
pk_test_*) è mostrata insieme a quella live. Fai clic su Genera chiave segreta in modalità Test per emetteresk_test_*: le chiavi segrete vengono create su richiesta, non in anticipo.
Ciclo di test passo dopo passo
Segui questa procedura per verificare l'intero flusso di attribuzione: clic, attribuzione, conversione e commissione.
Passaggio 1 — Installare lo snippet con la chiave pubblica di test
Aggiungi lo snippet di tracciamento Selgeo a una pagina di test del tuo sito (o a un ambiente di sviluppo locale). Usa la tua chiave pubblica di test:
<script
src="https://cdn.selgeo.com/v1/selgeo.js"
data-merchant="pk_test_YOUR_KEY"
async
></script>
Passaggio 2 — Creare un partner di test
Nella dashboard, crea un programma di test (o usane uno esistente) e approva un partner di test. I link di referral vengono creati dai partner nel portale partner: accedi come partner di test, apri Link e crea un link. Copia il suo URL. Sarà simile a:
https://tuosito.com/?ref=abc123
Passaggio 3 — Simulare un clic
Apri il link di referral nel tuo browser. Lo snippet Selgeo cattura il clic e crea un'attribuzione in sospeso. Puoi verificarlo nella dashboard, in Analytics > Clic.
Lo snippet memorizza un click_id che collega questo visitatore al partner che lo ha segnalato.
Passaggio 4 — Segnalare una conversione di test
Dopo il clic simulato, attiva una conversione. Il metodo dipende dalla tua integrazione:
- Stripe Checkout
- API di conversione
Completa un pagamento di test Stripe usando una carta di test Stripe (es. 4242 4242 4242 4242). Selgeo riceve il webhook di Stripe e crea automaticamente la conversione.
Invia una conversione direttamente tramite l'API usando la tua chiave segreta di test:
curl -X POST https://app.selgeo.com/api/v1/conversions \
-H "Authorization: Bearer sk_test_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"click_id": "IL_CLICK_ID_DAL_PASSAGGIO_3",
"event_type": "purchase",
"external_transaction_id": "test_txn_001",
"amount_cents": 9900,
"currency": "EUR"
}'
Passaggio 5 — Verificare la conversione e la commissione
- Vai alla pagina Analytics nella dashboard. Dovresti vedere la conversione registrata.
- Vai su Commissioni. Dovrebbe essere stata calcolata una commissione in base alle regole di commissione del tuo programma.
- Se le tue regole di commissione prevedono un periodo di trattenimento, la commissione sarà in stato
pending. Verrà approvata automaticamente allo scadere del periodo di trattenimento.
Passaggio 6 — Testare i webhook
Se hai endpoint webhook registrati in modalità test, controlla il registro di consegna in Impostazioni > Webhooks. Dovresti vedere le consegne per gli eventi conversion.created e commission.created.
Gli endpoint webhook devono usare HTTPS ed essere raggiungibili pubblicamente — anche in modalità test. Per lo sviluppo locale, esponi il tuo server locale tramite un tunnel come ngrok e registra l'URL HTTPS del tunnel (es. https://your-tunnel.ngrok.app/webhooks/selgeo).
Ambiente di test Stripe
In modalità test, Selgeo si connette al tuo ambiente di test Stripe. Questo significa che:
- I numeri di carta di test funzionano come previsto (es.
4242 4242 4242 4242per un addebito riuscito) - I rimborsi di test attivano gli eventi
commission.refunded - Gli abbonamenti di test generano eventi di conversione ricorrenti
- I webhook di Stripe provenienti dal tuo ambiente di test vengono elaborati e attribuiti normalmente
Quando colleghi la tua chiave con restrizioni Stripe in modalità test in Impostazioni > Stripe, Selgeo registra automaticamente l'endpoint webhook di test: non devi copiare manualmente alcun URL webhook in Stripe. Assicurati che la chiave con restrizioni includa il permesso webhook_endpoints:write.
Numeri di carta di test Stripe
| Numero carta | Comportamento |
|---|---|
4242 4242 4242 4242 | Successo |
4000 0000 0000 3220 | Richiede autenticazione 3D Secure |
4000 0000 0000 0002 | Rifiutata (card_declined) |
Consulta la documentazione Stripe sui test per l'elenco completo.
Reimpostare i dati di test
Quando vuoi ripartire da zero, usa il pulsante Reimposta dati di test nella dashboard Selgeo (pagina Impostazioni, modalità test). Questa azione elimina in un solo passaggio tutti i dati in modalità test del tuo workspace:
- Partner e partecipanti
- Clic ed eventi di attribuzione
- Conversioni e commissioni
- Registri di consegna dei webhook
- Registri delle notifiche
Puoi anche reimpostare i dati a livello di codice tramite l'API:
curl -X DELETE https://app.selgeo.com/api/v1/workspace/test-data \
-H "Authorization: Bearer YOUR_JWT_TOKEN"
Questa azione è irreversibile. Tutti i dati in modalità test verranno eliminati definitivamente.
Suggerimenti
- Reimposta regolarmente i dati di test. Usa il pulsante Reimposta dati di test o l'endpoint API qui sopra per ripartire da zero, invece di eliminare manualmente i singoli record.
- Testa i webhook per tempo. Configura gli endpoint webhook in modalità test prima di andare in produzione. Verifica che il tuo server gestisca tutti i tipi di evento di cui hai bisogno.
- Testa i casi limite. Prova scenari come finestre di attribuzione scadute, conversioni duplicate, rimborsi e partner sospesi, per assicurarti che la tua integrazione li gestisca correttamente.
- Controlla la soppressione delle e-mail. Ricorda che in modalità test non viene inviata alcuna e-mail. Se hai bisogno di verificare quali notifiche sarebbero state inviate, controlla il registro delle notifiche di test in-app — il Registro notifiche (la "Casella di test") — nella dashboard.
- Quando sei pronto, segui la Checklist di messa in produzione per passare alla produzione.