Multi-Brand Setup

Introduction

Multi-Brand 让您可以在一个经过验证的企业下运营多个品牌。每个品牌都有自己的名称、徽标、账单描述和 URL。您的收款账户、费用和 KYC 在企业级别共享，而每个产品、支付链接、订阅、发票和交易都会归档到特定品牌下。您可以使用品牌来测试新的细分市场、运营本地化网站，或区分 B2B 和 B2C 产品线，而无需开设另一个企业账户。如果某个品牌需要自己的法人实体、KYC 或收款账户，则应改为创建一个单独的企业。请参阅管理多个企业。

Merchant Dashboard 流程

Open Settings → Business

前往 Settings → Business。Brands Under [Your Business] 面板会列出您的主品牌和所有次要品牌。

Business Settings 中的品牌面板，显示主品牌和次要品牌，以及用于添加新品牌的加号按钮

Click the + Button

在 Brands 面板中，点击右上角的 + 按钮，打开新建品牌表单。

Fill In the Brand Details

填写以下字段：

Brand Name（必填）：至少 2 个字符，且不能与其他品牌的名称相同。
Support Email：客户用于联系该品牌客服的地址。
Brand Description（必填）：至少 10 个字符。描述品牌、其产品以及使其与众不同之处。
Brand Logo：在结账页面、发票和支付链接中代表该品牌。支持的格式包括 PNG、JPEG、GIF、WebP、ICO 和 SVG。其他任何格式都会返回 422 错误。

点击 Add brand 创建品牌。随后您可以将产品分配给该品牌，其支付链接也会显示该品牌的标识。若要设置账单描述或稍后更改其他详细信息，请打开该品牌的 ... 菜单，然后选择 Edit。

Select the Brand on Products

创建产品时，在 Brand 字段中选择其所属品牌。

Find the Brand ID in Transactions

交易和订阅会显示 Brand ID，因此您可以确认每一项所属的品牌。

其他要点

无 payout 变更： 资金、payout 周期和费用仍归业务层级管理，并流入业务钱包和您的银行账户。
Webhook 中的 Brand ID： 支付、订阅、退款、许可证密钥、credit ledger entry、credit balance low、权益授予、催收尝试和放弃结账 payload 都包含一个 brand_id，因此您可以将每个事件归因到相应品牌。当某个实体没有自己的品牌时，brand_id 为该业务的主品牌。Dispute payload 不包含 brand_id，因此请使用其中的 payment_id 查找支付所属的品牌。Payout payload 属于业务层级，不包含 brand_id。
暂停： 如果某个品牌被暂停，则无法接受新的支付、结账会话或订阅。同一业务下的其他品牌仍可继续进行交易。
发票： 每张发票都会显示该支付所属品牌的名称和徽标。
门店、许可证密钥、折扣码、payout 设置以及其他业务层级功能的工作方式与单一品牌时相同。

归档品牌

归档您不再使用的品牌。归档会停用该品牌，并在一个步骤中将其产品、有效订阅和产品集合转移到同一企业下的另一个品牌。

归档品牌是永久操作。已归档的品牌无法恢复。

从 Dashboard 归档品牌

Open the Brand's Actions Menu

前往 Settings → Business。在 Brands Under [Your Business] 面板中，打开次要品牌旁边的 ... 菜单，然后选择 Archive。主品牌没有 Archive 选项。

Confirm the Archive

阅读警告，然后选择 Continue。

Choose the Brand That Takes Over

在 Move products to 中，选择接收产品、有效订阅和集合的品牌。主品牌是默认选项。选择 Move & Archive，即可在一个操作中转移记录并归档该品牌。

Check the Result

确认信息会显示接收记录的品牌。

已归档的品牌会从 Brands 面板中移除。当企业没有其他次要品牌时，Secondary Brands 组也会随之消失。

归档后会发生什么

您需要选择一个目标品牌，接管被归档品牌的内容。Dashboard 始终要求提供一个目标品牌，API 则将其作为 move_products_to 接收。在一个原子操作中，Dodo Payments 会：

将每个产品移至目标品牌。
将每个有效订阅移至目标品牌，因此续费会在该品牌下计费。
将每个产品集合移至目标品牌。
归档并停用原品牌。

历史记录不会移动。支付、发票和已结束的订阅会保留其创建时所属的品牌，因此历史报告仍然准确。目标品牌必须属于同一企业，且不能已归档。主品牌是有效目标，其品牌 ID 就是您的企业 ID。只有当该品牌没有产品、有效订阅和产品集合时，您才可以省略目标品牌。

主品牌无法归档，API 会返回 CANNOT_ARCHIVE_PRIMARY_BRAND 错误。它是企业的默认品牌，因此始终至少会保留一个品牌。

已归档品牌为只读

API 会拒绝对已归档品牌进行的所有更改，以及在该品牌下创建的所有新记录：

操作	结果
编辑品牌详细信息	返回 `BRAND_ARCHIVED` 错误
提交品牌进行验证	返回 `BRAND_ARCHIVED` 错误
在品牌下创建产品或集合	返回 `BRAND_ARCHIVED` 错误
为其产品创建订阅	返回 `BRAND_ARCHIVED` 错误

已归档品牌会从品牌选择器中隐藏，因此您无法将新记录分配给它们。它们仍可作为分析筛选条件使用，从而保留品牌在运营期间的完整品牌级报告。请参阅Analytics。

通过 API 归档

要归档品牌，请使用即将停用的品牌以及接管该品牌的品牌调用归档 endpoint：

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

响应会报告已移动的内容，以便您确认结果。不指定目标进行归档时，moved_to_brand_id 为 null。

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

对于主品牌，endpoint 返回 403；对于未知品牌，返回 404；对于已归档的品牌，返回 409；对于缺少或无效的 move_products_to 目标，返回 422。若要列出包含已归档品牌在内的所有品牌，请在 list endpoint 上设置 include_archived。默认情况下会排除已归档品牌。每个品牌都包含一个 archived_at 字段；品牌处于活跃状态时，该字段为 null。

cURL

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

请参阅 Archive Brand API reference，了解完整的请求和响应 schema；有关此 endpoint 返回的错误，请参阅 Error Codes。

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Introduction

Merchant Dashboard 流程

其他要点

归档品牌

从 Dashboard 归档品牌

归档后会发生什么

已归档品牌为只读

通过 API 归档

​Introduction

​Merchant Dashboard 流程

​其他要点

​归档品牌

​从 Dashboard 归档品牌

​归档后会发生什么

​已归档品牌为只读

​通过 API 归档

Introduction

Merchant Dashboard 流程

其他要点

归档品牌

从 Dashboard 归档品牌

归档后会发生什么

已归档品牌为只读

通过 API 归档