Mode test

Selgeo fournit un environnement de test complet pour que vous puissiez vérifier votre intégration de bout en bout sans traiter de vrais paiements ni envoyer d'emails à de vrais partenaires. Toutes les fonctionnalités du mode test utilisent l'API version v1.

Comparaison test vs. live

Aspect	Mode test	Mode live
Clés API	pk_test_*, sk_test_*	pk_live_*, sk_live_*
Données	Complètement isolées — les données de test n'apparaissent jamais dans les rapports live	Données de production
Stripe	Se connecte à votre environnement Stripe de test	Se connecte à votre environnement Stripe live
Emails	Supprimés — aucun email n'est envoyé aux partenaires ou marchands	Les emails sont livrés normalement
Webhooks	Livrés aux points de terminaison en mode test (HTTP autorisé)	Livrés aux points de terminaison en mode live (HTTPS requis)
Limites de débit	Mêmes limites que le mode live	Mêmes limites que le mode test
Détection de fraude	Active — mêmes règles que le mode live	Active
Effacement RGPD	Entièrement fonctionnel	Entièrement fonctionnel

Isolation des données

Les modes test et live sont entièrement séparés. Les partenaires, clics, conversions, commissions et points de terminaison webhook créés en mode test sont invisibles en mode live, et vice versa. Vous pouvez exécuter des scénarios de test librement sans affecter les données de production.

Obtenir vos clés de test

1. Connectez-vous au tableau de bord marchand Selgeo.
2. Naviguez vers Paramètres > Clés API.
3. Vos clés de test (pk_test_* et sk_test_*) sont affichées à côté de vos clés live.

Cycle de test étape par étape

Suivez ce guide pour vérifier le flux d'attribution complet : clic, attribution, conversion et commission.

Étape 1 — Installer le snippet avec votre clé publique de test

Ajoutez le snippet de suivi Selgeo à une page de test sur votre site (ou un environnement de développement local). Utilisez votre clé publique de test :

<script
  src="https://cdn.selgeo.com/v1/selgeo.js"
  data-merchant="pk_test_YOUR_KEY"
  async
></script>

Étape 2 — Créer un partenaire de test

Dans le tableau de bord, créez un programme de test (ou utilisez-en un existant) et ajoutez un partenaire de test. Notez l'URL du lien de parrainage ou de suivi du partenaire. Elle ressemble à ceci :

https://votresite.com/?ref=abc123

Étape 3 — Simuler un clic

Ouvrez le lien de parrainage dans votre navigateur. Le snippet Selgeo capture le clic et crée une attribution en attente. Vous pouvez vérifier cela dans le tableau de bord sous Analytics > Clics.

Le snippet stocke un click_id qui lie ce visiteur au partenaire référent.

Étape 4 — Signaler une conversion de test

Après le clic simulé, déclenchez une conversion. La méthode dépend de votre intégration :

Stripe Checkout

Complétez un paiement Stripe de test en utilisant une carte de test Stripe (ex. 4242 4242 4242 4242). Selgeo reçoit le webhook Stripe et crée automatiquement la conversion.

API de conversion

Envoyez une conversion directement via l'API en utilisant votre clé secrète de test :

curl -X POST https://api.selgeo.com/api/v1/conversions \
  -H "Authorization: Bearer sk_test_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "click_id": "LE_CLICK_ID_DE_LETAPE_3",
    "event_type": "purchase",
    "external_transaction_id": "test_txn_001",
    "amount_cents": 9900,
    "currency": "EUR"
  }'

Étape 5 — Vérifier la conversion et la commission

1. Allez à la page Analytics dans le tableau de bord. Vous devriez voir la conversion enregistrée.
2. Naviguez vers Commissions. Une commission devrait avoir été calculée en fonction des règles de commission de votre programme.
3. Si vos règles de commission incluent une période de rétention, la commission sera dans un état en attente. Elle sera automatiquement approuvée une fois la période de rétention écoulée.

Étape 6 — Tester les webhooks

Si vous avez des points de terminaison webhook enregistrés en mode test, vérifiez le journal de livraison dans Paramètres > Webhooks. Vous devriez voir des livraisons pour les événements conversion.created et commission.created.

Pour le développement local, vous pouvez enregistrer un point de terminaison HTTP (ex. http://localhost:3000/webhooks/selgeo). Utilisez un outil comme ngrok pour exposer votre serveur local si vous ne travaillez pas sur une URL accessible publiquement.

Environnement de test Stripe

Selgeo se connecte à votre environnement de test Stripe lorsqu'il opère en mode test. Cela signifie :

• Les numéros de carte de test fonctionnent comme prévu (ex. 4242 4242 4242 4242 pour un paiement réussi)
• Les remboursements de test déclenchent des événements commission.refunded
• Les abonnements de test génèrent des événements de conversion récurrents
• Les webhooks Stripe de votre environnement de test sont traités et attribués normalement

Assurez-vous que votre point de terminaison webhook Stripe en mode test est configuré dans Stripe pour envoyer des événements à Selgeo. Le tableau de bord Selgeo affiche l'URL exacte du webhook Stripe à utiliser sous Paramètres > Stripe.

Numéros de carte de test Stripe

Numéro de carte	Comportement
4242 4242 4242 4242	Réussit
4000 0000 0000 3220	Requiert l'authentification 3D Secure
4000 0000 0000 0002	Refusé (card_declined)

Voir la documentation de test Stripe pour la liste complète.

Réinitialisation des données de test

Quand vous voulez repartir de zéro, utilisez le bouton Réinitialiser les données de test dans le tableau de bord Selgeo (page Paramètres, mode test). Cela supprime toutes les données en mode test pour votre workspace en une action :

• Partenaires et participants
• Clics et événements d'attribution
• Conversions et commissions
• Journaux de livraison webhook
• Journaux de notification

Vous pouvez aussi réinitialiser programmatiquement via l'API :

curl -X DELETE https://api.selgeo.com/api/v1/workspace/test-data \
  -H "Authorization: Bearer VOTRE_JWT_TOKEN"

attention

Cette action est irréversible. Toutes les données en mode test seront définitivement supprimées.

Conseils

• Réinitialiser régulièrement les données de test. Utilisez le bouton de réinitialisation ou le point de terminaison API ci-dessus pour repartir de zéro plutôt que de nettoyer manuellement des enregistrements individuels.
• Tester les webhooks tôt. Configurez des points de terminaison webhook en mode test avant de passer en production. Vérifiez que votre serveur gère tous les types d'événements dont vous avez besoin.
• Tester les cas limites. Essayez des scénarios comme les fenêtres d'attribution expirées, les conversions en double, les remboursements et les partenaires suspendus pour vous assurer que votre intégration les gère correctement.
• Vérifier la suppression des emails. Rappelez-vous qu'aucun email n'est envoyé en mode test. Si vous avez besoin de vérifier les templates d'email, consultez le tableau de bord de la file BullMQ (si disponible dans votre environnement) pour voir les tâches de notification en file d'attente.
• Quand vous êtes prêt, suivez la Checklist de mise en production pour passer en production.