Skip to main content
Bring Your Own Processor (BYOP) collega il tuo account Stripe o Adyen a Dodo Payments. I pagamenti provenienti dai paesi che scegli vengono elaborati dal tuo account del processor, mentre Dodo Payments gestisce tutto ciò che riguarda la transazione: prodotti, abbonamenti, chiavi di licenza e il motore delle entitlements, fatturazione, il Customer Portal e le analisi. Per ogni paese del cliente, scegli chi elabora il pagamento: il tuo processor, che diventa il venditore legale per quella route, oppure Dodo Payments come Merchant of Record a servizio completo. I pagamenti provenienti dai paesi senza una route vengono inviati a Dodo Payments.

Route by Geography

Invia i pagamenti provenienti da paesi specifici al tuo processor e tutto il resto a Dodo Payments.

Keep Your Processor Accounts

Continua a utilizzare i tuoi account e le tue relazioni esistenti con Stripe o Adyen.

Stay the Merchant of Record

Sulle tue route, rimani il venditore legale e gestisci imposte, contestazioni e payout.

One Billing Layer

Dodo Payments gestisce prodotti, abbonamenti, fatture e analisi su entrambe le route.

​
BYOP vs. Dodo come Merchant of Record

I due modelli funzionano fianco a fianco. Ogni pagamento segue la route configurata per il paese del cliente. Per visualizzare questo confronto nella dashboard, seleziona Show Comparison in Settings → BYOP.
Una configurazione comune è ibrida: instrada verso il tuo processor un paese in cui disponi già di un’entità registrata e di un processor (ad esempio il tuo mercato nazionale), e lascia che Dodo Payments gestisca il resto del mondo come Merchant of Record.

​
Processor supportati

Puoi collegare Stripe e Adyen.

Stripe

Adyen

I pagamenti instradati tramite il tuo processor supportano solo carte di credito e debito.
Stripe e Adyen richiedono entrambi raw card API access sul tuo account, in modo che Dodo Payments possa eseguire la fatturazione sopra il tuo processor. Ogni processor abilita questa funzionalità su richiesta, quindi contatta il supporto del processor prima di effettuare il collegamento. La fase di collegamento della procedura guidata di configurazione mostra lo stesso requisito, con un link View documentation alle guide di Stripe e Adyen.

​
Configura BYOP

Per avviare la procedura guidata di configurazione, apri Settings → BYOP nella dashboard e seleziona Configure nella scheda Bring Your Own Processor.
Le connessioni vengono configurate per ambiente. Un processor collegato in modalità test (indicato come Sandbox) è separato da uno collegato in modalità live (indicata come Production). Per eseguire i test prima di andare in produzione, configura entrambi. La procedura guidata di configurazione utilizza la modalità impostata dall’interruttore Live Mode nella barra laterale.
Impostazioni BYOP che mostrano le opzioni Merchant of Record e Bring Your Own Processor con un confronto delle funzionalità
1

Choose a Payment Processor

In Select Payment Processor, seleziona Stripe o Adyen, quindi seleziona Continue.
Finestra Select Payment Processor con le opzioni Stripe e Adyen
2

Connect Your Account

Inserisci i dettagli della connessione, quindi seleziona Connect processor:
  • Processor Name: un nome per questa connessione, composto da 2–75 caratteri. Un nome è utile quando colleghi più account dello stesso processor, ad esempio Stripe US e Stripe UK.
  • Secret Key: la API key del processor per la modalità corrente. Per Stripe, si tratta della secret key sk_....
  • Merchant Account (solo Adyen): l’identificatore del merchant account Adyen.
Passaggio Connect Your Stripe Account con i campi per nome del processor, secret key, webhook endpoint e signing secret
Dodo Payments crea la connessione e mostra un URL Webhook Endpoint univoco. Aggiungi questo URL come destinazione webhook nella dashboard del processor. Quindi incolla il Webhook Signing Secret in Dodo Payments e seleziona Save & continue:
  • Stripe: il signing secret dell’endpoint webhook che hai aggiunto.
  • Adyen: la HMAC key da Customer Area → Webhooks.
Finché non salvi il signing secret, la connessione viene mostrata come Incomplete in Edit Configuration. Dopo averlo salvato, la connessione viene mostrata come Connected.
Dopo il collegamento, la secret key viene archiviata in modo sicuro e non può essere visualizzata o modificata. Anche il merchant account Adyen non può essere modificato dopo la configurazione. Nel tuo processor, configuri solo l’URL webhook generato da Dodo Payments; non interagisci mai direttamente con l’infrastruttura sottostante.
3

Configure Payment Routing

Aggiungi routing rules che associano i paesi dei clienti a un processor. Ogni paese viene instradato verso un solo processor:
  • Il tuo processor gestisce i pagamenti provenienti dai paesi che gli assegni.
  • Dodo Payments gestisce Rest of the World, ovvero ogni paese che non instradi, come Merchant of Record.
Passaggio Configure Payment Routing che mostra Stripe US instradato verso gli Stati Uniti e Dodo Payments come impostazione predefinita per il Rest of the World
Per assegnare uno o più paesi a un processor, seleziona Add Route, scegli il processor e seleziona i paesi. Un paese già instradato verso un altro processor non può essere aggiunto.
Pannello Add Route per selezionare un processor e i paesi
Linee guida per il routing
  • Rest of the World comprende ogni paese senza una route.
  • Le route di Dodo Payments come Merchant of Record gestiscono automaticamente conformità e imposte.
  • Le route sul tuo processor di pagamento richiedono una configurazione fiscale separata, se necessaria.
4

Configure Invoice Information

Per i pagamenti instradati tramite il tuo processor, tu sei il venditore indicato sulla fattura. Inserisci i dati aziendali per queste fatture:
  • Registered Business Name (obbligatorio).
  • Tax ID (EIN, SSN, ecc.) (facoltativo): 3–32 lettere, numeri o trattini. È disponibile la convalida del formato per gli EIN statunitensi.
  • Statement Descriptor (obbligatorio): ciò che i clienti visualizzano sull’estratto conto bancario. Usa da 5 a 22 lettere, numeri, spazi, _ o -.
  • Registered Business Address (obbligatorio): inizia a digitare per cercare il tuo indirizzo oppure inseriscilo manualmente.
  • Privacy Policy Link e Terms of Service Link (obbligatori).
L’Invoice Header Preview mostra come vengono visualizzati i dettagli. Questi dettagli si applicano solo alle fatture relative alle route gestite dal tuo processor. I pagamenti instradati verso Dodo Payments mantengono i dati Merchant of Record di Dodo Payments.
Passaggio Configure Invoice Information con dati aziendali e un'anteprima live dell'intestazione della fattura
5

Review and Finish

Esamina la connessione al processor, le routing rules e i dettagli delle fatture. Seleziona I confirm that the routing and billing details are correct, quindi seleziona Finish setup.
Passaggio Review Your Configuration che riepiloga i dati del processor, dell'instradamento e della fattura
Dopo la configurazione, la scheda Bring Your Own Processor mostra Edit Configuration, da cui puoi aggiungere processor e modificare routing e dettagli delle fatture. Per inviare nuovamente tutti i pagamenti tramite Dodo Payments come Merchant of Record, seleziona Edit routing rules, apri ogni route e disattiva Enable processor. I processor disattivati vengono ignorati durante il routing dei pagamenti e gli abbonamenti su un processor disattivato non possono rinnovarsi.
Impostazioni BYOP dopo la configurazione, con Edit Configuration e le opzioni di instradamento

​
Come funziona il routing

Dodo Payments sceglie la route in base al paese di fatturazione del cliente quando viene creato il pagamento. La stessa regola si applica ai pagamenti una tantum, alle checkout session e ai nuovi abbonamenti. I rinnovi riutilizzano il processor su cui è stato creato l’abbonamento (vedi Subscriptions). Su una route gestita dal tuo processor:
  • Il pagamento viene elaborato sul tuo account del processor, nella valuta di fatturazione.
  • Dodo Payments non calcola né riscuote le imposte. Sei responsabile delle imposte su quella route.
  • Le fatture mostrano i dati aziendali e lo statement descriptor che hai configurato, senza i dati Merchant of Record di Dodo Payments.
  • Il tuo processor ti accredita il pagamento direttamente. L’importo del pagamento non entra mai nel tuo saldo Dodo Payments; lì viene registrata solo la BYOP billing fee.
Su una route gestita da Dodo Payments (Rest of the World), Dodo Payments è il tuo Merchant of Record a servizio completo. Gestisce imposte, conformità, controlli antifrode e payout aggregati, e ti fornisce strumenti per prevenire e gestire le contestazioni. Il costo delle contestazioni relative a questi pagamenti è a tuo carico.

​
Abbonamenti

Un abbonamento rimane sul processor su cui è stato creato. Al rinnovo, Dodo Payments addebita lo stesso processor utilizzando il payment mandate memorizzato quando il cliente si è abbonato e non rivaluta le routing rules. Gli aggiornamenti del metodo di pagamento dell’abbonamento passano dallo stesso processor. Anche il fatto che Dodo Payments calcoli o meno le imposte su un abbonamento viene fissato al momento della sua creazione.

​
Visualizzare quale processor ha gestito un pagamento

Dopo aver configurato BYOP, le tabelle Payments e Disputes mostrano un’icona del processor (Stripe, Adyen o Dodo Payments) su ogni riga. Le pagine dei dettagli del pagamento e della contestazione aggiungono un campo Payment Processor, così puoi sapere quale route ha gestito una transazione.

​
Rimborsi, contestazioni e payout

Avvia i rimborsi dalla dashboard di Dodo come di consueto. Per un pagamento instradato tramite il tuo processor, Dodo Payments invia il rimborso a quel processor, che restituisce i fondi; il rimborso non utilizza il tuo saldo Dodo Payments. Per un pagamento instradato verso Dodo, Dodo Payments elabora il rimborso.

​
Analisi

Le analisi di ricavi, imposte e abbonamenti includono entrambe le route, così puoi visualizzare tutta la fatturazione in un unico posto. I widget relativi a contestazioni e payout mostrano solo l’attività elaborata da Dodo. L’attività sul tuo processor viene visualizzata anche nella dashboard di quel processor.

​
Billing Fee

Dodo Payments applica una BYOP billing fee su ogni pagamento instradato tramite il tuo processor, perché Dodo Payments continua a gestire prodotti, abbonamenti, fatturazione e analisi relativi a tali pagamenti. La tariffa predefinita è pari allo 0,5% dell’importo del pagamento equivalente in USD e la tariffa esatta viene confermata quando BYOP viene abilitato per il tuo account. La commissione appare come una voce byop_fee nel tuo ledger del saldo. Per discutere la tua tariffa, contatta il team.

​
Domande frequenti

Stripe e Adyen. Entrambi richiedono raw card API access sul tuo account, che devi richiedere al supporto del processor. Consulta le guide di Stripe e Adyen.
Sì. Assegna paesi specifici al tuo processor e lascia il resto come Rest of the World, che Dodo Payments gestisce come Merchant of Record. Ogni paese viene instradato verso un solo processor.
Sì. Sulle route gestite dal tuo processor, rimani il venditore legale e sei responsabile delle imposte, dei chargeback, della conformità PCI e dei payout relativi a tali transazioni.
No. Dodo Payments non calcola né riscuote le imposte sulle route gestite dal tuo processor; gestisci tu le imposte relative a tali transazioni. Dodo Payments continua a gestire le imposte sui pagamenti instradati verso Dodo Payments come Merchant of Record.
I rinnovi su quel processor non vanno a buon fine finché è disattivato, perché ogni abbonamento si rinnova sul processor su cui è stato creato. Questi rinnovi vengono visualizzati come pagamenti non riusciti nella dashboard.Dodo Payments mette inoltre in pausa le email di recupero dei pagamenti per questi abbonamenti. Riattiva il processor per ripristinare i rinnovi; i tentativi di recupero messi in pausa riprenderanno quindi.

​
Inizia

What is Merchant of Record?

Scopri come funziona il modello Merchant of Record a servizio completo di Dodo Payments.
Ultima modifica il 26 settembre 2026