Impostazione Multi-Brand

​

Introduzione

​

Flusso nel Merchant Dashboard

1

Open Settings → Business

Vai a Settings → Business. Il pannello Brands Under [Your Business] elenca il tuo Primary Brand e gli eventuali Secondary Brands.

2

Click the + Button

Nel pannello Brands, fai clic sul pulsante + nell’angolo in alto a destra per aprire il modulo per un nuovo brand.

3

Fill In the Brand Details

Compila i seguenti campi:

• Brand Name (obbligatorio): almeno 2 caratteri e diverso dai nomi degli altri brand.
• Support Email: l’indirizzo che i clienti usano per contattare il supporto di questo brand.
• Brand Description (obbligatorio): almeno 10 caratteri. Descrivi il brand, i suoi prodotti e ciò che lo distingue.
• Brand Logo: rappresenta il brand durante il checkout, nelle fatture e nei link di pagamento. I formati accettati sono PNG, JPEG, GIF, WebP, ICO e SVG. Qualsiasi altro formato viene rifiutato con un errore 422.

Fai clic su Add brand per creare il brand. Potrai quindi assegnargli dei prodotti e i relativi link di pagamento mostreranno il suo branding. Per impostare lo statement descriptor o modificare in seguito altri dettagli, apri il menu ... del brand e seleziona Edit.

4

Select the Brand on Products

Quando crei un prodotto, scegli il relativo brand nel campo Brand.

5

Find the Brand ID in Transactions

Le transazioni e gli abbonamenti mostrano un Brand ID, così puoi sapere a quale brand appartiene ciascuno di essi.

​

Informazioni aggiuntive

• Nessuna modifica ai payout: i fondi, i cicli di payout e le commissioni restano a livello dell’attività e confluiscono nel wallet dell’attività e nel tuo conto bancario.
• Brand ID nei webhook: i payload relativi a pagamenti, abbonamenti, rimborsi, chiavi di licenza, voci del registro dei crediti, saldo crediti basso, concessioni di entitlement, tentativi di recupero crediti e checkout abbandonati includono un brand_id, così puoi attribuire ogni evento a un brand. Quando un’entità non ha un brand proprio, brand_id è il brand principale dell’attività. I payload delle contestazioni non contengono brand_id, quindi usa il loro payment_id per trovare il brand associato al pagamento. I payload dei payout sono a livello dell’attività e non contengono brand_id.
• Sospensioni: se un brand viene sospeso, non può accettare nuovi pagamenti, sessioni di checkout o abbonamenti. Gli altri brand della stessa attività continuano a effettuare transazioni.
• Fatture: ogni fattura mostra il nome e il logo del brand a cui appartiene il pagamento.
• Storefront, chiavi di licenza, codici sconto, impostazioni dei payout e altre funzionalità a livello dell’attività funzionano allo stesso modo che con un singolo brand.

​

Archiviazione di un brand

​

Archiviare un brand dal dashboard

1

Open the Brand's Actions Menu

Vai a Settings → Business. Nel pannello Brands Under [Your Business], apri il menu ... accanto al brand secondario e seleziona Archive. Il brand primario non dispone dell’opzione Archive.

2

Confirm the Archive

Leggi l’avviso e seleziona Continue.

3

Choose the Brand That Takes Over

In Move products to, seleziona il brand che riceverà i prodotti, gli abbonamenti attivi e le raccolte. Il brand primario è quello predefinito. Seleziona Move & Archive per spostare i record e archiviare il brand con un’unica azione.

4

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

• Sposta ogni prodotto al brand di destinazione.
• Sposta ogni abbonamento attivo al brand di destinazione, così i rinnovi vengono addebitati a quest’ultimo.
• Sposta ogni raccolta di prodotti al brand di destinazione.
• Archivia e disabilita il brand originale.

​

Un brand archiviato è di sola lettura

​

Archiviazione tramite API

import DodoPayments from 'dodopayments';

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

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

console.log(response.products_moved);

import os
from dodopayments import DodoPayments

client = DodoPayments(bearer_token=os.environ.get("DODO_PAYMENTS_API_KEY"))

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"}'

{
  "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
}

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