Brancher votre SaaS en 20 minutes.
Quatre étapes pour que chaque vente apportée par un commercial lui soit attribuée automatiquement. Vous pouvez envoyer cette page telle quelle à votre développeur.
Comment ça marche
- Un prospect cliquesur le lien d'un commercial : saasdeal.fr/r/CODE
- Il arrive sur votre siteavec ?sd_click=… dans l'adresse : le traceur le mémorise
- Il paievotre serveur envoie la vente à SaaSDeal avec ce sd_click
- Vous validezla commission du commercial est calculée et facturée
Pas de développeur ? Passez directement à la méthode sans code.
Qui fait quoi, et où ?
| Élément | Qui s'en occupe | Où ça se met |
|---|---|---|
| Le lien d'affiliation | Les commerciaux — vous n'avez rien à faire | Généré sur SaaSDeal et partagé par le commercial (réseaux, e-mail, QR code). Il redirige vers l'adresse « Site web » de votre fiche produit. |
| Le traceur | Vous, une seule fois | Une ligne dans le <head> de votre site (étape 1). |
| L'appel d'API | Votre développeur | Dans le code serveur qui confirme les paiements : avec Stripe, votre webhook ; avec Paddle, Lemon Squeezy ou Chargebee, leur webhook de paiement (étape 4). |
| La validation | Vous | Votre espace éditeur SaaSDeal, « Ventes à valider » (étape 5). |
Rien n'est à modifier dans votre compte Stripe : vous continuez à encaisser vos clients comme aujourd'hui. Seul votre webhook envoie en plus une copie de chaque paiement à SaaSDeal.
Installer le traceur sur votre site
2 minutesCollez cette ligne dans le <head> de toutes les pages de votre site (au minimum la page d'accueil, celle vers laquelle pointent les liens SaaSDeal) :
<script src="https://saasdeal.fr/sd.js" async></script>- WordPress : extension « WPCode » → Header & Footer → coller dans « Header ».
- Shopify : Boutique en ligne → Thèmes → Modifier le code →
theme.liquid, avant</head>. - Webflow : Paramètres du projet → Custom code → Head code.
- Wix : Paramètres → Code personnalisé → Ajouter dans « Head », sur toutes les pages.
- React, Next.js, Vue… : ajoutez la balise dans votre template HTML principal.
Vérifier : ouvrez votre site avec ?sd_click=test à la fin de l'adresse, puis dans la console du navigateur tapez SaaSDeal.clickId() : la réponse doit être "test".
Conserver le clic quand le client s'inscrit
5 minutesLe traceur garde l'identifiant de clic dans un cookie sd_click sur votre propre domaine. Il faut l'enregistrer sur la fiche du client, pour le retrouver au moment de chaque paiement. Deux façons :
A. La plus simple : ajoutez deux champs cachés dans votre formulaire d'inscription ou de commande. Le traceur les remplit tout seul, vous n'avez qu'à enregistrer leur valeur avec le reste du formulaire.
<!-- Dans votre formulaire d'inscription ou de commande : -->
<input type="hidden" name="sd_click">
<input type="hidden" name="sd_ref">
<!-- Le traceur SaaSDeal les remplit automatiquement. Enregistrez ces valeurs
sur la fiche du client, dans votre base de données. -->Vous vendez avec des liens de paiement Stripe (buy.stripe.com/…) ? Rien à faire : le traceur ajoute automatiquement le clic à ces liens (paramètre client_reference_id), et Stripe le transmet à votre webhook.
B. Côté serveur : lisez directement le cookie sd_click dans la requête d'inscription (il est envoyé automatiquement, car il appartient à votre domaine).
Créer votre clé API et la tester
1 minuteDans votre espace éditeur, page Intégration, cliquez sur « Générer une clé API ». Copiez-la tout de suite : elle ne sera plus jamais affichée. Rangez-la dans une variable d'environnement de votre serveur (par exemple SAASDEAL_API_KEY), jamais dans le code du navigateur.
Testez-la :
curl https://saasdeal.fr/api/v1/ping -H "Authorization: Bearer VOTRE_CLE_API"La réponse doit contenir "ok": true et la liste de vos produits.
Déclarer chaque vente au moment du paiement
15 minutesÀ chaque paiement réussi d'un client venu par SaaSDeal, votre serveur envoie la vente. Si la commission de votre produit est récurrente, envoyez aussi chaque renouvellement (une vente par facture), pendant la durée que vous avez fixée.
| Champ | Obligatoire | Description |
|---|---|---|
click_id | l'un des deux | Valeur du cookie sd_click enregistrée à l'inscription (recommandé) |
ref | l'un des deux | Code du commercial (sd_ref), si vous n'avez pas le clic |
external_id | oui | Identifiant unique du paiement (n° de facture) : évite les doublons |
amount | oui | Montant hors taxes en euros (ex. 490.00) |
currency | non | eur (par défaut) |
// Dans le code de VOTRE webhook Stripe (côté serveur), en plus de votre logique actuelle.
// Le clic arrive dans client_reference_id :
// - Liens de paiement Stripe (buy.stripe.com) : le traceur SaaSDeal l'ajoute tout seul ;
// - Stripe Checkout par API : passez client_reference_id: req.cookies.sd_click
// dans stripe.checkout.sessions.create({ ... }).
async function declarer(body) {
await fetch("https://saasdeal.fr/api/v1/conversions", {
method: "POST",
headers: { Authorization: "Bearer " + process.env.SAASDEAL_API_KEY, "Content-Type": "application/json" },
body: JSON.stringify(body),
});
}
switch (event.type) {
// 1er paiement : déclarer la vente et mémoriser le clic sur l'abonnement
case "checkout.session.completed": {
const session = event.data.object;
const clickId = session.client_reference_id;
if (!clickId) break; // client non venu par SaaSDeal
if (session.subscription) {
await stripe.subscriptions.update(session.subscription, { metadata: { sd_click: clickId } });
}
await declarer({
click_id: clickId,
external_id: session.invoice ?? session.id,
amount: (session.amount_total - (session.total_details?.amount_tax ?? 0)) / 100, // HT
});
break;
}
// Renouvellements (si votre commission est récurrente)
case "invoice.paid": {
const invoice = event.data.object;
if (invoice.billing_reason !== "subscription_cycle") break; // le 1er paiement est déjà déclaré
const subId = invoice.parent?.subscription_details?.subscription ?? invoice.subscription;
const sub = subId ? await stripe.subscriptions.retrieve(subId) : null;
if (!sub?.metadata?.sd_click) break;
await declarer({
click_id: sub.metadata.sd_click,
external_id: invoice.id,
amount: (invoice.total_excluding_tax ?? invoice.amount_paid) / 100, // HT
});
break;
}
}| Réponse | Signification |
|---|---|
| 201 | Vente enregistrée, en attente de votre validation. La réponse contient la commission calculée. |
| 401 | Clé API absente, invalide ou révoquée. |
| 404 | Le clic ou le code ne correspond à aucun de vos produits. |
| 409 | Cette référence (external_id) a déjà été déclarée : sans danger, vous pouvez renvoyer sans risque de doublon. |
| 410 | Le clic est trop ancien (au-delà de la durée d'attribution de votre produit). |
| 422 | Données invalides : vérifiez le JSON envoyé (montant positif, external_id présent…). |
La commission n'est jamais envoyée par vous : SaaSDeal la calcule à partir du montant et des conditions de votre produit.
Valider les ventes
en continuChaque vente reçue apparaît dans votre espace éditeur, rubrique « Ventes à valider ». Validez-la (ou refusez-la en cas d'annulation, de remboursement ou de fraude) sous 30 jours. Seules les ventes validées donnent lieu à commission.
Sans développeur : la déclaration manuelle
- Installez quand même le traceur (étape 1) : il ajoute le code du commercial (
sd_ref) à l'adresse de votre page. Vous pouvez aussi simplement demander au client : « Qui vous a recommandé ? ». - Quand le client paie, ouvrez votre espace éditeur, encadré « Déclarer une vente », et saisissez le code du commercial, votre n° de facture et le montant HT.
- Validez la vente : c'est terminé.
Cookies et RGPD
Le cookie sd_click sert uniquement à attribuer la vente au bon commercial ; il est déposé sur votre domaine. Mentionnez-le dans votre politique cookies et, selon votre configuration, dans votre outil de recueil du consentement.