> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Affiliés

> Lancez et gérez votre programme d'affiliation tout en traitant les transactions via Dodo Payments.

## 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. Nous proposons des intégrations avec des plateformes d'affiliation de premier plan, notamment **Affonso** et **Dub Partners**, pour vous aider à gérer et suivre vos programmes d'affiliation sans effort.

## Fonctionnalités Clés

<CardGroup cols={2}>
  <Card title="Automated Commission Attribution" icon="robot">
    Plus besoin de feuilles de calcul ni de suivi manuel. Les parrainages sont automatiquement attribués et enregistrés lorsqu’un achat est effectué.
  </Card>

  <Card title="Real-Time Reporting" icon="chart-line">
    Vous et vos affiliés pouvez suivre les performances et les prospects à partir de tableaux de bord dédiés.
  </Card>

  <Card title="Flexible Tracking Options" icon="code">
    Utilisez des scripts de suivi, des champs de métadonnées et des événements webhook pour capturer les données de parrainage lors des inscriptions et des transactions.
  </Card>

  <Card title="Fully Encrypted & Secure" icon="shield">
    Toutes les informations d’identification sensibles et les données webhook sont échangées et stockées de manière sécurisée avec un chiffrement de pointe.
  </Card>

  <Card title="Quick Setup" icon="bolt">
    Lancez votre programme d’affiliation en quelques minutes : aucun changement de code n’est requis au-delà du simple copier-coller des extraits de script et des jetons API.
  </Card>

  <Card title="Seamless Integration" icon="plug">
    Intégrez le suivi des affiliés directement dans vos flux de paiement grâce à nos intégrations avec Affonso et Dub Partners, des plateformes leaders du marketing d’affiliation.
  </Card>
</CardGroup>

## Options d'intégration

Dodo Payments s'intègre à deux plateformes de gestion d'affiliation de premier plan :

* **[Affonso](https://affonso.io)** : Une plateforme complète de gestion d'affiliation avec suivi automatisé des commissions, reporting en temps réel et tableaux de bord dédiés aux affiliés.
* **[Dub Partners](https://dub.co)** : Utilisez la gestion des liens et le suivi des conversions de Dub pour alimenter votre programme d'affiliation avec des analyses d'attribution détaillées.

Choisissez la plateforme qui correspond le mieux à vos besoins, ou utilisez les deux pour différents cas d'utilisation.

## Intégration Affonso

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.

<Frame>
  <iframe className="w-full aspect-video rounded-md" src="https://www.youtube.com/embed/8tw8o9yOjsA" title="Affiliate Integration | Dodo Payments" frameBorder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />
</Frame>

<Steps>
  <Step title="Connect with 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](https://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**

    <Callout type="info">
      Votre clé API sera chiffrée en toute sécurité par Affonso.
    </Callout>
  </Step>

  <Step title="Add Webhook to Dodo Payments">
    Une fois connecté, vous recevrez une URL webhook unique d’Affonso. Cela permet de suivre les paiements et de déclencher les commissions d’affiliation.

    ### Ajoutez l'URL du Webhook dans Dodo Payments

    * Dans votre Tableau de bord Dodo Payments, allez dans **Développeur → Webhooks**
    * Cliquez sur **Ajouter un Webhook**
    * Collez votre **URL de webhook Affonso** (à partir des paramètres de votre programme)
    * Enregistrez le webhook

    ### Ajoutez le secret du Webhook dans Affonso

    * Après avoir enregistré le webhook dans Dodo Payments, **copiez la clé de signature** fournie
    * Collez-la à nouveau dans Affonso sous les **paramètres de webhook Dodo Payments**

    <Callout type="info">
      Cela permet à Affonso de vérifier en toute sécurité les événements entrants de Dodo Payments.
    </Callout>
  </Step>

  <Step title="Add the Tracking Script">
    Placez le pixel Affonso sur votre site pour commencer à suivre les visites et conversions d’affiliés.

    ```html theme={null}
    <!-- 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 parrainage (`affonso_referral`)
    * Active le suivi des inscriptions et des paiements

    <Callout type="info">
      Placez ceci sur tous les domaines où les utilisateurs visitent ou convertissent (par ex. site marketing, application).
    </Callout>
  </Step>

  <Step title="Track User Signups">
    Pour obtenir une visibilité sur l’entonnoir et optimiser les performances des affiliés, suivez les inscriptions des utilisateurs en tant que prospects.

    ```js theme={null}
    // After successful registration
    window.Affonso.signup(userEmail);
    ```

    Cela permettra :

    * D'enregistrer une nouvelle référence en tant que **LEAD** 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é

    <Callout type="info">
      Bonne pratique : déclenchez ceci après une inscription réussie ou une double confirmation (DOI).
    </Callout>
  </Step>

  <Step title="Pass Referral Data to Dodo Payments">
    Pour attribuer correctement les commissions, transmettez l’ID de parrainage d’Affonso à Dodo Payments lors du passage en caisse.

    ### Intégration des paiements

    ```js theme={null}
    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@email.com', name: 'name' },
        product_cart: [{ product_id: 'product_id', quantity: 0 }],
        metadata: {
          affonso_referral: referralId,
        },
      });

      console.log(payment.payment_id);
    }

    main();
    ```

    ### Intégration des abonnements

    ```js theme={null}
    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

    ```js theme={null}
    // 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}`;
    ```

    <Callout type="info">
      Pour plus de détails, consultez la [documentation de l’API Dodo Payments](https://docs.dodopayments.com/api-reference/introduction)
    </Callout>
  </Step>

  <Step title="Testing Your Integration">
    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
    * ✅ Finalisez une inscription (facultatif)
    * ✅ Effectuez un paiement via Dodo Payments
    * ✅ Confirmez le suivi et l’attribution dans votre tableau de bord Affonso
  </Step>
</Steps>

## Intégration Dub Partners

Vous pouvez également utiliser [Dub Partners](https://dub.co) pour suivre les références et les conversions des affiliés. La fonctionnalité de suivi des conversions de Dub vous permet d'attribuer des ventes à vos liens d'affiliation, fournissant des analyses détaillées sur les partenaires qui génèrent le plus de revenus.

<Info>
  Pour des instructions détaillées de configuration, consultez notre [guide d’intégration Dub](/integrations/dub) qui explique comment suivre les événements de conversion de vente et attribuer les revenus à vos liens d’affiliation.
</Info>

### Configuration rapide avec Dub Partners

1. **Activez le suivi des conversions** dans votre tableau de bord Dub pour les liens d’affiliation
2. **Capturez l’ID de clic Dub** (`dub_id` cookie) lors de la création des sessions de paiement
3. **Stockez l’ID de clic** dans les métadonnées de paiement avec les informations client
4. **Configurez l’intégration webhook** pour envoyer les données de vente à Dub lorsque les paiements réussissent

L'intégration suit automatiquement :

* Les paiements uniques
* Les activations d'abonnement
* Les paiements d'abonnement récurrents

<Card title="Learn More" icon="book" href="/integrations/dub">
  Consultez le guide d’intégration Dub complet avec des exemples de code et des modèles de transformation.
</Card>

## Besoin d'aide ?

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

<CardGroup cols={2}>
  <Card title="Affonso Support" icon="headset">
    * Discutez avec nous via le **chat en direct** sur [affonso.io](https://affonso.io/)
    * Envoyez-nous un e-mail à **[support@affonso.io](mailto:support@affonso.io)**
  </Card>

  <Card title="Dub Support" icon="headset">
    * Consultez la [documentation Dub](https://dub.co/docs) pour les guides de suivi des conversions
    * Contactez le support Dub via leur [tableau de bord](https://app.dub.co)
  </Card>

  <Card title="Dodo Payments Support" icon="headset">
    Pour les questions spécifiques à l’API Dodo Payments, référez-vous à docs.dodopayments.com ou contactez notre équipe de support.
  </Card>

  <Card title="Integration Guides" icon="book">
    * [Intégration Affonso](#affonso-integration) (ci-dessus)
    * [Intégration Dub Partners](/integrations/dub)
  </Card>
</CardGroup>