> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 일회성 결제

> 고정 가격의 디지털 상품이나 서비스를 단일 선불 요금으로 판매하며, 갱신이 없습니다.

<Info>
  일회성 결제를 통해 단일 요금으로 평생 접근, 다운로드 또는 단발성 서비스를 판매할 수 있습니다. 갱신, 비례 계산 규칙 또는 결제 주기가 없습니다. 깔끔하고 즉각적인 구매 경험뿐입니다.
</Info>

<CardGroup cols={2}>
  <Card title="License Keys" icon="code" href="/features/license-keys">
    구매 후 고유 라이선스 키를 발급하세요.
  </Card>

  <Card title="Digital Delivery" icon="code" href="/features/digital-product-delivery">
    결제 후 파일 및 콘텐츠를 자동으로 전달하세요.
  </Card>

  <Card title="Payment Webhooks" icon="code" href="/developer-resources/webhooks/intents/payment">
    결제 성공/실패 및 영수증 이벤트에 대응하세요.
  </Card>

  <Card title="Refunds API" icon="code" href="/api-reference/refunds/post-refunds">
    전체 또는 부분 환불을 프로그래밍 방식으로 생성하세요.
  </Card>
</CardGroup>

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

일회성 결제는 고정된 선불 구매로, 다음과 같은 경우에 이상적입니다:

* **소프트웨어 라이센스**: 평생 또는 주요 버전 잠금 해제
* **디지털 다운로드**: 전자책, 템플릿, 그래픽 또는 플러그인
* **서비스**: 감사, 온보딩 패키지 또는 일회성 컨설팅
* **강의 및 티켓**: 강의, 워크숍 또는 라이브 세션

## 주요 이점

* **간단한 체크아웃**: 갱신이나 비례 배분 로직 없음
* **즉각적인 이행**: 라이센스나 파일을 즉시 배달
* **유연한 가격**: 할인 및 세금 지원
* **개발자 우선**: 생성, 환불 및 웹훅을 위한 명확한 API

## 일회성 제품 만들기

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

<Frame>
  <img src="https://mintcdn.com/dodopayments/r-ndtvzx3WhKqwER/images/products.png?fit=max&auto=format&n=r-ndtvzx3WhKqwER&q=85&s=fb41221c4f2af4de0155e71de1ac6904" alt="One-Time Payment Products" width="1911" height="927" data-path="images/products.png" />
</Frame>

### 제품 구성

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

#### 제품 세부정보

* **제품 이름** (필수): 체크아웃 및 청구서에 표시되는 이름
* **제품 설명** (필수): 고객이 결제 전에 보는 명확한 가치 설명
* **제품 이미지** (필수): 최대 3MB의 PNG/JPG/WebP
* **브랜드**: 테마 및 이메일을 위해 특정 브랜드와 제품을 연결
* **세금 카테고리** (필수): 세금 규칙을 결정하기 위해 올바른 카테고리 선택

<Tip>
  지역별로 정확한 세금 징수를 위해 가장 정확한 세금 범주를 선택하세요.
</Tip>

#### 가격

* **가격 유형**: <b>단일 결제</b> 선택
* **가격** (필수): 통화가 포함된 고정 요금
* **적용 가능한 할인 (%)**: 체크아웃 및 청구서에 표시되는 선택적 비율 할인

<Warning>
  상품 가격 변경은 새로운 구매에만 영향을 미칩니다. 기존 고객은 영향을 받지 않습니다.
</Warning>

#### 고급 설정

* **세금 포함 가격**: 적용 가능한 세금을 포함한 가격 표시
* **라이센스 키 생성**: 구매 후 고유 키를 발급합니다. <a href="/features/license-keys">라이센스 키</a>를 참조하세요.
* **디지털 제품 배달**: 파일이나 콘텐츠를 자동으로 배달합니다. <a href="/features/digital-product-delivery">디지털 제품 배달</a>를 참조하세요.
* **메타데이터**: 내부 태깅이나 통합을 위해 사용자 정의 키-값 쌍을 첨부합니다. <a href="/api-reference/metadata">메타데이터</a>를 참조하세요.

<Tip>
  이후 이벤트 및 영수증을 조정할 수 있도록 메타데이터에 시스템 식별자(예: orderId)를 저장하세요.
</Tip>

## API 관리

<AccordionGroup>
  <Accordion title="Create payments">
    제품에서 일회성 요금을 생성하려면 `POST /checkouts`를 사용하세요.

    <Card title="API Reference" icon="code" href="/api-reference/checkout-sessions/create">
      결제 생성 API를 확인하세요.
    </Card>
  </Accordion>

  <Accordion title="Refund payments">
    전체 또는 부분 환불을 생성하려면 `POST /refunds`을 사용하세요.

    <Card title="API Reference" icon="code" href="/api-reference/refunds/post-refunds">
      결제 환불 방법을 알아보세요.
    </Card>
  </Accordion>

  <Accordion title="List and retrieve payments">
    결제를 나열하려면 `GET /payments`를, 결제 한 건을 조회하려면 `GET /payments/{payment_id}`를 사용하세요. 항목은 `GET /payments/{payment_id}/line-items`로 가져오세요.

    <Card title="List Payments" icon="code" href="/api-reference/payments/get-payments">
      목록 API를 살펴보세요.
    </Card>

    <Card title="Get Payment Detail" icon="code" href="/api-reference/payments/get-payments-1">
      조회 API를 확인하세요.
    </Card>

    <Card title="Retrieve Line Items" icon="code" href="/api-reference/payments/retrieve-line-items">
      결제된 항목을 검사하세요.
    </Card>
  </Accordion>

  <Accordion title="Payment webhooks">
    백엔드에서 payment.succeeded 또는 payment.failed와 같은 이벤트에 대응하세요.

    <Card title="Webhook Guide" icon="code" href="/developer-resources/webhooks/intents/payment">
      결제 수명주기 이벤트를 처리하세요.
    </Card>
  </Accordion>
</AccordionGroup>

## 일반적인 사용 사례

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

## 통합 예시

### 체크아웃 세션 (단일 결제)

장바구니에 일회성 제품이 있는 체크아웃 세션을 생성합니다:

```typescript theme={null}
const session = await client.checkoutSessions.create({
  product_cart: [
    { product_id: 'prod_one_time', quantity: 1 }
  ]
});
```

## 모범 사례

* **전달물 명확히 하기**: 구매자에게 정확히 무엇을 받고 어떻게 전달되는지 알려주세요.
* **즉시 전달**: 라이센스 키 또는 디지털 배달을 사용하여 즉각적인 접근을 제공합니다.
* **메타데이터로 추적**: 조정을 쉽게 하기 위해 ID를 저장합니다.

<Info>
  일회성 결제는 정액제 상품을 판매하기 위한 가장 빠른 경로입니다. 단순하게 시작하고, 전달을 검증하며, 전환율과 피드백을 기반으로 제안을 반복하세요.
</Info>