Skip to main content
一次性付款让您可以通过单笔收费销售终身访问权限、下载内容或一次性服务。不会产生续费、按比例计费规则或计费周期。

License Keys

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

Digital Delivery

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

Payment Webhooks

对付款成功和失败事件作出响应。

Refunds API

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

什么是一次性付款?

一次性付款是固定金额的预付款,适用于:
  • 软件许可证:终身使用权或主要版本解锁。
  • 数字下载内容:电子书、模板、图形或插件。
  • 服务:审计、入门服务包或一次性咨询。
  • 课程和门票:课程、研讨会或现场活动。

主要好处

  • 简单结账:无需续费或按比例计费逻辑。
  • 即时交付:立即交付许可证或文件。
  • 灵活定价:支持折扣和税费。
  • 开发者优先:提供用于创建、退款和 Webhook 的清晰 API。

创建一次性产品

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

产品配置

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

产品详情

  • 产品名称(必填):在结账和发票中显示的名称。
  • 产品描述:客户付款前看到的清晰价值说明。
  • 产品图片:PNG、JPG 或 WebP 格式,大小不超过 3 MB。
  • 品牌:将产品关联到特定品牌,以应用主题和电子邮件样式。
  • 税务类别(必填):选择正确的类别以确定税务规则。
选择最准确的税务类别,以确保按地区正确征税。

定价

  • 定价类型:选择 一次性。
  • 价格(必填):包含货币的固定费用。
  • 适用折扣 (%):可选的百分比折扣,会显示在结账页面和发票中。最多可输入两位小数,例如 10.5。在 API 中,使用 discount_bps(基点,因此 1050 表示 10.5%)。
更改产品价格只会影响新购买。不会影响现有客户。

高级设置

这些可选设置位于产品表单的 定价、权益 和 元数据 部分:
  • 含税定价(位于 定价):显示包含适用税费的价格。
  • 许可证密钥(位于 权益):购买后签发唯一密钥。请参阅许可证密钥。
  • 数字文件(位于 权益):自动交付文件或内容。请参阅数字产品交付。
  • 元数据:附加自定义键值对,用于内部标记或集成。请参阅Metadata。
使用元数据存储您系统中的标识符(例如 orderId),以便之后对账事件和收据。

API 管理

使用 POST /checkouts 创建结账会话,以便为您的产品收取一次性付款。

API Reference

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

API Reference

了解如何退款付款。
使用 GET /payments 列出付款,并使用 GET /payments/{payment_id} 获取单笔付款。使用 GET /payments/{payment_id}/line-items 获取行项目。

List Payments

浏览列表 API。

Get Payment Detail

请参阅获取 API。

Retrieve Line Items

查看付款中的已购买项目。
在您的后端对 payment.succeeded 或 payment.failed 等事件作出响应。

Webhook Guide

处理付款生命周期事件。

常见使用场景

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

集成示例

结账会话(单笔付款)

创建一个购物车中包含一次性产品的结账会话:

最佳实践

  • 明确交付内容:准确告知买家他们将获得什么以及如何交付。
  • 即时交付:使用许可证密钥或数字交付,以便立即访问。
  • 使用元数据进行跟踪:存储您的 ID,便于对账。
最后修改于 2026年9月28日