Multi-Brand Setup

​

Introduction

​

Merchant Dashboard Flow

1

Open Settings → Business

Navigate to Settings → Business. The Brands Under [Your Business] panel on the right lists your Primary brand and any Secondary brands.

2

Click the '+' button

In the Brands panel, click the + button in the top-right corner to open the new brand form.

3

Fill in the brand details

Complete the following fields:

• Brand Name (required): Enter your brand name.
• Website URL (required): Your brand’s website, for example https://www.yourcompany.com.
• Support Email: The email customers can use to reach support for this brand.
• Brand Description (required): Describe your brand, products, and what makes it unique.
• Brand Logo: Upload a logo to represent the brand on checkout, invoices, and payment links.

Submit the form to create the brand. Products can now be tagged to this brand and payment links will display its branding.

4

Brand Selector

A Brand filter is now visible on Product creation.

5

Brand ID in Transactions

Transactions and Subscriptions have a Brand ID to help you identify which brand the transaction belongs to.

​

Additional Points

• No payout changes: All funds, payout cycles and fees still flow to the business-level wallet and merchant bank account.
• Brand ID on webhooks: Payment, subscription, refund, dispute, license key, credit ledger entry, credit balance low, entitlement grant, dunning attempt, and abandoned checkout payloads all include a brand_id, so you can attribute them to a specific brand. Where an entity has no brand of its own, brand_id falls back to the business’s primary brand. Payout payloads are business-level and do not carry a brand_id.
• Suspensions: If a brand is suspended, only its payment links stop. Other brands under the same business keep transacting.
• No changes to Storefront, Invoices, License Keys, Discount Codes, Payout Settings and any other business level features.

​

Archiving a Brand

​

Archive a Brand from the Dashboard

1

Open the brand's actions menu

Go to Settings → Business. In the Brands Under [Your Business] panel, select the ... menu next to the secondary brand, then select Archive. The primary brand has no archive action.

2

Confirm the archive

Read the warning and select Continue.

3

Choose the brand that takes over

Select the brand that receives the products, live subscriptions, and collections. The primary brand is the default. Select Move & Archive to complete both actions together.

4

Check the result

The confirmation names the brand that received the records.

The archived brand leaves the Brands panel. When the business has no other secondary brand, the Secondary Brands group disappears with it.

​

What Happens When You Archive

• Moves every product to the target brand.
• Moves every live subscription to the target brand, so renewals continue to bill under it.
• Moves every product collection to the target brand.
• Archives and disables the original brand.

​

An Archived Brand Is Read-Only

​

Archiving Through the 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"