Skip to main content

Introduzione

Gestisci un programma di affiliazione mentre Dodo Payments elabora le tue vendite. Una piattaforma di affiliazione monitora le visite generate dai referral, riceve gli eventi di pagamento da Dodo Payments tramite webhook e attribuisce ogni vendita all’affiliato che ha generato il referral. Dodo Payments si integra con tre piattaforme di affiliazione: Affonso, Dub Partners e Rekomi.

Caratteristiche Principali

Automated Commission Attribution

I referral vengono attribuiti e registrati automaticamente quando viene effettuato un acquisto, senza fogli di calcolo né monitoraggio manuale.

Real-Time Reporting

Tu e i tuoi affiliati potete monitorare le prestazioni e i lead da dashboard dedicate.

Opzioni di Tracciamento Flessibili

Utilizza script di tracciamento, campi di metadati e eventi webhook per catturare i dati di riferimento attraverso registrazioni e transazioni.

Encrypted Credentials and Signed Webhooks

Affonso crittografa la API key che gli fornisci e ogni evento webhook viene firmato, così la piattaforma può verificare che provenga da Dodo Payments.

Quick Setup

La configurazione richiede una API key, un webhook e uno script di tracking. L’unico codice che devi aggiungere è lo snippet dello script e i metadati del referral al checkout.

Checkout Integration

Aggiungi il tracking degli affiliati ai tuoi flussi di checkout con le integrazioni Affonso, Dub Partners e Rekomi.

Opzioni di integrazione

Dodo Payments si integra con queste piattaforme di gestione degli affiliati:
  • Affonso: una piattaforma di gestione degli affiliati con monitoraggio automatizzato delle commissioni, report in tempo reale e dashboard dedicate agli affiliati.
  • Dub Partners: gestione dei link e tracking delle conversioni di Dub, con analisi dell’attribuzione per ogni link di affiliazione.
  • Rekomi: una piattaforma di tracking e gestione degli affiliati con una connessione a Dodo Payments configurabile incollando una sola volta. Rekomi paga inoltre i tuoi affiliati e gestisce i relativi moduli fiscali.
Scegli la piattaforma più adatta al tuo programma oppure combinane diverse per casi d’uso differenti.

Integrazione con Affonso

Affonso è una piattaforma di gestione degli affiliati che collabora con Dodo Payments. Per collegare il tuo account Dodo Payments ad Affonso e iniziare a monitorare le vendite generate dagli affiliati, segui questi passaggi.
1

Connect with Dodo Payments

Per collegare il tuo account Dodo Payments, aggiungi una API key di Dodo Payments ad Affonso.

Come ottenere la tua chiave API di Dodo Payments

  1. Accedi alla dashboard di Dodo Payments.
  2. Vai a Developer → API Keys.
  3. Fai clic su Add API key.
  4. Inserisci un nome, ad esempio “Affonso Integration”.
  5. Fai clic su Create, quindi copia la tua API key. La dashboard mostra la chiave una sola volta.

Aggiungi la tua chiave API a Affonso

  1. Apri la dashboard di Affonso su affonso.io.
  2. Vai a Program Details > Connect.
  3. Fai clic sulla scheda di integrazione Dodo Payments.
  4. Incolla la tua API key di Dodo Payments.
  5. Fai clic su Connect.
Affonso crittografa la tua API key.
2

Add Webhook to Dodo Payments

Dopo il collegamento, Affonso ti fornisce un URL webhook univoco. Dodo Payments invia gli eventi di pagamento a questo URL e Affonso li utilizza per monitorare i pagamenti e attivare le commissioni degli affiliati.

Aggiungi l’URL Webhook in Dodo Payments

  1. Nella dashboard di Dodo Payments, vai a Developer → Webhooks.
  2. Fai clic su Add endpoint.
  3. Incolla l’URL webhook di Affonso dalle impostazioni del tuo programma Affonso.
  4. Fai clic su Create endpoint.

Aggiungi il Segreto Webhook in Affonso

  1. In Dodo Payments, apri l’endpoint che hai creato e copia il suo Signing secret.
  2. Incollalo in Affonso nelle impostazioni webhook di Dodo Payments.
Affonso utilizza il signing secret per verificare che gli eventi in ingresso provengano da Dodo Payments.
3

Add the Tracking Script

Per monitorare le visite e le conversioni degli affiliati, aggiungi il pixel Affonso al tuo sito. Sostituisci YOUR_PUBLIC_PROGRAM_ID con l’ID del tuo programma Affonso e YOUR_COOKIE_DURATION con la durata del cookie del referral.
Lo script:
  • Monitora le visite degli affiliati.
  • Imposta un cookie con l’ID del referral (affonso_referral) e lo espone come window.affonso_referral.
  • Abilita il tracking delle registrazioni e dei pagamenti.
Aggiungi lo script a ogni dominio in cui gli utenti visitano il sito o effettuano una conversione, ad esempio il tuo sito di marketing e la tua app.
4

Track User Signups

Per visualizzare l’intero funnel e migliorare le prestazioni degli affiliati, monitora le registrazioni degli utenti come lead.
Questa chiamata:
  • Registra un nuovo referral come LEAD se l’utente è arrivato tramite un link di affiliazione.
  • Mostra il lead nella tua dashboard e nelle statistiche dell’affiliato.
Eseguila dopo una registrazione completata o dopo il double opt-in (DOI).
5

Pass Referral Data to Dodo Payments

Per attribuire correttamente le commissioni, passa l’ID del referral Affonso a Dodo Payments al checkout come metadati affonso_referral. Leggi window.affonso_referral nel browser, quindi invialo al tuo server, dove è disponibile la tua API key.

Integrazione Pagamenti

Integrazione Abbonamenti

Per ulteriori dettagli, consulta la documentazione API di Dodo Payments.
6

Testing Your Integration

Prima del lancio pubblico, verifica la configurazione con link di affiliazione attivi e transazioni di test. Segui questa checklist:
  1. Crea un affiliato e genera un link di tracking.
  2. Visita il tuo sito tramite il link di affiliazione.
  3. Verifica che lo script Affonso venga caricato e imposti il cookie affonso_referral.
  4. Completa una registrazione (facoltativo).
  5. Completa un pagamento tramite Dodo Payments.
  6. Conferma il tracking e l’attribuzione nella dashboard di Affonso.

Integrazione con Dub Partners

Puoi utilizzare anche Dub Partners per monitorare i referral e le conversioni degli affiliati. Il tracking delle conversioni di Dub attribuisce le vendite ai tuoi link di affiliazione, così puoi vedere quali partner generano più ricavi.
Per istruzioni dettagliate sulla configurazione, consulta la guida all’integrazione di Dub. Spiega come monitorare gli eventi di conversione delle vendite e attribuire i ricavi ai tuoi link di affiliazione.

Configurazione Rapida con Dub Partners

  1. Abilita il tracking delle conversioni nella dashboard di Dub per i link di affiliazione.
  2. Acquisisci il click ID di Dub (cookie dub_id) quando crei le checkout session.
  3. Salva il click ID nei metadati del pagamento, insieme alle informazioni del cliente.
  4. Configura l’integrazione webhook per inviare i dati delle vendite a Dub quando i pagamenti hanno esito positivo.
L’integrazione monitora automaticamente questi eventi:
  • Pagamenti una tantum
  • Attivazioni degli abbonamenti
  • Pagamenti ricorrenti degli abbonamenti

Learn More

La guida completa all’integrazione di Dub, con esempi di codice e template di trasformazione.

Integrazione con Rekomi

Puoi utilizzare anche Rekomi per gestire il tuo programma di affiliazione end-to-end. Rekomi monitora click e conversioni, calcola le commissioni sull’importo della vendita al lordo delle imposte e paga i tuoi affiliati in oltre 130 paesi, inclusi i relativi moduli fiscali.
Per istruzioni dettagliate sulla configurazione, consulta la guida all’integrazione di Rekomi. La connessione richiede solo una API key incollata: Rekomi crea direttamente l’endpoint webhook nel tuo account Dodo Payments, quindi non è necessaria alcuna configurazione manuale del webhook.

Configurazione rapida con Rekomi

  1. Crea una API key nella dashboard di Dodo Payments in Developer → API Keys, con Enable write access attivato.
  2. Incolla la chiave in Rekomi: Rekomi la convalida e crea automaticamente l’endpoint webhook.
  3. Installa lo script di tracking di Rekomi sul tuo sito per acquisire i click degli affiliati.
  4. Passa il referral al checkout come metadati rekomi_ref oppure come parametro del payment link metadata_rekomi_ref.
L’integrazione monitora automaticamente questi eventi:
  • Pagamenti una tantum
  • Attivazioni e rinnovi degli abbonamenti
  • Rimborsi e contestazioni, con recupero automatico delle commissioni

Learn More

La guida completa all’integrazione di Rekomi, con esempi di codice per le checkout session e i payment link.

Hai bisogno di aiuto?

Se riscontri problemi durante l’integrazione, contatta la piattaforma interessata:

Affonso Support

Dub Support

Rekomi Support

Dodo Payments Support

Per domande sull’API di Dodo Payments, consulta il riferimento API oppure invia un’email a support@dodopayments.com.
Ultima modifica il 26 settembre 2026