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

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. Vérifiez le point de terminaison webhook Stripe. Selgeo fournit une URL webhook qui doit être enregistrée dans votre tableau de bord Stripe sous Développeurs > Webhooks pour votre mode live. Assurez-vous que les événements suivants sont activés :
   • checkout.session.completed
   • invoice.paid
   • charge.refunded
4. Envoyez un événement de test depuis le tableau de bord webhook Stripe et confirmez qu'il apparaît dans le journal de livraison Selgeo.

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)