Impostazione Multi-Brand

Introduzione

Multi-Brand ti consente di collegare diversi marchi, ognuno con il proprio logo, descrizione e URL del sito web, a una sola attività verificata. Il tuo conto di pagamento, le commissioni e il KYC restano esattamente gli stessi, mentre ogni Prodotto, Link di Pagamento, Abbonamento, Fattura e Transazione possono ora essere archiviati sotto un marchio specifico. Usalo per testare nuove nicchie, localizzare un sito o separare le linee B2B e B2C senza aprire conti aziendali aggiuntivi.

Flusso della Dashboard del Merchant

Open Settings → Business

Naviga su Impostazioni → Attività. Il pannello Marche sotto [La tua Attività] a destra elenca il tuo marchio Primario e eventuali marchi Secondari.

Pannello dei marchi nelle Impostazioni Attività che mostra marchi primari e secondari con un pulsante più per aggiungere un nuovo marchio

Click the '+' button

Nel pannello delle Marche, clicca sul pulsante + in alto a destra per aprire il modulo del nuovo marchio.

Fill in the brand details

Compila i seguenti campi:

Nome del Marchio (obbligatorio): Inserisci il nome del tuo marchio.
URL del sito web (obbligatorio): Il sito web del tuo marchio, per esempio https://www.yourcompany.com.
Email di Supporto: L’email che i clienti possono usare per contattare il supporto per questo marchio.
Descrizione del Marchio (obbligatorio): Descrivi il tuo marchio, i prodotti e cosa lo rende unico.
Logo del Marchio: Carica un logo per rappresentare il marchio durante il checkout, sulle fatture e nei link di pagamento.

Invia il modulo per creare il marchio. I prodotti possono ora essere associati a questo marchio e i link di pagamento mostreranno il suo branding.

Brand Selector

Un filtro per i Marchi è ora visibile nella creazione dei Prodotti.

Brand ID in Transactions

Le Transazioni e gli Abbonamenti hanno un ID Marchio per aiutarti a identificare a quale marchio appartiene la transazione.

Punti Aggiuntivi

Nessuna modifica ai payout: tutti i fondi, i cicli di payout e le commissioni continuano a confluire nel wallet a livello business e nel conto bancario del merchant.
Brand ID nei webhook: tutti i payload relativi a pagamenti, abbonamenti, rimborsi, contestazioni, chiavi di licenza, voci del registro dei crediti, saldo dei crediti basso, concessioni di entitlement, tentativi di recupero e checkout abbandonati includono un brand_id, così puoi attribuirli a uno specifico brand. Quando un’entità non ha un brand proprio, brand_id utilizza il brand principale del business. I payload dei payout sono a livello business e non includono un brand_id.
Sospensioni: se un brand viene sospeso, vengono disattivati solo i suoi link di pagamento. Gli altri brand dello stesso business continuano a effettuare transazioni.
Nessuna modifica a Storefront, Invoices, License Keys, Discount Codes, Payout Settings e a tutte le altre funzionalità a livello business.

Archiviare un brand

Quando un brand ha terminato il suo percorso, archivialo invece di lasciarlo inattivo nella dashboard. L’archiviazione dismette il brand e trasferisce il suo catalogo a un altro brand della stessa attività in un unico passaggio.

L’archiviazione di un brand è permanente. Non è possibile ripristinare un brand archiviato.

Archiviare un brand dalla dashboard

Open the brand's actions menu

Vai a Settings → Business. Nel pannello Brands Under [Your Business], seleziona il menu ... accanto al brand secondario, quindi seleziona Archive. Il brand principale non dispone dell’azione di archiviazione.

Confirm the archive

Leggi l’avviso e seleziona Continue.

Choose the brand that takes over

Seleziona il brand che riceverà i prodotti, le sottoscrizioni attive e le raccolte. Il brand principale è quello predefinito. Seleziona Move & Archive per completare entrambe le azioni insieme.

Check the result

La conferma indica il brand che ha ricevuto i record.

Il brand archiviato scompare dal pannello Brands. Quando l’attività non ha altri brand secondari, anche il gruppo Secondary Brands scompare.

Cosa succede quando archivi un brand

Indichi un brand di destinazione che subentri al brand che stai archiviando. La dashboard lo richiede sempre, mentre l’API lo accetta come move_products_to. Con un’unica azione atomica, Dodo Payments:

Trasferisce ogni prodotto al brand di destinazione.
Trasferisce ogni sottoscrizione attiva al brand di destinazione, in modo che i rinnovi continuino a essere addebitati a suo nome.
Trasferisce ogni raccolta di prodotti al brand di destinazione.
Archivia e disabilita il brand originale.

La cronologia non viene modificata. I pagamenti, le fatture e le sottoscrizioni concluse mantengono il brand con cui sono state create, così i report passati rimangono accurati. Il brand di destinazione deve appartenere alla stessa attività e non deve essere a sua volta archiviato. Il brand principale è una destinazione valida e il suo ID brand corrisponde all’ID della tua attività. Puoi omettere la destinazione solo quando il brand non contiene prodotti, sottoscrizioni attive o raccolte di prodotti.

Il brand principale non può mai essere archiviato. È il brand di fallback della tua attività, quindi rimane sempre almeno un brand.

Un brand archiviato è di sola lettura

Azione	Risultato
Modifica dei dettagli del brand	Rifiutata con `BRAND_ARCHIVED`
Invio del brand per la verifica	Rifiutato con `BRAND_ARCHIVED`
Creazione di un prodotto o di una raccolta per il brand	Rifiutata con `BRAND_ARCHIVED`
Creazione di una sottoscrizione per uno dei suoi prodotti	Rifiutata con `BRAND_ARCHIVED`

I brand archiviati sono nascosti dai selettori dei brand, quindi non puoi associare nuovi record a questi brand. Rimangono disponibili come filtri di analytics, così i report per brand restano completi per il periodo in cui il brand era operativo. Consulta Analytics.

Archiviare tramite l’API

Chiama l’endpoint di archiviazione indicando il brand che stai dismettendo e il brand che subentra:

const response = await client.brands.archive('brnd_8dFiAW42v28JzhlVSocjq', {
  move_products_to: 'brnd_pRQ2zXk91mNvBcTgLwHsA',
});

console.log(response.products_moved);

response = client.brands.archive(
    id="brnd_8dFiAW42v28JzhlVSocjq",
    move_products_to="brnd_pRQ2zXk91mNvBcTgLwHsA",
)
print(response.products_moved)

curl -X POST https://live.dodopayments.com/brands/brnd_8dFiAW42v28JzhlVSocjq/archive \
  -H "Authorization: Bearer $DODO_PAYMENTS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"move_products_to": "brnd_pRQ2zXk91mNvBcTgLwHsA"}'

La risposta indica cosa è stato trasferito, così puoi confermare il risultato:

{
  "brand_id": "brnd_8dFiAW42v28JzhlVSocjq",
  "archived_at": "2026-08-17T11:20:05Z",
  "moved_to_brand_id": "brnd_pRQ2zXk91mNvBcTgLwHsA",
  "products_moved": 12,
  "subscriptions_moved": 3,
  "collections_moved": 1
}

Per elencare i brand, inclusi quelli archiviati, imposta include_archived sull’endpoint di elenco. I brand archiviati sono esclusi per impostazione predefinita. Ogni brand include un campo archived_at, che è null quando il brand è attivo.

cURL

curl "https://live.dodopayments.com/brands?include_archived=true" \
  -H "Authorization: Bearer $DODO_PAYMENTS_API_KEY"

Consulta il riferimento API Archive Brand per lo schema completo della richiesta e della risposta, e Error Codes per gli errori restituiti da questo endpoint.

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Introduzione

Flusso della Dashboard del Merchant

Punti Aggiuntivi

Archiviare un brand

Archiviare un brand dalla dashboard

Cosa succede quando archivi un brand

Un brand archiviato è di sola lettura

Archiviare tramite l’API

​Introduzione

​Flusso della Dashboard del Merchant

​Punti Aggiuntivi

​Archiviare un brand

​Archiviare un brand dalla dashboard

​Cosa succede quando archivi un brand

​Un brand archiviato è di sola lettura

​Archiviare tramite l’API

Introduzione

Flusso della Dashboard del Merchant

Punti Aggiuntivi

Archiviare un brand

Archiviare un brand dalla dashboard

Cosa succede quando archivi un brand

Un brand archiviato è di sola lettura

Archiviare tramite l’API