Configuração Multi-Brand

​

Introdução

​

Fluxo do Merchant Dashboard

1

Open Settings → Business

Acesse Settings → Business. O painel Brands Under [Your Business] lista sua Primary Brand e quaisquer Secondary Brands.

2

Click the + Button

No painel Brands, 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:

• Brand Name (obrigatório): pelo menos 2 caracteres e diferente dos nomes das suas outras marcas.
• Support Email: o endereço que os clientes usam para entrar em contato com o suporte desta marca.
• Brand Description (obrigatório): pelo menos 10 caracteres. Descreva a marca, seus produtos e o que a diferencia.
• Brand Logo: representa a marca no checkout, nas invoices e nos links de pagamento. Os formatos aceitos são PNG, JPEG, GIF, WebP, ICO e SVG. Qualquer outro formato é rejeitado com um erro 422.

Clique em Add brand para criar a marca. Depois, você poderá atribuir produtos a ela, e os links de pagamento exibirão sua identidade visual. Para definir o descritor da fatura ou alterar outros detalhes posteriormente, abra o menu ... da marca e selecione Edit.

4

Select the Brand on Products

Ao criar um produto, escolha sua marca no campo Brand.

5

Find the Brand ID in Transactions

As transações e assinaturas mostram um Brand ID, para que você possa identificar a qual marca cada uma pertence.

​

Pontos adicionais

• Nenhuma alteração nos repasses: Os fundos, ciclos de repasse e taxas permanecem no nível da empresa e são direcionados para a carteira da empresa e sua conta bancária.
• ID da marca nos webhooks: Os payloads de pagamento, assinatura, reembolso, 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 atribuir cada evento a uma marca. Quando uma entidade não tem uma marca própria, brand_id é a marca principal da empresa. Os payloads de disputa não contêm brand_id; use o payment_id para encontrar a marca no pagamento. Os payloads de repasse são do nível da empresa e não contêm brand_id.
• Suspensões: Se uma marca for suspensa, ela não poderá aceitar novos pagamentos, sessões de checkout ou assinaturas. As outras marcas da mesma empresa continuarão realizando transações.
• Faturas: Cada fatura exibe o nome e o logotipo da marca à qual o pagamento pertence.
• A vitrine, as chaves de licença, os códigos de desconto, as configurações de repasse e outros recursos no nível da empresa funcionam da mesma forma que em uma única marca.

​

Arquivando uma marca

​

Arquive uma marca pelo Dashboard

1

Open the Brand's Actions Menu

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

2

Confirm the Archive

Leia o aviso e selecione Continue.

3

Choose the Brand That Takes Over

Em Move products to, selecione a marca que receberá os produtos, as assinaturas ativas e as coleções. A marca primária é a opção padrão. Selecione Move & Archive para mover os registros e arquivar a marca em uma única ação.

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 desaparece com ela.

​

O que acontece quando você arquiva

• Move todos os produtos para a marca de destino.
• Move todas as assinaturas ativas para a marca de destino, para que as renovações sejam cobradas nela.
• Move todas as coleções de produtos para a marca de destino.
• Arquiva e desativa a marca original.

​

Uma marca arquivada é somente leitura

​

Arquivando pela 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"