메인 콘텐츠로 건너뛰기
제품은 Dodo Payments의 기초입니다. 일회성 다운로드, 반복 구독 또는 사용 기반 액세스를 판매하든, 제품을 생성하는 것부터 시작합니다. 각 제품은 가격 책정, 체크아웃 시 표시 방법 및 구매 후 이행 방법을 정의합니다.

일회성

평생 액세스 또는 단일 제공물에 대해 한 번만 청구합니다.

구독

시험, 비례 배분 및 추가 기능과 함께 일정에 따라 청구합니다.

사용 기반

소비를 측정하고 실제 사용량에 따라 청구합니다.

​
제품 생성

대시보드 또는 API를 통해 제품을 생성할 수 있습니다. 가격 모델을 미리 선택하고, 일회성, 구독 또는 사용 기반으로 설정한 후 세부 정보를 구성하세요. 가격 모델은 나중에 변경할 수 없으므로, 다른 모델이 필요하면 새 제품을 생성하세요.
1

이름 및 설명

명확한 제목과 간결한 가치 중심 설명을 제공하세요. 설명에는 Markdown이 지원됩니다.
첫 문장은 고객을 대상으로 하고 결과 지향적으로 유지하세요. 체크아웃에서 두드러지게 나타납니다.
제품
2

가격 모델 및 가격

가격 모델을 선택하세요:
  • 일회성: 한 번 지불하는 고정 가격.
  • 구독: 간격과 선택적 시험이 있는 반복 가격.
  • 사용 기반: 측정된 이벤트에서 파생된 가격.
그런 다음 가격을 설정하세요:
  • 가격: 기본 금액 및 통화.
  • 할인 (%): 체크아웃 및 송장에 표시되는 선택적 인라인 할인.
  • 구독의 경우, 필요에 따라 매 반복(예: 1개월 또는 1년) 및 시험일을 설정하세요.
가격 변경은 새로운 구매에만 영향을 미칩니다. 기존 구독은 계획 변경 규칙을 따릅니다.
3

제품 미디어

체크아웃 및 송장에서 제품을 보여주기 위해 이미지를 업로드하세요. 지원되는 형식은 PNG/JPG/WebP이며 최대 3MB입니다. 언제든지 재정렬하거나 교체할 수 있습니다.
4

자동 권한 (고급 설정에서)

지불 후 자동으로 활성화되는 이행을 첨부하세요:
  • 라이센스 키: 고유 키 발급 및 검증
  • 파일 다운로드: 안전한 파일 액세스 부여
  • 사용자 정의: 웹훅을 통해 자체 권한 논리 트리거
제공이 발전함에 따라 혜택을 추가하거나 제거하세요. 기존 구독자는 그에 따라 액세스를 얻거나 잃습니다.

​
변형 및 가격 옵션

하나의 제품 아래에서 변형 대신 각 가격 옵션(예: 월간 및 연간)에 대해 별도의 제품을 생성하세요. 동일한 체크아웃에서 여러 제품을 나란히 표시하고 고객이 전환할 수 있도록 하세요.
이렇게 하면 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 문서에서 요청 및 응답 구조를 자세히 확인하세요.
API에서 제공하는 사전 서명된 URL을 사용하여 AWS S3에 이미지를 업로드하여 제품과 연결할 수 있습니다. 먼저 /products/{product_id}/images 엔드포인트에서 이미지 업로드 URL을 요청한 다음, 제공된 URL을 사용하여 60초 이내에 이미지를 업로드하세요.
사전 서명된 URL은 60초 후에 만료되므로, 해당 시간 내에 이미지를 업로드해야 합니다.
API에서 사전 서명된 URL을 받은 후, PUT 메서드를 사용하여 이미지를 업로드하세요. 이를 통해 이미지를 업로드하기 위해 AWS S3에 대한 안전하고 임시 액세스를 보장합니다.S3에 업로드를 위한 지원 라이브러리:
  • Node.js: axios, node-fetch
  • Python: requests, boto3
  • Go: net/http
  • PHP: GuzzleHttp
  • Ruby: rest-client
업로드가 성공하면 AWS S3는 이미지가 성공적으로 저장되었음을 나타내는 200 OK 상태를 반환합니다.

제품 이미지 업로드 API

제품 이미지 업로드 API 문서에서 요청 및 응답 구조를 자세히 확인하세요.
더 이상 제품을 표시하거나 사용하고 싶지 않다면 POST 요청을 /products/{product_id}/archive 엔드포인트로 보내어 제품을 보관할 수 있습니다. 이 작업은 제품을 숨기지만 영구적으로 삭제하지는 않습니다.

제품 보관 API

제품 보관 API 문서에서 요청 및 응답 구조를 자세히 확인하세요.
보관된 제품을 복원해야 하는 경우, POST 요청을 /products/{product_id}/unarchive 엔드포인트로 보내세요. 이렇게 하면 제품이 다시 활성화되어 사용할 수 있게 됩니다.

제품 복원 API

제품 복원 API 문서에서 요청 및 응답 구조를 자세히 확인하세요.
제품에서 결제 또는 구독 흐름을 생성하고, 혜택 및 웹훅을 통해 자동으로 이행하세요.

체크아웃 세션

일회성 또는 구독 구매를 위한 체크아웃 세션을 생성하세요.

결제 웹훅

결제 생애 주기 이벤트에 반응하세요.

구독 웹훅

구독 생성, 갱신 및 취소 이벤트를 처리하세요.

​
모범 사례

  • 명확성으로 시작하세요: 각 가격 옵션(월간 vs 연간)에 대해 별도의 제품을 만드세요.
  • 시험을 신중하게 사용하세요: 활성화를 촉진하기 위해 온보딩과 함께 시험을 결합하세요.
  • 이행 자동화: 혜택 및 웹훅을 사용하여 즉시 제공하세요.
  • 메타데이터로 태그 지정: 조정을 위해 시스템 ID를 저장하세요.
제품을 생성하고 판매를 시작할 준비가 되었습니다 - 일회성, 반복 또는 사용 기반으로.