Documentation éditeurs

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

  1. Un prospect clique
    sur le lien d'un commercial : saasdeal.fr/r/CODE
  2. Il arrive sur votre site
    avec ?sd_click=… dans l'adresse : le traceur le mémorise
  3. Il paie
    votre serveur envoie la vente à SaaSDeal avec ce sd_click
  4. Vous validez
    la 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émentQui s'en occupeOù ça se met
Le lien d'affiliationLes commerciaux — vous n'avez rien à faireGé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 traceurVous, une seule foisUne ligne dans le <head> de votre site (étape 1).
L'appel d'APIVotre développeurDans le code serveur qui confirme les paiements : avec Stripe, votre webhook ; avec Paddle, Lemon Squeezy ou Chargebee, leur webhook de paiement (étape 4).
La validationVousVotre 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.

1

Installer le traceur sur votre site

2 minutes

Collez 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) :

HTML
<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".

2

Conserver le clic quand le client s'inscrit

5 minutes

Le 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.

HTML
<!-- 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).

3

Créer votre clé API et la tester

1 minute

Dans 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
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.

4

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.

ChampObligatoireDescription
click_idl'un des deuxValeur du cookie sd_click enregistrée à l'inscription (recommandé)
refl'un des deuxCode du commercial (sd_ref), si vous n'avez pas le clic
external_idouiIdentifiant unique du paiement (n° de facture) : évite les doublons
amountouiMontant hors taxes en euros (ex. 490.00)
currencynoneur (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éponseSignification
201Vente enregistrée, en attente de votre validation. La réponse contient la commission calculée.
401Clé API absente, invalide ou révoquée.
404Le clic ou le code ne correspond à aucun de vos produits.
409Cette référence (external_id) a déjà été déclarée : sans danger, vous pouvez renvoyer sans risque de doublon.
410Le clic est trop ancien (au-delà de la durée d'attribution de votre produit).
422Donné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.

5

Valider les ventes

en continu

Chaque 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

  1. 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é ? ».
  2. 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.
  3. 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.