Cài đặt Đa Thương Hiệu

​

Giới thiệu

​

Quy trình trên Merchant Dashboard

1

Open Settings → Business

Đi đến Settings → Business. Bảng Brands Under [Your Business] liệt kê Primary Brand và mọi Secondary Brands của bạn.

2

Click the + Button

Trong bảng Brands, nhấp vào nút + ở góc trên bên phải để mở biểu mẫu thương hiệu mới.

3

Fill In the Brand Details

Điền các trường sau:

• Brand Name (bắt buộc): Ít nhất 2 ký tự và khác với tên của các thương hiệu khác.
• Support Email: Địa chỉ khách hàng sử dụng để liên hệ với bộ phận hỗ trợ cho thương hiệu này.
• Brand Description (bắt buộc): Ít nhất 10 ký tự. Mô tả thương hiệu, các sản phẩm của thương hiệu và điểm khác biệt của thương hiệu.
• Brand Logo: Đại diện cho thương hiệu trên checkout, invoice và payment link. Các định dạng được chấp nhận là PNG, JPEG, GIF, WebP, ICO và SVG. Mọi định dạng khác sẽ bị từ chối với lỗi 422.

Nhấp vào Add brand để tạo thương hiệu. Sau đó, bạn có thể gán sản phẩm cho thương hiệu này và payment link của sản phẩm sẽ hiển thị branding của thương hiệu. Để thiết lập statement descriptor hoặc thay đổi các thông tin khác sau này, mở menu ... của thương hiệu và chọn Edit.

4

Select the Brand on Products

Khi tạo sản phẩm, hãy chọn thương hiệu của sản phẩm trong trường Brand.

5

Find the Brand ID in Transactions

Transaction và subscription hiển thị Brand ID, giúp bạn xác định từng transaction và subscription thuộc về thương hiệu nào.

​

Các điểm bổ sung

• Không thay đổi khoản chi trả: Tiền, chu kỳ chi trả và phí vẫn ở cấp doanh nghiệp, đồng thời được chuyển vào ví doanh nghiệp và tài khoản ngân hàng của bạn.
• ID thương hiệu trong webhooks: Các payload về thanh toán, gói đăng ký, hoàn tiền, license key, mục nhập sổ cái tín dụng, số dư tín dụng thấp, cấp quyền, lần thử thu hồi nợ và checkout bị bỏ dở đều bao gồm brand_id, để bạn có thể xác định mỗi sự kiện thuộc về thương hiệu nào. Khi một thực thể không có thương hiệu riêng, brand_id là thương hiệu chính của doanh nghiệp. Payload tranh chấp không chứa brand_id, vì vậy hãy sử dụng payment_id để tìm thương hiệu trên khoản thanh toán. Payload khoản chi trả ở cấp doanh nghiệp và không chứa brand_id.
• Tạm ngưng: Nếu một thương hiệu bị tạm ngưng, thương hiệu đó không thể nhận các khoản thanh toán mới, phiên checkout hoặc gói đăng ký mới. Các thương hiệu khác thuộc cùng doanh nghiệp vẫn có thể tiếp tục giao dịch.
• Hóa đơn: Mỗi hóa đơn hiển thị tên và logo của thương hiệu mà khoản thanh toán thuộc về.
• Storefront, license keys, mã giảm giá, cài đặt khoản chi trả và các tính năng khác ở cấp doanh nghiệp vẫn hoạt động giống như khi chỉ có một thương hiệu.

​

Lưu trữ thương hiệu

​

Lưu trữ thương hiệu từ Dashboard

1

Open the Brand's Actions Menu

Đi đến Settings → Business. Trong bảng Brands Under [Your Business], mở menu ... bên cạnh thương hiệu phụ và chọn Archive. Thương hiệu chính không có tùy chọn Archive.

2

Confirm the Archive

Đọc cảnh báo và chọn Continue.

3

Choose the Brand That Takes Over

Trong Move products to, chọn thương hiệu sẽ nhận sản phẩm, subscription đang hoạt động và collection. Thương hiệu chính là lựa chọn mặc định. Chọn Move & Archive để chuyển các bản ghi và lưu trữ thương hiệu trong một thao tác.

4

Check the Result

Thông báo xác nhận nêu tên thương hiệu đã nhận các bản ghi.

Thương hiệu đã lưu trữ sẽ không còn xuất hiện trong bảng Brands. Khi doanh nghiệp không còn thương hiệu phụ nào khác, nhóm Secondary Brands cũng biến mất.

​

Điều gì xảy ra khi bạn lưu trữ

• Chuyển mọi sản phẩm sang thương hiệu đích.
• Chuyển mọi subscription đang hoạt động sang thương hiệu đích để các lần gia hạn được tính phí dưới thương hiệu đó.
• Chuyển mọi product collection sang thương hiệu đích.
• Lưu trữ và vô hiệu hóa thương hiệu ban đầu.

​

Thương hiệu đã lưu trữ ở chế độ chỉ đọc

​

Lưu trữ qua 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"