
Dodo Payments 结账页面是面向数字产品和 SaaS 业务的转化优化、全球合规结账。它支持多种货币、语言、税费、折扣、附加项以及企业友好的合规模式。
Checkout Sessions API
通过编程方式创建托管结账会话。
Preview Checkout
在创建会话前计算价格和税费。
Payment Methods
支持的支付方式和配置选项。
通过 Checkout Sessions API 生成的结账链接不可重复使用,并会在 24 小时内过期。请为每位客户和每次付款尝试生成新的 session。
Adaptive Currency
Adaptive Currency 允许客户使用首选的本地货币付款,从而提升信任度和转化率。工作原理
- 启用:从 Settings → Business 中启用 Adaptive Currency
- 选择:客户可以直接在结账页面切换货币
- 应用 PPP:如果产品已启用 Purchasing Power Parity,国家/地区百分比会降低基础价格
- 转换:价格(或经过 PPP 调整的价格)会按照实时 FX 汇率转换为客户的货币
- 取整:如果已启用 Charm Pricing,转换后的金额会取整为类似 49.99 的简洁尾数
- 显示:付款前会透明地显示最终应付金额

Adaptive Currency
详细了解支持的货币、转换费用和退款处理。
多语言结账
Dodo Payments 支持在结账页面使用多种语言,让客户能够以熟悉的语言完成付款。
主要特点
- 可直接在结账页面使用语言选择器
- UI 文本、标签和系统消息均已本地化
- 提升可访问性和国际转化率
支持的语言
结账页面支持 21 种语言:自动税费计算
系统会根据客户的账单地址自动计算税费,确保符合 GST、VAT 和 sales tax 要求,无需手动设置。税费计算方式
1
Location Detection
系统会根据客户所在国家(以及适用时的地区)应用税务规则。
2
Dynamic Updates
以下情况发生时,税额会自动更新:
- 国家/地区发生变化
- 地址更新
3
Transparent Display
付款前会清晰显示最终税费明细。
企业税号支持
对于已注册的企业,结账页面允许客户输入 Business Tax ID(例如 VAT/GST number)。输入税号后会发生什么
- 实时验证税务资格
- 应用适用的税收豁免或 reverse-charge 规则
- 结账页面上的税额即时更新

这对于 B2B SaaS 和数字服务尤其有用,因为企业客户可能符合税收豁免条件。
折扣码
客户可以直接在结账页面使用你在 dashboard 中创建的折扣码或促销码。结账体验
- 客户输入折扣码
- 系统即时验证折扣码
- 清晰显示更新后的价格和节省金额

API 集成
预先应用一个或多个可叠加的折扣码,或启用折扣输入字段:discount_codes 接受最多包含 20 个代码的数组,并按顺序叠加应用。单数形式的 discount_code 字段已弃用,但仍可使用——现有集成无需立即更改。为使用叠加功能和更丰富的响应结构,请在方便时迁移到 discount_codes。Discount Codes
了解如何创建和管理折扣码。
Validate Discount by Code
使用代码名称查找并验证折扣。
智能地址收集
结账支持灵活的地址输入方式,以加快完成速度。可用选项
最小地址模式
为了最大限度地提高转化率,请启用最小地址收集,以减少结账阻力。当minimal_address 设置为 true 时,结账页面只会收集:
- 国家/地区 — 税务确定始终需要
- ZIP/邮政编码 — 仅在销售税、VAT 或 GST 计算所需的地区收集

完整地址收集仍为默认设置。对于不需要完整账单详细信息的数字产品和 SaaS 流程,请启用
minimal_address。Minimal Address Reference
请参阅 Checkout Sessions API 指南中完整的
minimal_address 参数参考。电话号码收集
使用结账会话功能标志控制结账页面是否显示电话号码字段,以及该字段是否为必填项。自定义字段
通过定义自定义表单字段,在结账期间收集客户的其他信息。这适合收集公司名称、团队规模、推荐来源或任何其他特定于业务的信息。可用字段类型
示例
客户响应会自动包含在 webhook payload(
payment.succeeded、subscription.active)以及通过 custom_field_responses 数组返回的 API 响应中。每个结账会话最多可以定义 5 个自定义字段。Custom Fields Guide
详细了解自定义字段配置和响应访问方式。
隐私政策与条款接受
为确保法律和合规透明度:- 结账页面会清晰显示 Privacy Policy 和 Buyer Terms 链接
- 客户在完成付款前必须明确确认这些内容
这有助于满足包括 GDPR 合规在内的全球消费者保护和数据隐私要求。
集合结账
产品集合提供统一的结账体验,客户可以在一次结账中查看并选择多个相关产品(例如 Starter、Pro 和 Enterprise 计划)。工作原理
- 显示所有产品:客户可以看到集合中的每个有效产品
- 预选第一个产品:系统会自动选择集合中的第一个产品
- 比较选项:客户可以在选择前比较价格和功能
- 单项选择:选择产品后,结账会按照标准付款流程继续
创建集合结账
Product Collections
了解如何为统一结账体验创建和管理产品集合。
结账会话配置
使用 Checkout Sessions API 控制结账行为:付款后,客户会被重定向到你的
return_url,系统会自动附加查询参数——包括 payment_id 或 subscription_id、status、email 以及 license_key(如适用)。完整列表请参阅 Checkout Sessions 指南。Checkout Sessions API
结账会话的完整 API 参考。
Checkout Integration Guide
集成结账的分步指南。
结账主题自定义
通过 API 创建结账会话时,使用customization.theme_config 参数自定义结账页面外观,使其符合你的品牌风格。你可以为浅色和深色模式配置颜色、字体、边框半径和按钮文本。

Design & Theme Customization
从控制台以可视化方式配置主题,包括预构建主题、字体排版、颜色和实时预览。
本节介绍使用
customization.theme_config 进行 server-side API 主题配置。如果你使用的是 Checkout SDK(叠加式或内嵌式结账),请参阅 Overlay Checkout 中的主题自定义部分,该部分使用 camelCase 属性(例如使用 bgPrimary,而不是 bg_primary)。主题配置选项
颜色配置(浅色/深色模式)
每种模式(light 和 dark)都支持以下颜色属性:
所有颜色字段都接受标准 CSS 颜色格式:
- Hex:
#fff、#ffffff、#ffffffff - RGB/RGBA:
rgb(255, 255, 255)、rgba(255, 255, 255, 0.5) - HSL/HSLA:
hsl(120, 100%, 50%)、hsla(120, 100%, 50%, 0.5) - 命名颜色:
red、blue、transparent