Connecter une web app ou une application mobile

En bref : Votre serveur appelle l'API avec la clé du programme : inscription (lead), vente (sale), remboursement (refund), vérification d'un code promo (code). L'onglet Suivi des ventes fournit des consignes prêtes à coller dans Claude ou tout assistant de développement.

Le principe

Votre application conserve le code de l'affilié à l'arrivée du visiteur, l'enregistre sur le compte du client à l'inscription, puis votre serveur déclare chaque paiement. Tous les appels partent du serveur : la clé du programme ne doit jamais se trouver dans le navigateur ni dans l'application mobile.

La méthode rapide avec Claude

Dans l'onglet Suivi des ventes, partie Web app ou application, cliquez sur « Copier les consignes » et collez-les dans Claude ou votre assistant de développement. Elles contiennent l'identifiant et la clé de votre programme, et décrivent les étapes ci-dessous. Ne les partagez qu'avec votre outil ou votre développeur.

1. Récupérer le code de l'affilié

Le lien de l'affilié ajoute deux paramètres à l'adresse de destination : ba_ref (code de l'affilié) et ba_prog (identifiant du programme). Conservez ba_ref pendant la durée de suivi du programme. Sur une page web où le script est installé, BusinessAffiliation.ref() renvoie le code mémorisé.

2. L'API

Une seule adresse, affichée dans l'onglet : requête POST, corps JSON, en-tête X-BA-Key avec la clé du programme.

curl -X POST https://business-affiliation.com/api/postback \
  -H "Content-Type: application/json" \
  -H "X-BA-Key: CLE_DU_PROGRAMME" \
  -d '{"event":"test"}'

3. Déclarer l'inscription

À la création du compte ou de l'essai, si un code est connu :

{"event":"lead","email":"client@exemple.fr","ref":"CODE_AFFILIE"}

4. Déclarer chaque paiement

Pour chaque paiement encaissé (premier achat, échéance, renouvellement), idéalement dans le webhook de votre fournisseur de paiement. Exemple en JavaScript côté serveur :

await fetch('https://business-affiliation.com/api/postback', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json', 'X-BA-Key': process.env.BA_KEY },
  body: JSON.stringify({
    event: 'sale',
    order_id: payment.id,          // identifiant unique du paiement
    email: customer.email,
    amount: 97.00,                 // hors taxes, en euros
    currency: 'EUR',
    ref: user.affiliate_ref || undefined,
  }),
});

Sans ref, la vente est attribuée par l'email du client inscrit via le lien d'un affilié. Réutilisez toujours le même order_id pour un même paiement : les doublons sont ignorés.

5. Déclarer un remboursement

{"event":"refund","order_id":"<même identifiant que la vente>"}

Chaque affilié peut choisir un code promo personnel (par exemple LEA10) dans son espace. Si votre application propose un champ « code promo », vérifiez le code saisi puis transmettez-le comme ref :

{"event":"code","ref":"LEA10"}   →   {"ok":true,"valid":true}

Applications mobiles

Entre le clic et l'application, le passage par la boutique d'applications fait perdre le code. Trois solutions, à combiner :

Le code promo, saisi par le client à l'inscription ou au paiement : la plus simple et la plus fiable.
Le lien profond : si vous utilisez déjà un outil de liens profonds, récupérez ba_ref à l'ouverture de l'application.
L'email : si le client s'est inscrit sur une page web avec le même email avant de télécharger l'application, la vente lui est attribuée.

Paiements par Stripe

Si votre application encaisse avec Stripe, le connecteur Stripe transmet les paiements sans code supplémentaire : transmettez simplement le code de l'affilié dans client_reference_id quand vous créez une session Stripe Checkout.

Réponses

200 avec {"ok":true,...} ; 401 si la clé est fausse ; 400 si un champ obligatoire manque. Chaque appel apparaît dans le journal « Derniers événements reçus ».

Autres articles : Faire vérifier son entreprise · Créer et publier un programme · Brancher le suivi des ventes · Connecter Systeme.io · Connecter Stripe · Connecter WordPress et WooCommerce · Connecter PayPal · Connecter ClickFunnels 2.0 · Learnybox, Alma, Zapier, Make et autres outils · Importer des ventes depuis un fichier · Paiement en plusieurs fois : les commissions · Tester le suivi sans vente réelle · Examiner les ventes signalées · Payer ses affiliés · Les paliers de commission · Annoncer un lancement · Organiser challenges et missions · Recruter des affiliés · Messagerie et annonces à vos affiliés · Le Studio IA pour les vendeurs