License Keys
Digital Delivery
Payment Webhooks
Refunds API
일회성 결제가 무엇인가요?
일회성 결제는 다음에 적합한 고정 금액의 선불 구매입니다:- 소프트웨어 라이선스: 평생 이용권 또는 주요 버전 잠금 해제.
- 디지털 다운로드: 전자책, 템플릿, 그래픽 또는 플러그인.
- 서비스: 감사, 온보딩 패키지 또는 일회성 컨설팅.
- 강좌 및 티켓: 강좌, 워크숍 또는 라이브 세션.
주요 이점
- 간편한 checkout: 갱신 또는 일할 계산 로직이 필요하지 않습니다.
- 즉시 이행: 라이선스 또는 파일을 즉시 전달합니다.
- 유연한 가격 책정: 할인 및 세금을 지원합니다.
- 개발자 우선: 생성, 환불 및 웹훅을 위한 명확한 API를 제공합니다.
일회성 제품 만들기
Dodo Payments 대시보드에서 제품을 생성한 후, 호스팅된 체크아웃, 결제 링크 또는 API를 통해 판매합니다.
제품 구성
대시보드에서 필드를 구성하여 제품이 어떻게 표시되고 판매되는지를 정의합니다.제품 세부 정보
- 제품 이름 (필수): checkout 및 인보이스에 표시되는 이름입니다.
- 제품 설명: 결제 전에 고객에게 표시되는 명확한 가치 설명입니다.
- 제품 이미지: 최대 3MB의 PNG, JPG 또는 WebP입니다.
- 브랜드: 테마 및 이메일에 사용할 특정 브랜드를 제품에 연결합니다.
- 세금 카테고리 (필수): 세금 규칙을 결정할 올바른 카테고리를 선택합니다.
가격
- 가격 유형: 일회성을 선택합니다.
- 가격(필수): 통화가 포함된 고정 요금입니다.
- 할인 적용 가능(%): 결제 및 청구서에 표시되는 선택적 백분율 할인입니다.
10.5와 같이 소수점 이하 두 자리까지 입력할 수 있습니다. API에서는1050을 사용합니다(기준점 단위이므로1050은 10.5%입니다).
고급 설정
이러한 선택적 설정은 제품 양식의 Pricing, Entitlements, Meta Data 섹션에 있습니다:- Tax Inclusive Pricing(Pricing): 적용 가능한 세금을 포함한 가격을 표시합니다.
- License key(Entitlements): 구매 후 고유 키를 발급합니다. License Keys를 참조하세요.
- Digital Files(Entitlements): 파일 또는 콘텐츠를 자동으로 제공합니다. Digital Product Delivery를 참조하세요.
- Meta Data: 내부 태깅 또는 통합을 위해 사용자 지정 키-값 쌍을 연결합니다. Metadata를 참조하세요.
API 관리
Create Payments
Create Payments
POST /checkouts를 사용하여 제품에 대한 일회성 결제를 수집하는 checkout session을 생성합니다.API Reference
Refund Payments
Refund Payments
POST /refunds를 사용하여 전액 또는 일부 환불을 생성합니다.API Reference
List and Retrieve Payments
List and Retrieve Payments
GET /payments를 사용하여 결제 목록을 조회하고, GET /payments/{payment_id}를 사용하여 결제 하나를 조회합니다. GET /payments/{payment_id}/line-items를 사용하여 line items를 조회합니다.List Payments
Get Payment Detail
Retrieve Line Items
Payment Webhooks
Payment Webhooks
백엔드에서 payment.succeeded 또는 payment.failed와 같은 이벤트에 반응합니다.
Webhook Guide
일반적인 사용 사례
- 라이선스 기반 도구: 일회성 키로 기능을 잠금 해제합니다.
- 디지털 자산: 테마, 템플릿, 아이콘 세트 또는 미디어.
- 전문 서비스: 고정 요금의 구현 또는 설정.
- 교육: 강좌 티켓 및 일회성 워크숍.
통합 예시
Checkout Sessions (Single Payment)
장바구니에 일회성 제품이 포함된 checkout session을 생성합니다:모범 사례
- 제공 항목을 명확히 설명: 구매자가 무엇을 받는지, 어떻게 전달되는지 정확히 알려주세요.
- 즉시 전달: 즉시 액세스할 수 있도록 라이선스 키 또는 디지털 전달을 사용하세요.
- 메타데이터로 추적: 쉽게 대조할 수 있도록 ID를 저장하세요.