先买后付（BNPL） - Dodo Payments Documentation

先买后付（BNPL）使客户能够将购买分成无利息的分期付款，这样可以将平均订单价值提高20-50%，并使合格交易的转化率提高10-30%。

为什么要提供BNPL？

Higher AOV

当顾客可以分期付款时，他们会花更多钱。平均订单价值增加20-50%。

Better Conversion

在结账时移除支付障碍。高价商品的转化率提高10-30%。

Zero Risk

BNPL提供商负责信用风险与催收。您可以提前收到全额付款。

支持的提供商

Klarna

特性	详情
可用性	美国 + 19个欧洲国家
货币	美元（USD）、欧元（EUR）、英镑（GBP）、丹麦克朗（DKK）、挪威克朗（NOK）、瑞典克朗（SEK）、捷克克朗（CZK）、罗马尼亚列伊（RON）、波兰兹罗提（PLN）、瑞士法郎（CHF）
最低金额	$50.01（或等值）
订阅	否

支持的国家： 奥地利、比利时、捷克共和国、丹麦、芬兰、法国、德国、希腊、爱尔兰、意大利、荷兰、挪威、波兰、葡萄牙、罗马尼亚、西班牙、瑞典、瑞士、英国、美国 支付选项：

分4期付款 — 分为4个无息付款
30天内付款 — 30天内全额付款到期
融资 — 更长期的分期付款计划

Afterpay (Clearpay)

特性	详情
可用性	美国、英国
货币	美元（USD）、英镑（GBP）
最低金额	$50.01（或等值）
订阅	否

支付选项：

分4期付款 — 每两周分4个无息付款

在英国，Afterpay以“Clearpay”运营，但使用相同的API类型 (afterpay_clearpay)。

Billie

特性	详情
可用性	全球
货币	英镑（GBP）
最低金额	无
订阅	否

关于Billie： Billie是一个B2B的先买后付解决方案，使企业能够为客户提供灵活的付款条款。它旨在用于买家需要基于发票的付款选项的商业交易。 支付选项：

发票付款 — 在约定的付款条款内付款
灵活条款 — 对企业友好的付款计划

Sunbit

功能	详情
可用性	美国
货币	美元
最低	$60.00
最高	$19,999.00
订阅	否

支付选项：

分期融资 — 将购买拆分为可管理的每月付款

配置

API 方法类型

类型	供应商
`klarna`	Klarna
`afterpay_clearpay`	Afterpay / Clearpay
`billie`	Billie (B2B)
`sunbit`	Sunbit

示例

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_123', quantity: 1 }],
  allowed_payment_method_types: [
    'klarna',
    'afterpay_clearpay',
    'credit',
    'debit'
  ],
  customer: {
    email: 'customer@example.com',
    name: 'Jane Smith'
  },
  billing_address: {
    country: 'US',
    zipcode: '10001'
  },
  return_url: 'https://example.com/success'
});

始终包含 credit 和 debit 作为备用选项。并非所有客户都符合 BNPL 的资格，低于供应商最低限额的交易将不符合资格。

交易金额限制

每个 BNPL 供应商都有自己的最低（有时是最高）交易金额：

供应商	最低	最高
Klarna	$50.01	—
Afterpay	$50.01	—
Sunbit	$60.00	$19,999.00

不在这些阈值内的交易：

结账时不会出现 BNPL 选项
不会触发错误 — 选项只是不显示
卡支付仍然可用

这是预期的行为。如果您的产品价格不太可能在供应商支持的范围内，请勿在 allowed_payment_method_types 中包含 BNPL 方法。

分期付款的工作原理

关键点：

您从 BNPL 供应商那里获得 全额预付款
BNPL 供应商负责 信用风险和收款
客户直接向供应商支付 4 次分期付款（通常）
没有分期付款失败的退款 — 这是供应商的风险

测试

Klarna 测试数据

在测试模式下使用这些详细信息：

字段	批准	拒绝
出生日期	07-10-1970	07-10-1970
名字	Test	Test
姓氏	Person-us	Person-us
电子邮件	customer@email.us	customer+denied@email.us
街道	Amsterdam Ave	Amsterdam Ave
门牌号	509	509
城市	New York	New York
州	New York	New York
邮政编码	10024-3941	10024-3941
电话	+13106683312	+13106354386

交易至少需 $50 才会显示 Klarna 作为选项。

Afterpay 测试

Select Afterpay

结账时选择 Afterpay 并点击支付。

Successful payment

使用任何有效的电子邮件和送货地址。

Failed authentication

测试失败：在重定向页面关闭 Afterpay 模态窗口。支付状态转换为 requires_payment_method。

Sunbit 测试

Set billing country and currency

确保结账会话设置 billing_address.country 为 US 并设置 billing_currency 为 USD。

Use a qualifying amount

设置交易金额在 $60.00 和$ 19,999.00 之间。Sunbit 不会出现在此范围之外。

Select Sunbit

在结账时选择 Sunbit 并完成 Sunbit 模态中的融资申请流程。

Test failure

要模拟被拒绝的申请，在完成流程前关闭 Sunbit 模态。支付状态转换为 requires_payment_method。

Sunbit 仅适用于以美元支付的美国客户，交易金额在

60.00 至

19,999.00 之间。

最佳实践

Target high-ticket items

BNPL 最适用于

100-

1000 的产品。“分期付款”的价值主张在此范围内最具吸引力。

Show installment amounts

“4 次付款

25” 比“

100 使用 Klarna” 更具吸引力。尽可能显示每次付款金额。

Don't force BNPL for low-value products

低于

50 时，BNPL 无法显示。低于

100 时，大多数客户更倾向于使用卡支付。将 BNPL 推广集中于高价商品。

Collect billing address

BNPL 供应商需要账单信息进行信用检查。确保您的结账收集完整地址详情。

Set clear expectations

客户应了解他们与 Klarna/Afterpay 而不是与您达成借款协议。

限制

无订阅

BNPL 支付方式不支持定期付款。对于订阅产品，请使用卡或其他支持定期付款的方法。

基于信用的批准

BNPL 供应商进行即时信用检查。并非所有客户都会被批准。批准率因以下因素而异：

客户在供应商处的信用历史
交易金额
客户所在地

货币与国家映射

每种货币仅限于其相应区域：

货币	支持的国家
美元	仅限于美国
欧元	所有支持的欧洲国家（奥地利、比利时、捷克共和国、丹麦、芬兰、法国、德国、希腊、爱尔兰、意大利、荷兰、挪威、波兰、葡萄牙、罗马尼亚、西班牙、瑞典、瑞士）
英镑	英国和所有支持的欧洲国家

Klarna 支持的其他货币（丹麦克朗、挪威克朗、瑞典克朗、捷克克朗、罗马尼亚列伊、波兰兹罗提、瑞士法郎）在各自的国家中可用。

例如，美元交易仅向美国客户显示 BNPL 选项。欧元交易将在所有支持的欧洲国家显示 BNPL 选项。英镑交易将在英国和所有支持的欧洲国家向客户显示 BNPL 选项。

供应商	支持的货币
Klarna	美元、欧元、英镑、丹麦克朗、挪威克朗、瑞典克朗、捷克克朗、罗马尼亚列伊、波兰兹罗提、瑞士法郎
Afterpay	美元（美国）、英镑（英国）
Sunbit	美元（美国）

故障排除

BNPL not appearing at checkout

检查：

交易金额是否在供应商支持的范围内？（Klarna/Afterpay：最低 $50.01；Sunbit：$ 60.00–$19,999.00）
客户位置是否在支持的国家？
货币是否被 BNPL 供应商支持？
BNPL 方法是否包含在 allowed_payment_method_types 中？

**解决方案：**最常见的是交易低于最低或高于最高。验证金额是否在供应商支持的范围内。

Customer denied by BNPL provider

原因：

在供应商处的信用历史不足
太多活跃的分期计划
身份验证失败

**解决方案：**某些客户会遇到这种情况。确保卡支持的备用方案可用。不要公开特定的拒绝原因。

Payment stuck in pending

**原因：**客户未完成与 BNPL 供应商的身份验证流程。**解决方案：**支付将超时并失败。客户可以重试或使用其他方法。

Payment Methods Overview

查看所有支持的支付方式。

Checkout Guide

完成结账实施指南。

Testing Process

所有支付方式的测试数据。

Adaptive Currency

货币支持和转换。

​为什么要提供BNPL？

Higher AOV

Better Conversion

Zero Risk

​支持的提供商

​Klarna

​Afterpay (Clearpay)

​Billie

​Sunbit

​配置

​API 方法类型

​示例

​交易金额限制

​分期付款的工作原理

​测试

​Klarna 测试数据

​Afterpay 测试

​Sunbit 测试

​最佳实践

​限制

​无订阅

​基于信用的批准

​货币与国家映射

​故障排除

​相关页面

Payment Methods Overview

Checkout Guide

Testing Process

Adaptive Currency

为什么要提供BNPL？

支持的提供商

Klarna

Afterpay (Clearpay)

Billie

Sunbit

配置

API 方法类型

示例

交易金额限制

分期付款的工作原理

测试

Klarna 测试数据

Afterpay 测试

Sunbit 测试

最佳实践

限制

无订阅

基于信用的批准

货币与国家映射

故障排除

相关页面