跳转到主要内容
一次性付款让您可以通过一次收费销售终身访问、下载或单次使用的服务。没有续订、按比例计算规则或账单周期。只有一个干净、即时的购买体验。

许可证密钥

购买后发放唯一的许可证密钥。

数字交付

付款后自动交付文件和内容。

支付 Webhook

对支付成功/失败和收据事件做出反应。

退款 API

以编程方式创建全额或部分退款。

​
什么是一次性付款？

一次性付款是固定的预付购买 - 适合于：
  • 软件许可证：终身或主要版本解锁
  • 数字下载：电子书、模板、图形或插件
  • 服务：审计、入职包或一次性咨询
  • 课程和票务：课程、研讨会或现场会议

​
主要好处

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

​
创建一次性产品

在您的 Dodo Payments 仪表板中创建产品，然后通过托管结账、支付链接或您的 API 销售它们。
一次性付款产品

​
产品配置

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

​
产品详情

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

​
定价

  • 定价类型：选择 单次付款
  • 价格（必填）：固定收费及货币
  • 适用折扣 (%)：可选的百分比折扣，在结账和发票中显示
更改产品定价仅影响新购买。现有客户不受影响。

​
高级设置

  • 含税定价：显示包含适用税费的价格
  • 生成许可证密钥：购买后发放唯一密钥。请参见 许可证密钥
  • 数字产品交付：自动交付文件或内容。请参见 数字产品交付
  • 元数据：附加自定义键值对以进行内部标记或集成。请参见 元数据
使用元数据存储您系统中的标识符（例如，orderId），以便稍后对事件和收据进行对账。

​
API 管理

使用 POST /checkout-sessions/create 从产品创建一次性收费。

API 参考

查看创建支付的 API。
使用 POST /refunds 创建全额或部分退款。

API 参考

了解如何退款。
使用 GET /payments 列出支付，使用 GET /payments/{payment_id} 检索一笔支付。使用 GET /payments/{payment_id}/line-items 检索行项目。

列出支付

浏览列出支付的 API。

获取支付详情

查看检索 API。

检索行项目

检查支付的购买项目。
对您的后端中的 payment.succeeded 或 payment.failed 等事件做出反应。

Webhook 指南

处理支付生命周期事件。

​
常见用例

  • 基于许可证的工具：使用一次性密钥解锁功能
  • 数字资产：主题、模板、图标集或媒体
  • 专业服务：固定费用的实施或设置
  • 教育：课程票和一次性研讨会

​
集成示例

​
结账会话（单次付款）

创建一个包含一次性产品的结账会话： 
const session = await client.checkoutSessions.create({
  product_cart: [
    { product_id: 'prod_one_time', quantity: 1 }
  ]
});

​
最佳实践

  • 明确交付物：告诉买家他们确切会得到什么以及如何交付
  • 即时交付：使用许可证密钥或数字交付以获得即时访问
  • 使用元数据跟踪：存储您的 ID 以便于对账
一次性付款是销售固定价格产品的最快途径。开始简单，验证交付，并根据转化率和反馈迭代您的报价。