Passer au contenu principal

​
Introduction

Ce guide vous explique comment suivre les références d’affiliation, gérer les événements de commission et augmenter vos revenus grâce à des partenariats d’affiliation de confiance via Dodo Payments.

​
Fonctionnalités Clés

Attribution Automatisée des Commissions

Pas de tableurs ni de suivi manuel. Les références sont automatiquement attribuées et enregistrées lorsqu’un achat est effectué.

Rapports en Temps Réel

Vous et vos affiliés pouvez suivre les performances et les prospects depuis des tableaux de bord dédiés.

Options de Suivi Flexibles

Utilisez des scripts de suivi, des champs de métadonnées et des événements webhook pour capturer les données de référence lors des inscriptions et des transactions.

Entièrement Chiffré & Sécurisé

Toutes les informations sensibles et les données webhook sont échangées et stockées en toute sécurité grâce à un chiffrement de pointe.

Configuration Rapide

Lancez votre programme d’affiliation en quelques minutes—aucun changement de code requis en dehors du copier-coller de snippets de script et de tokens API.

Intégration Transparente

Intégrez le suivi des affiliés directement dans vos flux de paiement grâce à notre intégration avec Affonso, une plateforme de marketing d’affiliation de premier plan.

​
Étapes d’Intégration

Nous avons établi un partenariat avec Affonso, une plateforme de gestion d’affiliation de premier plan pour dynamiser vos ventes. Suivez les étapes ci-dessous pour connecter votre compte Dodo Payments avec Affonso et commencer à suivre les ventes générées par les affiliés.
1

Connectez-vous à Dodo Payments

Pour commencer, connectez votre compte Dodo Payments en ajoutant votre clé API.

​
Comment Obtenir Votre Clé API Dodo Payments

  • Connectez-vous à votre Tableau de Bord Dodo Payments
  • Allez dans la section Développeur dans le menu de gauche
  • Cliquez sur Clés API
  • Sélectionnez Ajouter une Clé API
  • Donnez-lui un nom (par exemple, “Intégration Affonso”)
  • Cliquez sur Créer et copiez votre clé API

​
Ajoutez Votre Clé API à Affonso

  • Ouvrez votre Tableau de Bord Affonso via affonso.io
  • Allez dans Détails du Programme > Connecter
  • Cliquez sur la carte intégration Dodo Payments
  • Collez votre clé API Dodo Payments
  • Cliquez sur Connecter
Votre clé API sera chiffrée en toute sécurité par Affonso.
2

Ajoutez un Webhook à Dodo Payments

Une fois connecté, vous recevrez une URL webhook unique d’Affonso. Cela permet le suivi des paiements et le déclenchement des commissions d’affiliation.

​
Ajoutez l’URL Webhook dans Dodo Payments

  • Dans votre Tableau de Bord Dodo Payments, allez dans Développeur → Webhooks
  • Cliquez sur Ajouter un Webhook
  • Collez votre URL webhook Affonso (depuis les paramètres de votre programme)
  • Enregistrez le webhook

​
Ajoutez le Secret Webhook dans Affonso

  • Après avoir enregistré le webhook dans Dodo Payments, copiez la clé de signature fournie
  • Collez-la de nouveau dans Affonso sous les paramètres webhook Dodo Payments
Cela permet à Affonso de vérifier en toute sécurité les événements entrants de Dodo Payments.
3

Ajoutez le Script de Suivi

Placez le pixel Affonso sur votre site pour commencer à suivre les visites et les conversions des affiliés.
<!-- Place in <head> tag -->
<script async defer
src="https://affonso.io/js/pixel.min.js"
data-affonso="YOUR_PUBLIC_PROGRAM_ID"
data-cookie_duration="YOUR_COOKIE_DURATION">
</script>
Ce script :
  • Suit les visites des affiliés
  • Définit un cookie avec l’ID de référence (affonso_referral)
  • Permet le suivi des inscriptions et des paiements
Placez ceci sur tous les domaines où les utilisateurs visitent ou convertissent (par exemple, site marketing, application).
4

Suivez les Inscriptions des Utilisateurs

Pour obtenir une visibilité sur le tunnel et optimiser les performances des affiliés, suivez les inscriptions des utilisateurs en tant que prospects.
// After successful registration
window.Affonso.signup(userEmail);
Cela permettra :
  • D’enregistrer une nouvelle référence en tant que PROSPECT si l’utilisateur est venu via un lien d’affiliation
  • De l’afficher dans votre tableau de bord et dans les statistiques de l’affilié
Meilleure pratique : Déclenchez ceci après une inscription réussie ou un double opt-in (DOI).
5

Transmettez les Données de Référence à Dodo Payments

Pour attribuer correctement les commissions, transmettez l’ID de référence d’Affonso à Dodo Payments lors du paiement.

​
Intégration des Paiements

import DodoPayments from 'dodopayments';

const referralId = window.affonso_referral;

const client = new DodoPayments({
  bearerToken: process.env['DODO_PAYMENTS_API_KEY'],
});

async function main() {
  const payment = await client.payments.create({
    payment_link: true,
    billing: { city: 'city', country: 'AF', state: 'state', street: 'street', zipcode: 0 },
    customer: { email: '[email protected]', name: 'name' },
    product_cart: [{ product_id: 'product_id', quantity: 0 }],
    metadata: {
      affonso_referral: referralId,
    },
  });

  console.log(payment.payment_id);
}

main();

​
Intégration des Abonnements

import DodoPayments from 'dodopayments';

const referralId = window.affonso_referral;

const client = new DodoPayments({
  bearerToken: process.env['DODO_PAYMENTS_API_KEY'],
});

async function main() {
  const subscription = await client.subscriptions.create({
    billing: { city: 'city', country: 'IN', state: 'state', street: 'street', zipcode: 89789 },
    customer: { customer_id: 'customer_id' },
    product_id: 'product_id',
    payment_link: true,
    return_url: 'https://example.com/success',
    quantity: 1,
    metadata: {
      affonso_referral: referralId,
    },
  });

  console.log(subscription.subscription_id);
}

main();

​
Liens de Paiement

// Original Dodo Payments Link
const originalLink = 'https://checkout.dodopayments.com/buy/<YOUR_PRODUCT_ID>';

// Append referral ID as reference_id
const linkWithReferral = `${originalLink}?metadata_affonso_referral=${window.affonso_referral}`;
Pour plus de détails, consultez la documentation API Dodo Payments
6

Tester Votre Intégration

Avant de lancer publiquement, testez votre configuration avec des liens d’affiliation en direct et des transactions de test.Liste de Vérification des Tests :
  • ✅ Créez un affilié et générez un lien de suivi
  • ✅ Visitez votre site via le lien d’affiliation
  • ✅ Assurez-vous que le script Affonso se charge et que le cookie affonso_referral est défini
  • ✅ Complétez une inscription (optionnel)
  • ✅ Complétez un paiement via Dodo Payments
  • ✅ Confirmez le suivi et l’attribution dans votre tableau de bord Affonso

​
Besoin d’Aide ?

Si vous rencontrez des problèmes ou avez besoin de support lors de l’intégration :

Support Affonso

Support Dodo Payments

Pour les requêtes API spécifiques à Dodo Payments, consultez docs.dodopayments.com ou contactez notre équipe de support.