Skip to main content
일회성 결제를 사용하면 한 번의 결제로 평생 이용권, 다운로드 또는 일회성 서비스를 판매할 수 있습니다. 갱신, 일할 계산 규칙 또는 결제 주기가 필요하지 않습니다.

License Keys

구매 후 고유 라이선스 키를 발급하세요.

Digital Delivery

결제 후 파일 및 콘텐츠를 자동으로 전달하세요.

Payment Webhooks

결제 성공 및 실패 이벤트에 반응하세요.

Refunds API

전체 또는 부분 환불을 프로그래밍 방식으로 생성하세요.

일회성 결제가 무엇인가요?

일회성 결제는 다음에 적합한 고정 금액의 선불 구매입니다:
  • 소프트웨어 라이선스: 평생 이용권 또는 주요 버전 잠금 해제.
  • 디지털 다운로드: 전자책, 템플릿, 그래픽 또는 플러그인.
  • 서비스: 감사, 온보딩 패키지 또는 일회성 컨설팅.
  • 강좌 및 티켓: 강좌, 워크숍 또는 라이브 세션.

주요 이점

  • 간편한 checkout: 갱신 또는 일할 계산 로직이 필요하지 않습니다.
  • 즉시 이행: 라이선스 또는 파일을 즉시 전달합니다.
  • 유연한 가격 책정: 할인 및 세금을 지원합니다.
  • 개발자 우선: 생성, 환불 및 웹훅을 위한 명확한 API를 제공합니다.

일회성 제품 만들기

Dodo Payments 대시보드에서 제품을 생성한 후, 호스팅된 체크아웃, 결제 링크 또는 API를 통해 판매합니다.
일회성 결제 제품 대시보드

제품 구성

대시보드에서 필드를 구성하여 제품이 어떻게 표시되고 판매되는지를 정의합니다.

제품 세부 정보

  • 제품 이름 (필수): checkout 및 인보이스에 표시되는 이름입니다.
  • 제품 설명: 결제 전에 고객에게 표시되는 명확한 가치 설명입니다.
  • 제품 이미지: 최대 3MB의 PNG, JPG 또는 WebP입니다.
  • 브랜드: 테마 및 이메일에 사용할 특정 브랜드를 제품에 연결합니다.
  • 세금 카테고리 (필수): 세금 규칙을 결정할 올바른 카테고리를 선택합니다.
지역별로 정확한 세금 징수를 위해 가장 정확한 세금 범주를 선택하세요.

가격

  • 가격 유형: One Time을 선택합니다.
  • 가격 (필수): 통화가 포함된 고정 금액입니다.
  • 할인 적용 가능 (%): checkout 및 인보이스에 표시되는 선택적 백분율 할인입니다.
제품 가격을 변경해도 신규 구매에만 영향을 줍니다. 기존 고객에게는 영향을 주지 않습니다.

고급 설정

이러한 선택적 설정은 제품 양식의 Pricing, Entitlements, Meta Data 섹션에 있습니다:
  • Tax Inclusive Pricing(Pricing): 적용 가능한 세금을 포함한 가격을 표시합니다.
  • License key(Entitlements): 구매 후 고유 키를 발급합니다. License Keys를 참조하세요.
  • Digital Files(Entitlements): 파일 또는 콘텐츠를 자동으로 제공합니다. Digital Product Delivery를 참조하세요.
  • Meta Data: 내부 태깅 또는 통합을 위해 사용자 지정 키-값 쌍을 연결합니다. Metadata를 참조하세요.
시스템의 식별자(예: orderId)를 메타데이터에 저장하면 나중에 이벤트와 영수증을 대조할 수 있습니다.

API 관리

POST /checkouts를 사용하여 제품에 대한 일회성 결제를 수집하는 checkout session을 생성합니다.

API Reference

결제 생성 API를 확인하세요.
POST /refunds를 사용하여 전액 또는 일부 환불을 생성합니다.

API Reference

결제 환불 방법을 알아보세요.
GET /payments를 사용하여 결제 목록을 조회하고, GET /payments/{payment_id}를 사용하여 결제 하나를 조회합니다. GET /payments/{payment_id}/line-items를 사용하여 line items를 조회합니다.

List Payments

목록 API를 살펴보세요.

Get Payment Detail

조회 API를 확인하세요.

Retrieve Line Items

결제에 포함된 구매 항목을 검사합니다.
백엔드에서 payment.succeeded 또는 payment.failed와 같은 이벤트에 반응합니다.

Webhook Guide

결제 수명 주기 이벤트를 처리합니다.

일반적인 사용 사례

  • 라이선스 기반 도구: 일회성 키로 기능을 잠금 해제합니다.
  • 디지털 자산: 테마, 템플릿, 아이콘 세트 또는 미디어.
  • 전문 서비스: 고정 요금의 구현 또는 설정.
  • 교육: 강좌 티켓 및 일회성 워크숍.

통합 예시

Checkout Sessions (Single Payment)

장바구니에 일회성 제품이 포함된 checkout session을 생성합니다:

모범 사례

  • 제공 항목을 명확히 설명: 구매자가 무엇을 받는지, 어떻게 전달되는지 정확히 알려주세요.
  • 즉시 전달: 즉시 액세스할 수 있도록 라이선스 키 또는 디지털 전달을 사용하세요.
  • 메타데이터로 추적: 쉽게 대조할 수 있도록 ID를 저장하세요.
마지막 수정일 2026년 9월 28일