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。
API 管理
Create Payments
Create Payments
使用
POST /checkouts 创建结账会话,以便为您的产品收取一次性付款。API Reference
查看创建付款 API。
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 获取行项目。List Payments
浏览列表 API。
Get Payment Detail
请参阅获取 API。
Retrieve Line Items
查看付款中的已购买项目。
Payment Webhooks
Payment Webhooks
在您的后端对 payment.succeeded 或 payment.failed 等事件作出响应。
Webhook Guide
处理付款生命周期事件。
常见使用场景
- 基于许可证的工具:使用一次性密钥解锁功能。
- 数字资产:主题、模板、图标集或媒体内容。
- 专业服务:固定费用的实施或设置服务。
- 教育:课程门票和一次性研讨会。
集成示例
结账会话(单笔付款)
创建一个购物车中包含一次性产品的结账会话:最佳实践
- 明确交付内容:准确告知买家他们将获得什么以及如何交付。
- 即时交付:使用许可证密钥或数字交付,以便立即访问。
- 使用元数据进行跟踪:存储您的 ID,便于对账。