> ## 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">
    对 payment succeeded/failed 和收据事件做出响应。
  </Card>

  <Card title="Refunds API" icon="code" href="/api-reference/refunds/post-refunds">
    以编程方式创建全部或部分退款。
  </Card>
</CardGroup>

## 什么是一次性付款？

一次性付款是固定的预付购买 - 适合于：

* **软件许可证**：终身或主要版本解锁
* **数字下载**：电子书、模板、图形或插件
* **服务**：审计、入职包或一次性咨询
* **课程和票务**：课程、研讨会或现场会议

## 主要好处

* **简单结账**：没有续订或按比例计算逻辑
* **即时履行**：立即交付许可证或文件
* **灵活定价**：支持折扣和税费
* **以开发者为先**：清晰的 API 用于创建、退款和 Webhook

## 创建一次性产品

在您的 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="一次性付款产品" style={{ maxHeight: '500px', width: 'auto' }} width="1911" height="927" data-path="images/products.png" />
</Frame>

### 产品配置

在仪表板中配置字段，以定义您的产品如何显示和销售。

#### 产品详情

* **产品名称**（必填）：在结账和发票中显示的名称
* **产品描述**（必填）：客户在付款前看到的清晰价值声明
* **产品图片**（必填）：PNG/JPG/WebP，最大 3 MB
* **品牌**：将产品与特定品牌关联以进行主题和电子邮件
* **税务类别**（必填）：选择正确的类别以确定税务规则

<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>