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 (HTTPS requis)	Livrés aux points de terminaison en mode live (HTTPS requis)
Limites de débit	Limites identiques dans les deux modes	Limites identiques dans les deux modes
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. Votre clé publique de test (pk_test_*) est affichée à côté de la clé live. Cliquez sur Générer la clé secrète en mode Test pour émettre sk_test_* : les clés secrètes sont créées à la demande, pas d’avance.

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://app.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.

Les points de terminaison webhook doivent utiliser HTTPS et être accessibles publiquement — mode test compris. Pour le développement local, exposez votre serveur local via un tunnel comme ngrok et enregistrez l'URL HTTPS du tunnel (p. ex. https://votre-tunnel.ngrok.app/webhooks/selgeo).

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

Lorsque vous connectez votre clé restreinte Stripe en mode test dans Paramètres > Stripe, Selgeo enregistre automatiquement le point de terminaison webhook de test — vous n'avez pas besoin de copier manuellement une URL webhook dans Stripe. Assurez-vous que la clé restreinte inclut l'autorisation webhook_endpoints:write.

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://app.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 quelles notifications auraient été envoyées, consultez le journal de notifications de test intégré à l'application (la boîte de réception de test) dans le tableau de bord.
• Quand vous êtes prêt, suivez la Checklist de mise en production pour passer en production.