메인 콘텐츠로 건너뛰기
Product Collections를 사용하면 관련 제품(예: Starter, Pro, Enterprise 요금제)을 하나의 묶음으로 그룹화할 수 있습니다. 하나의 체크아웃에 모든 옵션을 표시하고 업그레이드/다운그레이드 경로를 정의하며, 고객이 Customer Portal에서 요금제를 직접 변경할 수 있도록 유연성을 제공합니다.
Screenshot of the Product Collection checkout page showing multiple products displayed

주요 하이라이트

  • 컬렉션 기반 구조: 관련 제품(플랜, 계층, 가격 옵션)을 단일 컬렉션 아래 그룹화하여 조직적으로 관리합니다.
  • 하나의 컬렉션, 여러 제품: 스타터, 프로, 라이프타임 등 각기 다른 가격 모델을 가진 여러 제품을 포함합니다.
  • 동적 체크아웃 경험: 컬렉션의 모든 제품을 하나의 체크아웃 뷰에서 표시하여 고객이 선호하는 플랜을 선택할 수 있도록 합니다.
  • 상인 수준 제어: 각 컬렉션 내에서 제품을 활성화, 비활성화 및 재배치할 수 있습니다. 첫 번째 제품은 체크아웃 시 자동으로 기본 선택됩니다.
  • 생애 주기 인식: 고객이 고객 포털을 통해 동일한 컬렉션 내에서 제품 업그레이드 또는 다운그레이드할 수 있도록 합니다.

제품 컬렉션 생성하기

제품 컬렉션은 대시보드 또는 API를 통해 생성 및 관리됩니다. 각 컬렉션은 관련 제품의 컨테이너 역할을 합니다.
1

Create the collection

컬렉션을 이름과 선택적 설명으로 정의합니다. 체크아웃에서 컬렉션을 시각적으로 나타낼 수 있도록 이미지를 업로드하세요.
Screenshot of the Product Collection creation form in the dashboard showing fields for name, description, and image upload
컬렉션 필드:
  • 이름 (필수): 컬렉션의 표시 이름 (예: “SaaS 플랜”, “라이센스 계층”)
  • 설명 (선택): 체크아웃에 표시되는 간략한 설명
  • 이미지 (선택): 컬렉션의 시각적 브랜딩
2

Add products to the collection

기존 제품을 컬렉션에 추가하세요. 제품은 더 나은 구조를 위해 그룹으로 구성할 수 있습니다.
Screenshot of the Product Collection products page showing a list of products and the ability to add them to the collection
제품 조직:
  • 그룹: 선택적으로 제품을 이름이 있는 그룹으로 조직합니다 (예: “월간 플랜”, “연간 플랜”)
  • 그룹에 포함되지 않은 제품: 그룹이 없는 제품은 컬렉션 수준에 표시됩니다.
  • 정렬: 드래그 앤 드롭으로 표시 순서를 설정합니다.
각 제품은 하나의 컬렉션에만 속할 수 있습니다. 제품이 다른 컬렉션에 이미 포함되어 있다면 먼저 제거해야 합니다.
3

Configure ordering and visibility

컬렉션 내 제품의 표시 순서와 가시성을 제어하세요.구성 옵션:
  • 제품 상태: 컬렉션 내에서 개별 제품을 활성화 또는 비활성화합니다.
  • 표시 순서: 드래그 앤 드롭으로 체크아웃 시 제품이 표시되는 순서를 설정합니다.
컬렉션의 첫 번째 제품이 체크아웃 시 자동으로 기본 선택됩니다. 제품 순서를 변경하여 기본 선택 제품을 조정하세요.

컬렉션 체크아웃

컬렉션은 고객이 한 곳에서 모든 사용 가능한 제품을 보고 선택할 수 있는 통합 체크아웃 경험을 제공합니다.

체크아웃 유형

유형설명사용 사례
컬렉션 체크아웃컬렉션 내 모든 활성 제품 표시구독 플랜 선택, 계층형 가격
단일 제품 체크아웃특정 제품 하나만 표시직접 구매, 프로모션 링크

컬렉션 체크아웃 경험

컬렉션 체크아웃을 사용할 때:
  1. 모든 활성 제품이 표시됨: 고객은 컬렉션에 있는 모든 활성 제품을 봅니다.
  2. 첫 번째 제품이 기본 선택됨: 컬렉션의 첫 번째 제품이 자동으로 선택됩니다.
  3. 제품 세부정보 표시됨: 각 제품은 이름, 설명 및 가격을 표시합니다.
  4. 단일 선택: 고객이 구매할 제품 하나를 선택합니다.
  5. 표준 흐름 계속: 선택 후 체크아웃은 선택한 제품의 가격 및 청구 설정으로 진행됩니다.
Screenshot of the Product Collection checkout page showing multiple products displayed
컬렉션 체크아웃은 고객이 구매 전에 요금제를 나란히 비교하길 원하는 구독 비즈니스에 이상적입니다.

API 통합

컬렉션을 위해 체크아웃 세션을 생성합니다:
const session = await client.checkoutSessions.create({
  product_collection_id: 'pdc_abc123',
  product_cart: [], // Required: pass an empty array for collection checkout
  return_url: 'https://yoursite.com/return'
});

// Redirect customer to the checkout
window.location.href = session.url;
product_collection_id를 사용 중일 때는 세션 생성 시 할인 코드를 적용할 수 없습니다. 설정이 활성화된 경우 고객은 체크아웃 중에 할인 코드를 입력할 수 있습니다.

고객 포털 통합

고객은 동일한 컬렉션 내에서 제품을 업그레이드 또는 다운그레이드할 수 있습니다.
이미 구독 제품이 있나요? Product Collection에 추가하면 Customer Portal에서 업그레이드/다운그레이드 흐름을 활성화할 수 있습니다. 제품을 다시 만들 필요는 없습니다.

요금제 관리 작업

작업설명판매자 제어
현재 요금제 보기현재 제품 이름, 가격, 갱신 날짜 표시항상 사용 가능
요금제 업그레이드동일 컬렉션 내 상위 제품으로 이동구성 가능합니다(기본값: 허용)
요금제 다운그레이드동일 컬렉션 내 하위 제품으로 이동구성 가능합니다(기본값: 허용)
취소구독 전체를 취소항상 사용 가능
Screenshot of the Product Collection customer portal plan change interface showing the plan management actions

업그레이드/다운그레이드 규칙

  • 업그레이드 및 다운그레이드는 같은 컬렉션 내 제품 간에서만 가능합니다
  • 과금은 구독 설정에 따라 계산됩니다
  • 업그레이드, 다운그레이드, 취소 시마다 이메일 알림이 사업체에 전송됩니다
Screenshot of the Product Collection customer portal plan change interface showing the plan management actions
고객은 현재 컬렉션 외부의 제품으로 변경할 수 없습니다. 별도의 제품 라인마다 별도 컬렉션을 만드세요.

구독 설정

대시보드의 Subscription Settings 섹션에서 구독 및 요금제 변경 방식 전반을 구성하세요.
Screenshot of the subscription settings page showing Allow Multiple Subscriptions and Allow Subscription Updates toggles

사용 가능한 설정

설정설명기본값
다중 구독 허용고객이 동시에 둘 이상의 활성 구독을 가질 수 있습니다활성화됨
구독 업데이트 허용고객이 Customer Portal을 통해 언제든지 기존 구독을 업그레이드하거나 다운그레이드할 수 있습니다비활성화됨
Customer Portal을 통한 요금제 변경은 기본적으로 비활성화되어 있습니다. 같은 컬렉션 내 제품 간 업그레이드/다운그레이드를 허용하려면 구독 설정에서 “구독 업데이트 허용”을 활성화하세요.

Subscription Plan Changes

과금 모드 및 요금제 변경 동작에 대해 자세히 알아보세요.

컬렉션 관리

Product Collections는 Dodo Payments 대시보드에서만 생성 및 관리할 수 있습니다.
컬렉션 생성, 업데이트, 삭제는 대시보드에서만 가능합니다. API는 통합을 위한 컬렉션 데이터를 읽기 전용으로 제공할 뿐입니다.

대시보드 작업

  • 생성: 제품 및 그룹을 포함하여 새 컬렉션 설정
  • 업데이트: 이름, 설명, 이미지 및 제품 구성 수정
  • 순서 변경: 끌어서 놓기로 제품 표시 순서 변경
  • 제품 활성화/비활성화: 체크아웃에 나타나는 제품 제어
  • 삭제: 컬렉션 제거(제품은 유지되지만 연결 해제됨)
Screenshot of the Product Collection dashboard showing the collection management operations

모범 사례

  • 논리적으로 그룹화: 청구 주기(월간/연간) 또는 기능 등급(starter/pro/enterprise)별로 제품 구성
  • 전략적으로 순서 지정: 가장 인기 있거나 추천하는 요금제를 가장 먼저 배치하세요. 체크아웃 시 기본 선택됩니다.
  • 명확한 명명 사용: 제품 이름은 가치 차이를 명확히 전달해야 합니다.
  • 양방향 활성화: 고객에게 유연성을 제공하려면 업그레이드와 다운그레이드를 모두 허용하세요.
  • 과금을 고려: 비즈니스 모델에 맞는 과금 모드를 선택하세요.
  • 철저히 테스트: 실시간 전환 전 테스트 모드에서 체크아웃 및 요금제 변경 흐름을 확인하세요.
이제 Product Collections를 생성하고 고객에게 통합된 요금제 선택 경험을 제공할 준비가 되었습니다.