Configuração Multi-Brand

​

Introdução

​

Fluxo do Painel do Comerciante

1

Open Settings → Business

Navegue até Configurações → Negócios. O painel Marcas sob [Seu Negócio] à direita lista sua marca Primária e quaisquer marcas Secundárias.

2

Click the '+' button

No painel de Marcas, clique no botão + no canto superior direito para abrir o formulário de nova marca.

3

Fill in the brand details

Preencha os seguintes campos:

• Nome da Marca (obrigatório): Insira o nome da sua marca.
• URL do Site (obrigatório): O site da sua marca, por exemplo https://www.yourcompany.com.
• E-mail de Suporte: O e-mail que os clientes podem usar para entrar em contato com o suporte para esta marca.
• Descrição da Marca (obrigatório): Descreva sua marca, produtos e o que a torna única.
• Logotipo da Marca: Carregue um logotipo para representar a marca no checkout, nas faturas e nos links de pagamento.

Envie o formulário para criar a marca. Os produtos agora podem ser marcados com essa marca e os links de pagamento exibirão sua identidade visual.

4

Brand Selector

Um filtro de Marca agora está visível na criação de Produtos.

5

Brand ID in Transactions

Transações e Assinaturas possuem um ID de Marca para ajudar a identificar a qual marca a transação pertence.

​

Pontos Adicionais

• Nenhuma alteração nos payouts: Todos os fundos, ciclos de payout e taxas continuam fluindo para a carteira no nível da empresa e para a conta bancária do merchant.
• ID da marca nos webhooks: Os payloads de pagamento, assinatura, reembolso, disputa, chave de licença, entrada no ledger de créditos, saldo de créditos baixo, concessão de entitlement, tentativa de cobrança e checkout abandonado incluem um brand_id, para que você possa atribuí-los a uma marca específica. Quando uma entidade não tem uma marca própria, brand_id usa como fallback a marca principal da empresa. Os payloads de payout são no nível da empresa e não contêm um brand_id.
• Suspensões: Se uma marca for suspensa, apenas seus links de pagamento serão interrompidos. As outras marcas da mesma empresa continuarão realizando transações.
• Nenhuma alteração no Storefront, Invoices, License Keys, Discount Codes, Payout Settings e em quaisquer outros recursos no nível da empresa.

​

Arquivando uma marca

​

Arquivar uma marca pelo painel

1

Open the brand's actions menu

Acesse Settings → Business. No painel Brands Under [Your Business], selecione o menu ... ao lado da marca secundária e selecione Archive. A marca principal não tem uma ação de arquivamento.

2

Confirm the archive

Leia o aviso e selecione Continue.

3

Choose the brand that takes over

Selecione a marca que receberá os produtos, as assinaturas ativas e as coleções. A marca principal é a opção padrão. Selecione Move & Archive para concluir as duas ações simultaneamente.

4

Check the result

A confirmação informa o nome da marca que recebeu os registros.

A marca arquivada deixa de aparecer no painel Brands. Quando a empresa não tem outra marca secundária, o grupo Secondary Brands também desaparece.

​

O que acontece quando você arquiva uma marca

• Transfere todos os produtos para a marca de destino.
• Transfere todas as assinaturas ativas para a marca de destino, para que as renovações continuem sendo cobradas por ela.
• Transfere todas as coleções de produtos para a marca de destino.
• Arquiva e desativa a marca original.

​

Uma marca arquivada é somente leitura

​

Arquivamento pela API

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

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