제품 컬렉션

Product Collections를 사용하면 관련 제품(예: Starter, Pro, Enterprise 요금제)을 하나의 묶음으로 그룹화할 수 있습니다. 하나의 체크아웃에 모든 옵션을 표시하고 업그레이드/다운그레이드 경로를 정의하며, 고객이 Customer Portal에서 요금제를 직접 변경할 수 있도록 유연성을 제공합니다.

주요 하이라이트

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

제품 컬렉션 생성하기

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

Create the collection

컬렉션을 이름과 선택적 설명으로 정의합니다. 체크아웃에서 컬렉션을 시각적으로 나타낼 수 있도록 이미지를 업로드하세요.

대시보드에서 이름, 설명, 이미지 업로드 필드가 표시된 제품 컬렉션 생성 폼의 스크린샷

컬렉션 필드:

이름 (필수): 컬렉션의 표시 이름 (예: “SaaS 플랜”, “라이센스 계층”)
설명 (선택): 체크아웃에 표시되는 간략한 설명
이미지 (선택): 컬렉션의 시각적 브랜딩

Add products to the collection

기존 제품을 컬렉션에 추가하세요. 제품은 더 나은 구조를 위해 그룹으로 구성할 수 있습니다.

제품 컬렉션 제품 페이지의 스크린샷으로, 제품 목록과 컬렉션에 추가할 수 있는 기능이 표시됨

제품 조직:

그룹: 선택적으로 제품을 이름이 있는 그룹으로 조직합니다 (예: “월간 플랜”, “연간 플랜”)
그룹에 포함되지 않은 제품: 그룹이 없는 제품은 컬렉션 수준에 표시됩니다.
정렬: 드래그 앤 드롭으로 표시 순서를 설정합니다.

각 제품은 하나의 컬렉션에만 속할 수 있습니다. 제품이 다른 컬렉션에 이미 포함되어 있다면 먼저 제거해야 합니다.

Configure ordering and visibility

컬렉션 내 제품의 표시 순서와 가시성을 제어하세요.구성 옵션:

제품 상태: 컬렉션 내에서 개별 제품을 활성화 또는 비활성화합니다.
표시 순서: 드래그 앤 드롭으로 체크아웃 시 제품이 표시되는 순서를 설정합니다.

컬렉션의 첫 번째 제품이 체크아웃 시 자동으로 기본 선택됩니다. 제품 순서를 변경하여 기본 선택 제품을 조정하세요.

컬렉션 체크아웃

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

체크아웃 유형

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

컬렉션 체크아웃 경험

컬렉션 체크아웃을 사용할 때:

모든 활성 제품이 표시됨: 고객은 컬렉션에 있는 모든 활성 제품을 봅니다.
첫 번째 제품이 기본 선택됨: 컬렉션의 첫 번째 제품이 자동으로 선택됩니다.
제품 세부정보 표시됨: 각 제품은 이름, 설명 및 가격을 표시합니다.
단일 선택: 고객이 구매할 제품 하나를 선택합니다.
표준 흐름 계속: 선택 후 체크아웃은 선택한 제품의 가격 및 청구 설정으로 진행됩니다.

컬렉션 체크아웃은 고객이 구매 전에 요금제를 나란히 비교하길 원하는 구독 비즈니스에 이상적입니다.

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.checkout_url;

product_collection_id를 사용 중일 때는 세션 생성 시 할인 코드를 적용할 수 없습니다. 설정이 활성화된 경우 고객은 체크아웃 중에 할인 코드를 입력할 수 있습니다.

고객 포털 통합

고객은 동일한 컬렉션 내에서 제품을 업그레이드 또는 다운그레이드할 수 있습니다.

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

요금제 관리 작업

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

계획 관리 작업이 표시된 제품 컬렉션 고객 포털 플랜 변경 인터페이스의 스크린샷

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

업그레이드 및 다운그레이드는 같은 컬렉션 내 제품 간에서만 가능합니다
과금은 구독 설정에 따라 계산됩니다
업그레이드, 다운그레이드, 취소 시마다 이메일 알림이 사업체에 전송됩니다

고객은 현재 컬렉션 외부의 제품으로 변경할 수 없습니다. 별도의 제품 라인마다 별도 컬렉션을 만드세요.

구독 설정

대시보드의 설정 → 구독에서 비즈니스 전반에 걸쳐 구독 및 플랜 변경이 작동하는 방식을 구성합니다.

사용 가능한 설정

Setting	Description	Default
Allow Multiple Subscriptions	고객은 동시에 둘 이상의 활성 구독을 보유할 수 있습니다	Enabled
Allow Subscription Updates	고객은 Customer Portal을 통해 언제든지 기존 구독을 업그레이드하거나 다운그레이드할 수 있습니다	Disabled
Prevent Trial Misuse	이미 trial을 사용한 고객은 새로운 trial을 받는 대신 유료 및 trial 없는 구매로 처리됩니다	Disabled

고객 포털을 통한 플랜 변경은 기본적으로 비활성화되어 있습니다. 설정 → 구독에서 “구독 업데이트 허용”을 활성화하여 고객이 동일한 컬렉션 내에서 제품 간에 업그레이드하거나 다운그레이드할 수 있도록 합니다.

trial 사용이 매칭되고 기록되는 방식에 대한 자세한 내용은 Preventing Trial Misuse를 참조하세요.

Subscription Plan Changes

proration 모드와 플랜 변경 동작에 대해 자세히 알아보세요.

Collection 관리

Product Collection은 Dodo Payments 대시보드 또는 API를 통해 프로그래밍 방식으로 관리할 수 있습니다. API를 사용하면 collection 생성, 업데이트, 이미지 업로드, 보관 처리, 중첩된 그룹 및 제품 관리를 모두 제어할 수 있습니다.

대시보드 작업

생성: 제품 및 그룹을 포함한 새 collection 설정
업데이트: 이름, 설명, 이미지 및 제품 구성 수정
순서 변경: 드래그 앤 드롭으로 제품 표시 순서 변경
제품 활성화/비활성화: checkout에 표시할 제품 제어
보관: collection을 영구적으로 삭제하지 않고 숨김 처리(나중에 보관 해제 가능)

Screenshot of the Product Collection dashboard showing the collection management operations

API 관리

다음 endpoint를 사용하면 Product Collection을 프로그래밍 방식으로 생성, 업데이트, 조회, 보관 처리 및 구성할 수 있으며, 중첩된 그룹과 그룹 내 제품도 관리할 수 있습니다.

Listing Product Collections

GET 요청을 /product-collections endpoint로 전송하여 계정과 연결된 모든 Product Collection을 가져옵니다. 페이지네이션, 브랜드별 필터링 및 보관된 collection 포함을 지원합니다.

List Product Collections API

List Product Collections API 문서에서 자세한 request 및 response 구조를 확인하세요.

Creating a Product Collection

이름, 설명, 브랜드 등의 세부 정보와 함께 POST 요청을 /product-collections endpoint로 전송하여 새 Product Collection을 생성합니다.

Create Product Collection API

Create Product Collection API 문서에서 자세한 request 및 response 구조를 확인하세요.

Retrieving a Product Collection

GET 요청을 /product-collections/{id} endpoint로 전송하여 특정 Product Collection에 대한 자세한 정보를 가져옵니다. 여기에는 해당 collection의 그룹과 제품 항목이 포함됩니다.

Get Product Collection API

Get Product Collection API 문서에서 자세한 request 및 response 구조를 확인하세요.

Updating a Product Collection

PATCH 요청을 /product-collections/{id} endpoint로 전송하여 Product Collection의 세부 정보(이름, 설명, 브랜드 등)를 수정합니다.

Update Product Collection API

Update Product Collection API 문서에서 자세한 request 및 response 구조를 확인하세요.

Uploading Collection Images

사전 서명된 URL을 통해 이미지를 업로드하여 collection에 연결합니다. /product-collections/{id}/images endpoint에서 업로드 URL을 요청한 다음, 60초 이내에 반환된 URL로 이미지를 PUT합니다.

사전 서명된 URL은 60초 후 만료되므로 해당 시간 내에 이미지를 업로드해야 합니다.

Update Collection Images API

Update Collection Images API 문서에서 자세한 request 및 response 구조를 확인하세요.

Archiving a Product Collection

DELETE 요청을 /product-collections/{id} endpoint로 전송하여 collection을 보관 처리합니다. 이렇게 하면 collection을 새로 사용할 수 없게 되지만 영구적으로 삭제되지는 않습니다.

Archive Product Collection API

Archive Product Collection API 문서에서 자세한 request 및 response 구조를 확인하세요.

Unarchiving a Product Collection

POST 요청을 /product-collections/{id}/unarchive endpoint로 전송하여 보관된 collection을 복원합니다.

Unarchive Product Collection API

Unarchive Product Collection API 문서에서 자세한 request 및 response 구조를 확인하세요.

Managing Groups within a Collection

그룹을 사용하면 collection 내에서 제품을 구성할 수 있습니다(예: “월간 플랜”과 “연간 플랜”). 그룹 endpoint를 사용하여 collection 내 그룹을 추가, 업데이트 또는 삭제하세요.

그룹 생성: POST /product-collections/{id}/groups
그룹 업데이트: PATCH /product-collections/{id}/groups/{group_id}
그룹 삭제: DELETE /product-collections/{id}/groups/{group_id}

Create Group

Product Collection에 새 그룹을 추가합니다.

Update Group

그룹의 이름 또는 속성을 수정합니다.

Delete Group

collection에서 그룹을 삭제합니다.

Managing Products within a Group

그룹 내부의 개별 제품 항목을 관리합니다. 새 제품을 추가하고, 기존 항목(예: 표시 순서)을 업데이트하거나, 항목을 완전히 삭제할 수 있습니다.

그룹에 제품 추가: POST /product-collections/{id}/groups/{group_id}/items
그룹 항목 업데이트: PATCH /product-collections/{id}/groups/{group_id}/items/{item_id}
그룹 항목 삭제: DELETE /product-collections/{id}/groups/{group_id}/items/{item_id}

Add Products to Group

collection 내 그룹에 하나 이상의 제품을 추가합니다.

Update Group Item

그룹 내 제품 항목을 업데이트합니다.

Delete Group Item

그룹에서 제품 항목을 삭제합니다.

권장 사항

논리적으로 그룹화: 청구 주기(월간/연간) 또는 기능 등급(starter/pro/enterprise)에 따라 제품 구성
전략적으로 순서 지정: 가장 인기 있거나 권장하는 플랜을 첫 번째에 배치하면 checkout에서 미리 선택됩니다
명확한 이름 사용: 제품 이름에 가치 차이가 명확하게 드러나야 합니다
양방향 변경 활성화: 고객에게 유연성을 제공할 수 있도록 업그레이드와 다운그레이드를 모두 허용
proration 고려: 비즈니스 모델에 적합한 proration 모드 선택
철저한 테스트: 실제 운영을 시작하기 전에 test mode에서 checkout 및 플랜 변경 흐름 확인

이제 Product Collection을 생성하고 고객에게 통합된 플랜 선택 경험을 제공할 수 있습니다.

Products

collection에 추가할 일회성, subscription 또는 사용량 기반 제품을 생성합니다.

Checkout

통합된 checkout 경험에서 collection 제품을 표시합니다.

Customer Portal

고객이 동일한 collection 내에서 업그레이드하거나 다운그레이드할 수 있도록 합니다.

Subscriptions

proration 및 플랜 변경을 사용하여 반복 결제 플랜을 관리합니다.

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

주요 하이라이트

제품 컬렉션 생성하기