제품은 Dodo Payments의 기초입니다. 일회성 다운로드, 반복 구독 또는 사용 기반 액세스를 판매하든, 제품을 생성하는 것부터 시작합니다. 각 제품은 가격 책정, 체크아웃 시 표시 방법 및 구매 후 이행 방법을 정의합니다.
일회성
평생 액세스 또는 단일 제공물에 대해 한 번만 청구합니다.
구독
시험, 비례 배분 및 추가 기능과 함께 일정에 따라 청구합니다.
사용 기반
소비를 측정하고 실제 사용량에 따라 청구합니다.
제품 생성
대시보드 또는 API를 통해 제품을 생성할 수 있습니다. 가격 모델을 미리 선택하고, 일회성, 구독 또는 사용 기반으로 설정한 후 세부 정보를 구성하세요. 가격 모델은 나중에 변경할 수 없으므로, 다른 모델이 필요하면 새 제품을 생성하세요.가격 모델 및 가격
가격 모델을 선택하세요:
- 일회성: 한 번 지불하는 고정 가격.
- 구독: 간격과 선택적 시험이 있는 반복 가격.
- 사용 기반: 측정된 이벤트에서 파생된 가격.
- 가격: 기본 금액 및 통화.
- 할인 (%): 체크아웃 및 송장에 표시되는 선택적 인라인 할인.
- 구독의 경우, 필요에 따라 매 반복(예: 1개월 또는 1년) 및 시험일을 설정하세요.
제품 미디어
체크아웃 및 송장에서 제품을 보여주기 위해 이미지를 업로드하세요. 지원되는 형식은 PNG/JPG/WebP이며 최대 3MB입니다. 언제든지 재정렬하거나 교체할 수 있습니다.
변형 및 가격 옵션
하나의 제품 아래에 변형을 두는 대신, 각 가격 옵션(예: 월간 및 연간)에 대해 별도의 제품을 만드세요. 그런 다음 제품 컬렉션으로 그룹화하여 모든 옵션을 단일 결제에서 제시하고 고객 포털에서 요금제를 전환할 수 있도록 합니다.
이 접근 방식의 이유는?
- 명확한 가격 모델: 각 제품은 단일이며 정의된 가격 모델(일회성, 구독 또는 사용 기반)을 가집니다.
- 예측 가능한 API: 중첩된 변형 로직 없이 간단한 통합을 지원합니다.
- 더 쉬운 보고: 변형 집계 없이 각 제품에 대한 수익 및 메트릭을 추적할 수 있습니다.
- 유연한 결제: 여러 제품을 나란히 표시하여 고객이 비교하고 선택할 수 있도록 합니다.
제품 컬렉션의 작동 방식
- 제품 생성: 각 요금제(예: 시작 월간, 시작 연간, 프로 월간, 프로 연간)에 대한 개별 제품을 설정합니다.
- 컬렉션으로 그룹화: 관련 제품을 제품 컬렉션에 추가합니다.
- 통합 결제: 고객은 하나의 결제에서 모든 옵션을 보고 선호하는 요금제를 선택할 수 있습니다.
- 요금제 전환: 고객은 고객 포털을 통해 동일한 컬렉션 내의 제품 간에 업그레이드 또는 다운그레이드할 수 있습니다.
제품 컬렉션
관련 제품을 함께 그룹화하여 통합된 결제 경험과 원활한 업그레이드/다운그레이드 경로를 제공합니다.
제품 관리
대시보드나 API를 통해 프로그램적으로 제품을 관리할 수 있습니다. API는 제품 생성, 업데이트, 검색, 이미지 업로드 및 보관에 대한 전체 제어를 제공합니다.대시보드 관리
- 업데이트: 이름, 설명, 이미지, 가격, 필드 및 혜택을 언제든지 편집할 수 있습니다(가격 모델은 변경할 수 없습니다).
- 보관: 기존 고객에게 영향을 주지 않으면서 새로운 구매에서 제품을 숨깁니다. 나중에 복원할 수 있습니다.
API 관리
다음 지침을 통해 제품을 생성, 업데이트, 관리 및 검색할 수 있으며, 이미지 업로드도 포함됩니다.제품 생성하기
제품 생성하기
제품은 일회성 항목이거나 구독 기반 서비스일 수 있습니다. 새 제품을 생성하려면
POST 요청을 /products 엔드포인트로 보내며, 이름, 설명, 가격, 통화 및 반복 제품 여부와 같은 세부 정보를 포함합니다.반복 제품의 경우, recurring: true를 설정하고 billing_cycle를 지정합니다(daily, weekly, monthly, yearly).제품 생성 API
제품 생성 API 문서에서 세부 요청 및 응답 구조를 확인하세요.
제품 업데이트하기
제품 업데이트하기
기존 제품을 수정하려면,
PATCH 요청을 /products/{product_id} 엔드포인트로 보냅니다. 이름, 가격 및 설명과 같은 속성을 업데이트하면서 다른 세부정보는 변경하지 않을 수 있습니다.엔드포인트의 product_id가 기존 제품과 일치하는지 확인하십시오.제품 업데이트 API
제품 업데이트 API 문서에서 세부 요청 및 응답 구조를 확인하세요.
제품 검색하기
제품 검색하기
귀하의 계정에 저장된 제품 목록을 검색하려면,
GET 요청을 /products 엔드포인트로 보내십시오. 이를 통해 활성 및 보관된 제품을 포함한 제품 세부정보를 검색할 수 있습니다.제품 검색 API
제품 검색 API 문서에서 세부 요청 및 응답 구조를 확인하세요.
제품 이미지 업로드하기
제품 이미지 업로드하기
AWS S3에 이미지를 업로드하여 제품에 이미지를 연결할 수 있습니다. API에서 제공하는 사전 서명된 URL을 사용하여 업로드합니다. 먼저
/products/{product_id}/images 엔드포인트에서 이미지 업로드 URL을 요청한 다음, 제공된 URL을 사용하여 60초 내에 이미지를 업로드합니다.API에서 사전 서명된 URL을 수신한 후, PUT 메서드를 사용하여 이미지를 업로드합니다. 이는 이미지를 업로드할 때 AWS S3에 대한 안전하고 일시적인 액세스를 보장합니다.S3에 업로드하기 위한 지원 라이브러리:- Node.js:
axios,node-fetch - Python:
requests,boto3 - Go:
net/http - PHP:
GuzzleHttp - Ruby:
rest-client
200 OK 상태를 반환하며, 이는 이미지가 성공적으로 저장되었음을 나타냅니다.제품 이미지 업로드 API
제품 이미지 업로드 API 문서에서 세부 요청 및 응답 구조를 확인하세요.
제품 아카이빙하기
제품 아카이빙하기
더 이상 제품을 표시하거나 사용하고 싶지 않은 경우,
POST 요청을 /products/{product_id}/archive 엔드포인트로 보내어 아카이브할 수 있습니다. 이 작업은 제품을 숨기지만 영구적으로 삭제하지는 않습니다.제품 아카이브 API
제품 아카이브 API 문서에서 세부 요청 및 응답 구조를 확인하세요.
제품 복원하기
제품 복원하기
아카이브된 제품을 복원해야 하는 경우,
POST 요청을 /products/{product_id}/unarchive 엔드포인트로 보냅니다. 이 작업은 제품을 재활성화하여 다시 사용할 수 있도록 합니다.제품 복원 API
제품 복원 API 문서에서 세부 요청 및 응답 구조를 확인하세요.
결제 및 이행
결제 및 이행
제품에서 결제 또는 구독 흐름을 생성하고, 혜택 및 웹후크를 통해 자동으로 이행합니다.
모범 사례
- 명확함으로 시작하기: 각 가격 옵션(월간 vs 연간)에 대해 별도의 제품을 사용하세요.
- 신중하게 트라이얼 이용하기: 트라이얼을 온보딩과 짝지어 활성화를 촉진하세요.
- 이행 자동화하기: 혜택 및 웹후크를 사용하여 즉시 제공하세요.
- 메타데이터로 태깅하기: 조정을 위해 시스템 ID를 저장하세요.
제품을 생성하고 판매를 시작할 준비가 되었습니다 - 일회성, 반복 또는 사용 기준입니다.
