Checklist de mise en production

Suivez cette checklist lorsque vous êtes prêt à passer du mode test au mode live. Complétez chaque élément avant d'activer votre programme pour de vrais partenaires et clients. Tous les points de terminaison font référence à l'API version v1.

1. Remplacer les clés de test par des clés live

Remplacez toutes les clés API de test dans votre code et votre configuration par leurs équivalents live :

Remplacer	Par
pk_test_* (dans le snippet de suivi)	pk_live_*
sk_test_* (dans le code côté serveur / variables d'environnement)	sk_live_*

Votre clé publique live existe déjà. La clé secrète live, non : elle n'est créée que lorsque vous cliquez sur Générer la clé secrète en mode Live dans Paramètres > Clés API, et elle ne s'affiche qu'une seule fois, sans possibilité de la revoir — enregistrez-la avant de fermer la boîte de dialogue.

Où vérifier :

• Attribut data-merchant du snippet de suivi dans votre HTML/template
• Variables d'environnement côté serveur pour l'API de conversion
• Secrets du pipeline CI/CD ou configuration de déploiement
• Tous les scripts ou tâches cron qui appellent l'API Selgeo

danger

Ne jamais committer les clés secrètes live (sk_live_*) dans le contrôle de version. Utilisez des variables d'environnement ou un gestionnaire de secrets.

2. Vérifier la connexion Stripe live

1. Dans le tableau de bord Selgeo, allez dans Paramètres > Stripe.
2. Confirmez que votre compte Stripe live est connecté (pas seulement le compte de test).
3. Confirmez que le webhook Stripe est enregistré. Lorsque vous connectez votre clé restreinte Stripe live dans Paramètres > Stripe, Selgeo enregistre automatiquement le point de terminaison webhook et l'abonne aux événements requis — vous n'avez pas besoin de l'ajouter manuellement dans le tableau de bord Stripe. Assurez-vous que votre clé restreinte inclut l'autorisation webhook_endpoints:write, puis confirmez que la connexion affiche Connecté. Les événements auxquels Selgeo s'abonne sont :
   • checkout.session.completed
   • invoice.paid
   • charge.refunded
   • charge.dispute.created
   • charge.dispute.closed
4. Envoyez un événement de test depuis le tableau de bord webhook Stripe et confirmez que la conversion ou la commission résultante apparaît dans Analytics / Commissions. (Le journal de livraison sous Paramètres > Webhooks suit vos propres webhooks sortants, et non les événements Stripe entrants.)

3. Supprimer les données de test

Les données en mode test sont isolées du mode live et n'apparaîtront pas dans les rapports live. Cependant, c'est une bonne pratique de nettoyer :

• Supprimer les partenaires de test qui ne doivent pas être transférés
• Archiver ou supprimer les programmes de test utilisés uniquement pour les tests d'intégration
• Effacer les points de terminaison webhook de test s'ils pointent vers localhost ou des URLs de développement

info

Les données en mode test n'affectent les données en mode live d'aucune façon. Cette étape est optionnelle mais aide à garder votre compte en ordre.

4. Vérifier les points de terminaison webhook

1. Allez dans Paramètres > Webhooks dans le tableau de bord.
2. Créez (ou vérifiez) vos points de terminaison webhook en mode live. Les points de terminaison live doivent utiliser HTTPS.
3. Abonnez-vous aux événements dont votre application a besoin. Au minimum, considérez :
   • conversion.created — pour synchroniser les conversions avec votre système
   • commission.created — pour suivre les nouvelles commissions
   • conversion.fraud_detected — pour être alerté en cas de fraude
   • participant.approved — pour provisionner l'accès aux nouveaux partenaires
4. Cliquez sur Envoyer un ping de test pour chaque point de terminaison pour vérifier la connectivité.
5. Stockez le secret de signature (whsec_...) en sécurité dans les variables d'environnement de votre serveur.
6. Vérifiez que votre serveur valide correctement les signatures webhook.

5. Vérifier les limites de débit

Confirmez que votre intégration reste dans les limites de débit de l'API :

Zone	Limite
Suivi (POST /v1/clicks)	1 000 req/min par clé pk_*
API de conversion (POST /api/v1/conversions)	120 req/min par clé sk_*
API générale	300 req/min par adresse IP

Si vous prévoyez des volumes de trafic plus élevés, contactez le support avant de passer en production.

6. Vérifier les règles de commission

1. Allez dans Programmes > [Votre Programme] > Règles de commission.
2. Vérifiez que les pourcentages de commission, les montants fixes, les périodes de rétention et les paramètres d'approbation automatique sont corrects pour la production.
3. Si vous utilisez des commissions sur base nette (commission calculée après les frais Stripe), confirmez que votre compte Stripe live a la bonne structure de frais.

7. Tester le flux complet une dernière fois

Avant d'annoncer votre programme aux partenaires, parcourez le flux complet en mode live avec une vraie transaction (mais petite) :

1. Ouvrez votre lien de parrainage dans un navigateur.
2. Effectuez un vrai achat (vous pouvez le rembourser après).
3. Vérifiez que le clic, la conversion et la commission apparaissent dans le tableau de bord.
4. Vérifiez que les événements webhook ont été livrés à vos points de terminaison.
5. Remboursez la transaction dans Stripe et confirmez que l'événement commission.refunded se déclenche.

8. Activer votre programme

1. Définissez le statut de votre programme sur Actif dans le tableau de bord.
2. Partagez les liens d'invitation au programme ou l'URL du formulaire de candidature avec vos partenaires.
3. Surveillez le tableau de bord pour les premières vraies inscriptions de partenaires et conversions.

Surveillance après le lancement

Après le passage en production, surveillez :

• Journal de livraison webhook — vérifiez les livraisons échouées ou dead-letter
• Journal d'audit d'attribution — examinez les décisions d'attribution pour leur exactitude
• Alertes de fraude — surveillez les événements conversion.fraud_detected
• File de révision des commissions — approuvez ou rejetez les commissions nécessitant une révision manuelle (ex. commissions sur base nette signalées avec needs_review)