Multi-Brand Setup

​

Introduction

​

Merchant Dashboard Flow

1

Open Settings → Business

Go to Settings → Business. The Brands Under [Your Business] panel 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): At least 2 characters, and different from the names of your other brands.
• Support Email: The address customers use to contact support for this brand.
• Brand Description (required): At least 10 characters. Describe the brand, its products, and what makes it distinct.
• Brand Logo: Represents the brand on checkout, invoices, and payment links. Accepted formats are PNG, JPEG, GIF, WebP, ICO, and SVG. Any other format is rejected with a 422 error.

Click Add brand to create the brand. You can then assign products to it, and its payment links show its branding. To set the statement descriptor or change other details later, open the brand’s ... menu and select Edit.

4

Select the Brand on Products

When you create a product, choose its brand in the Brand field.

5

Find the Brand ID in Transactions

Transactions and subscriptions show a Brand ID, so you can tell which brand each one belongs to.

​

Additional Points

• No payout changes: Funds, payout cycles, and fees stay at the business level and flow to the business wallet and your bank account.
• Brand ID on webhooks: Payment, subscription, refund, license key, credit ledger entry, credit balance low, entitlement grant, dunning attempt, and abandoned checkout payloads include a brand_id, so you can attribute each event to a brand. When an entity has no brand of its own, brand_id is the business’s primary brand. Dispute payloads carry no brand_id, so use their payment_id to find the brand on the payment. Payout payloads are business-level and carry no brand_id.
• Suspensions: If a brand is suspended, it can’t take new payments, checkout sessions, or subscriptions. Other brands under the same business keep transacting.
• Invoices: Each invoice shows the name and logo of the brand the payment belongs to.
• Storefront, license keys, discount codes, payout settings, and other business-level features work the same as with a single brand.

​

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, open the ... menu next to the secondary brand and select Archive. The primary brand has no Archive option.

2

Confirm the Archive

Read the warning and select Continue.

3

Choose the Brand That Takes Over

In Move products to, select the brand that receives the products, live subscriptions, and collections. The primary brand is the default. Select Move & Archive to move the records and archive the brand in one action.

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

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"