다중 브랜드 설정

소개

Multi-Brand를 사용하면 하나의 인증된 비즈니스에서 여러 브랜드를 운영할 수 있습니다. 각 브랜드는 고유한 이름, 로고, 명세서 표시 문구, URL을 사용합니다. 지급 계정, 수수료, KYC는 비즈니스 수준에서 공유되며, 각 제품, 결제 링크, 구독, 인보이스, 거래는 특정 브랜드에 연결됩니다. 새로운 틈새 시장을 테스트하거나, 현지화된 사이트를 운영하거나, 다른 비즈니스 계정을 개설하지 않고 B2B와 B2C 제품 라인을 분리할 때 브랜드를 사용하세요. 자체 법인, KYC 또는 지급 계정이 필요한 브랜드는 별도의 비즈니스로 운영해야 합니다. 여러 비즈니스 관리를 참조하세요.

Merchant Dashboard 흐름

Open Settings → Business

설정 → 비즈니스로 이동합니다. [내 비즈니스]의 브랜드 패널에는 기본 브랜드와 모든 보조 브랜드가 표시됩니다.

Click the + Button

브랜드 패널의 오른쪽 상단에 있는 + 버튼을 클릭하여 새 브랜드 양식을 엽니다.

Fill In the Brand Details

다음 필드를 작성합니다:

브랜드 이름(필수): 2자 이상이어야 하며, 다른 브랜드의 이름과 달라야 합니다.
지원 이메일: 고객이 이 브랜드의 지원팀에 문의할 때 사용하는 주소입니다.
브랜드 설명(필수): 10자 이상이어야 합니다. 브랜드, 제품, 그리고 브랜드를 차별화하는 요소를 설명하세요.
브랜드 로고: 결제 페이지, 인보이스, 결제 링크에 브랜드를 표시합니다. PNG, JPEG, GIF, WebP, ICO, SVG 형식을 사용할 수 있습니다. 그 외 형식은 422 오류와 함께 거부됩니다.

브랜드 추가를 클릭하여 브랜드를 생성합니다. 그런 다음 제품을 해당 브랜드에 할당할 수 있으며, 결제 링크에는 해당 브랜드의 브랜딩이 표시됩니다. 나중에 명세서 표시 문구를 설정하거나 다른 세부 정보를 변경하려면 브랜드의 ... 메뉴를 열고 편집을 선택합니다.

Select the Brand on Products

제품을 생성할 때 브랜드 필드에서 브랜드를 선택합니다.

Find the Brand ID in Transactions

거래와 구독에는 브랜드 ID가 표시되므로 각 항목이 어느 브랜드에 속하는지 확인할 수 있습니다.

추가 사항

정산 변경 없음: 자금, 정산 주기 및 수수료는 사업체 수준에서 유지되며 사업체 지갑과 은행 계좌로 이동합니다.
Webhook의 브랜드 ID: 결제, 구독, 환불, 라이선스 키, 크레딧 원장 항목, 낮은 크레딧 잔액, 권한 부여, 추심 시도 및 중단된 결제 payload에는 brand_id가 포함되므로 각 이벤트를 브랜드에 연결할 수 있습니다. 엔터티에 자체 브랜드가 없는 경우 brand_id는 사업체의 기본 브랜드입니다. 분쟁 payload에는 brand_id가 포함되지 않으므로, 해당 결제의 브랜드를 찾으려면 payment_id를 사용하세요. 정산 payload는 사업체 수준이며 brand_id를 포함하지 않습니다.
정지: 브랜드가 정지되면 새로운 결제, checkout session 또는 구독을 받을 수 없습니다. 동일한 사업체에 속한 다른 브랜드는 계속 거래할 수 있습니다.
청구서: 각 청구서에는 해당 결제가 속한 브랜드의 이름과 로고가 표시됩니다.
스토어프런트, 라이선스 키, 할인 코드, 정산 설정 및 기타 사업체 수준 기능은 단일 브랜드를 사용하는 경우와 동일하게 작동합니다.

브랜드 보관

더 이상 판매에 사용하지 않는 브랜드를 보관하세요. 브랜드를 보관하면 해당 브랜드의 운영이 종료되고 제품, 활성 구독, 제품 컬렉션이 한 번에 같은 비즈니스의 다른 브랜드로 이동합니다.

브랜드 보관은 영구적입니다. 보관된 브랜드는 복원할 수 없습니다.

Dashboard에서 브랜드 보관

Open the Brand's Actions Menu

설정 → 비즈니스로 이동합니다. [내 비즈니스]의 브랜드 패널에서 보조 브랜드 옆의 ... 메뉴를 열고 보관을 선택합니다. 기본 브랜드에는 보관 옵션이 없습니다.

Confirm the Archive

경고를 읽고 계속을 선택합니다.

Choose the Brand That Takes Over

제품을 이동할 대상에서 제품, 활성 구독, 컬렉션을 받을 브랜드를 선택합니다. 기본 브랜드가 기본값으로 선택됩니다. 이동 및 보관을 선택하여 한 번의 작업으로 레코드를 이동하고 브랜드를 보관합니다.

Check the Result

확인 메시지에는 레코드를 받은 브랜드의 이름이 표시됩니다.

보관된 브랜드는 브랜드 패널에서 사라집니다. 비즈니스에 다른 보조 브랜드가 없으면 보조 브랜드 그룹도 함께 사라집니다.

브랜드를 보관하면 발생하는 일

보관할 브랜드를 대신할 대상 브랜드를 선택합니다. Dashboard에서는 항상 대상 브랜드를 지정해야 하며, API에서는 이를 move_products_to로 받습니다. 하나의 원자적 작업으로 Dodo Payments는 다음을 수행합니다.

모든 제품을 대상 브랜드로 이동합니다.
모든 활성 구독을 대상 브랜드로 이동하므로 갱신 결제가 해당 브랜드로 처리됩니다.
모든 제품 컬렉션을 대상 브랜드로 이동합니다.
원래 브랜드를 보관하고 비활성화합니다.

과거 레코드는 이동하지 않습니다. 결제, 인보이스, 종료된 구독은 생성 당시의 브랜드를 유지하므로 과거 보고서의 정확성이 유지됩니다. 대상 브랜드는 같은 비즈니스에 속해야 하며 보관된 브랜드가 아니어야 합니다. 기본 브랜드는 유효한 대상이며, 해당 브랜드 ID는 비즈니스 ID입니다. 브랜드에 제품, 활성 구독, 제품 컬렉션이 하나도 없는 경우에만 대상을 생략할 수 있습니다.

기본 브랜드는 보관할 수 없으며 API는 CANNOT_ARCHIVE_PRIMARY_BRAND 오류와 함께 요청을 거부합니다. 기본 브랜드는 비즈니스가 대체 대상으로 사용하는 브랜드이므로 항상 하나 이상의 브랜드가 남습니다.

보관된 브랜드는 읽기 전용입니다

API는 보관된 브랜드에 대한 모든 변경과 해당 브랜드로 생성하는 모든 새 레코드를 거부합니다.

작업	결과
브랜드 세부 정보 편집	`BRAND_ARCHIVED`와 함께 거부됨
인증을 위해 브랜드 제출	`BRAND_ARCHIVED`와 함께 거부됨
해당 브랜드에 제품 또는 컬렉션 생성	`BRAND_ARCHIVED`와 함께 거부됨
해당 브랜드의 제품에 대한 구독 생성	`BRAND_ARCHIVED`와 함께 거부됨

보관된 브랜드는 브랜드 선택기에서 숨겨지므로 새 레코드를 할당할 수 없습니다. 다만 분석 필터로는 계속 사용할 수 있으므로 해당 브랜드가 운영되던 기간의 브랜드별 보고서를 완전하게 유지할 수 있습니다. 분석을 참조하세요.

API를 통한 보관

브랜드를 보관하려면 보관할 브랜드와 이를 대신할 브랜드를 지정하여 archive 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"

전체 요청 및 응답 스키마는 브랜드 보관 API reference를, 이 endpoint가 반환하는 오류는 오류 코드를 참조하세요.

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

소개

Merchant Dashboard 흐름

추가 사항

브랜드 보관

Dashboard에서 브랜드 보관

브랜드를 보관하면 발생하는 일

보관된 브랜드는 읽기 전용입니다

API를 통한 보관

​소개

​Merchant Dashboard 흐름

​추가 사항

​브랜드 보관

​Dashboard에서 브랜드 보관

​브랜드를 보관하면 발생하는 일

​보관된 브랜드는 읽기 전용입니다

​API를 통한 보관

소개

Merchant Dashboard 흐름

추가 사항

브랜드 보관

Dashboard에서 브랜드 보관

브랜드를 보관하면 발생하는 일

보관된 브랜드는 읽기 전용입니다

API를 통한 보관