> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 先买后付（BNPL）

> 提供 Klarna、Afterpay 和 Billie，让客户可以分期付款，同时由支付服务商预先支付全额。涵盖资格要求、最低金额和测试。

先买后付（BNPL）允许客户将购买金额分期支付或延后付款，而 BNPL 提供商会预先支付全额。提供 BNPL 可以提高符合条件交易的平均订单金额和转化率。

## 为什么要提供BNPL？

<CardGroup cols={3}>
  <Card title="Higher AOV" icon="chart-line">
    客户可以分期付款时，往往会消费更多。
  </Card>

  <Card title="Better Conversion" icon="percent">
    分期付款可以减少结账时的阻力，尤其适用于高价商品。
  </Card>

  <Card title="No Credit Risk" icon="shield-check">
    BNPL 服务商承担信用风险并收取分期款项。服务商会预先支付全额。
  </Card>
</CardGroup>

## 支持的提供商

Dodo Payments 提供三家 BNPL 服务商。每家服务商支持的国家、货币和最低金额各不相同。

### Klarna

| Feature | Details |
| :- | :- |
| **Availability** | 美国和 18 个欧洲国家 |
| **Currencies** | USD、EUR、GBP、DKK、NOK、SEK、CZK、PLN、CHF |
| **Minimum** | 使用 USD 结账时，金额必须超过 \$50（\$50.01）。对于其他货币，适用 Klarna 自身的限额 |
| **Subscriptions** | 是 |

**Supported Countries:** 奥地利、比利时、捷克共和国、丹麦、芬兰、法国、德国、希腊、爱尔兰、意大利、荷兰、挪威、波兰、葡萄牙、西班牙、瑞典、瑞士、英国、美国

只有当账单国家/地区为美国时，USD 结账才会显示 Klarna。

**付款选项：**

* **分 4 期付款**：分四期免息付款。
* **30 天内付款**：须在 30 天内支付全额。
* **融资**：期限更长的分期付款计划。

Klarna 会根据客户所在国家/地区、货币和金额决定客户可以看到哪些选项。

### Afterpay (Clearpay)

| 功能 | 详情 |
| :- | :- |
| **可用地区** | 美国、英国 |
| **货币** | USD、GBP |
| **最低金额** | USD 结账金额必须超过 \$50（\$50.01）。对于 GBP，适用 Clearpay 自行规定的限额 |
| **订阅** | 不支持 |

只有当账单国家/地区为美国时，USD 结账才会显示 Afterpay。

**付款选项：**

* **分 4 期付款**：分四期免息付款，每两周支付一期。

<Note>
  在英国，Afterpay 以 Clearpay 的名称运营，并使用相同的 API 类型 `afterpay_clearpay`。
</Note>

### Billie

| 功能 | 详情 |
| :- | :- |
| **可用地区** | 全球 |
| **货币** | GBP |
| **最低金额** | 无 |
| **订阅** | 不支持 |

**关于 Billie：**
Billie 是一家企业对企业（B2B）BNPL 服务商。它允许企业买家按照发票条款付款，而不是在结账时付款。

**付款选项：**

* **发票付款**：买家在约定的付款期限内付款。
* **灵活条款**：适合企业的付款计划。

## 配置

如需提供 BNPL，请在 `allowed_payment_method_types` 中包含服务商类型，或省略该参数以显示所有符合条件的付款方式。

### API 方法类型

| 类型 | 服务商 |
| :- | :- |
| `klarna` | Klarna |
| `afterpay_clearpay` | Afterpay / Clearpay |
| `billie` | Billie (B2B) |

### 示例

此会话向美国客户提供 Klarna 和 Afterpay，并以银行卡作为备用方式：

```javascript theme={null}
// `client` is an initialized DodoPayments client.
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_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'
});
```

<Warning>
  始终将 `credit` 和 `debit` 作为备用方式。并非所有客户都符合 BNPL 资格，低于服务商最低金额的交易也不符合条件。如果列出的付款方式均不可用，结账将失败。
</Warning>

## 交易金额限制

Dodo Payments 对 USD 结账应用以下最低金额：

| 服务商 | 最低金额 | 最高金额 |
| :- | :- | :- |
| Klarna | \$50.01 | — |
| Afterpay | \$50.01 | — |

对于其他货币，适用服务商自行规定的限额。当交易超出服务商的限额时：

* BNPL 选项不会在结账时显示。
* 不会返回错误。该选项不会显示。
* 仍可使用银行卡付款。

这是预期行为。如果你的产品价格不太可能落在某服务商的范围内，请不要将 BNPL 方式包含在 `allowed_payment_method_types` 中。

## 分期付款的运作方式

BNPL 服务商批准客户的付款请求、支付全额，并向客户收取分期款项：

```mermaid theme={null}
sequenceDiagram
    participant Customer
    participant Checkout
    participant Dodo
    participant BNPL Provider
    
    Customer->>Checkout: Select Klarna/Afterpay
    Checkout->>Dodo: Process payment
    Dodo->>BNPL Provider: Create installment plan
    BNPL Provider->>Customer: Approve/Deny based on credit
    BNPL Provider->>Dodo: Full payment (if approved)
    Dodo->>You: Payout (full amount)
    BNPL Provider->>Customer: Collect installments over time
```

**要点：**

* BNPL 服务商会**预先支付全额**，款项会在你的常规结算中到账。
* BNPL 服务商负责处理**信用风险和催收**。
* 客户直接向服务商还款，通常分为**4 期**。
* 如果客户未能支付某期款项，由服务商承担损失，而不是由你承担。

## 测试

使用以下信息在测试模式下测试 BNPL。

### Klarna 测试数据

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

<Note>
  在 USD 结账中，交易金额必须超过 \$50（\$50.01），Klarna 才会显示。
</Note>

### Afterpay 测试

<Steps>
  <Step title="Select Afterpay">
    在结账时选择 Afterpay，然后点击 **Pay**。
  </Step>

  <Step title="Test a Successful Payment">
    使用任何有效的电子邮件地址和收货地址。
  </Step>

  <Step title="Test Failed Authentication">
    如需测试失败场景，请在重定向页面上关闭 Afterpay 模态框。付款状态会从 `requires_customer_action` 变为 `requires_payment_method`。
  </Step>
</Steps>

## 最佳实践

<AccordionGroup>
  <Accordion title="Target high-ticket items">
    BNPL 最适合价格在 \$100 至 \$1,000 之间的产品，因为客户最看重分期付款的便利性。
  </Accordion>

  <Accordion title="Show installment amounts">
    “分 4 期支付 \$25”比“使用 Klarna 支付 \$100”更有说服力。在可能的情况下，显示每期付款金额。
  </Accordion>

  <Accordion title="Don't force BNPL for low-value products">
    在 USD 结账中，金额为 \$50 或以下时不会显示 BNPL。对于低于 \$100 的金额，大多数客户更偏好银行卡。应在价格较高的商品上推广 BNPL。
  </Accordion>

  <Accordion title="Collect billing address">
    BNPL 服务商会使用账单信息进行信用检查。在结账时收集完整的账单地址。
  </Accordion>

  <Accordion title="Set clear expectations">
    向客户明确说明，信用协议是与 Klarna 或 Afterpay 签订的，而不是与你签订的。
  </Accordion>
</AccordionGroup>

## 限制

BNPL 取决于服务商的批准，以及结账所使用的货币和国家/地区。

### 不支持订阅

Afterpay 和 Billie **不支持周期性付款**。Klarna 支持订阅。对于其他订阅产品，请使用银行卡或其他支持周期性付款的方式。

### 基于信用的批准

客户选择 BNPL 服务商时，服务商会进行信用检查，并非所有客户都会获批。批准结果取决于：

* 客户在该服务商处的信用记录。
* 交易金额。
* 客户所在位置。

### 货币与国家/地区映射

每种货币仅限于其对应的地区：

| Currency | Supported Countries |
| :- | :- |
| **USD** | 仅限美国 |
| **EUR** | 欧元区国家（奥地利、比利时、芬兰、法国、德国、希腊、爱尔兰、意大利、荷兰、葡萄牙、西班牙） |
| **GBP** | 仅限英国 |

Klarna 的其他货币（DKK、NOK、SEK、CZK、PLN、CHF）可在其各自对应的国家/地区使用。

<Info>
  例如，USD 交易仅向美国客户显示 BNPL 选项。EUR 交易仅适用于上述欧元区国家的客户。GBP 交易仅适用于英国客户。
</Info>

| Provider | Supported Currencies |
| :- | :- |
| Klarna | USD、EUR、GBP、DKK、NOK、SEK、CZK、PLN、CHF |
| Afterpay | USD（美国）、GBP（英国） |

## 故障排除

<AccordionGroup>
  <Accordion title="BNPL not appearing at checkout">
    **检查：**

    1. 金额是否在服务商的范围内？对于 USD 结账，Klarna 和 Afterpay 要求金额超过 \$50（\$50.01）。
    2. 客户是否位于支持的国家/地区？对于 USD 结账，账单国家/地区必须是美国。
    3. 服务商是否支持该货币？
    4. BNPL 方式是否包含在 `allowed_payment_method_types` 中？
    5. 对于订阅，服务商是否为 Klarna？Afterpay 和 Billie 仅支持一次性付款。

    \*\*解决方案：\*\*最常见的情况是金额低于最低金额或高于最高金额。确认金额处于服务商的范围内。
  </Accordion>

  <Accordion title="Customer denied by BNPL provider">
    **原因：**

    * 客户在该服务商处的信用记录不足。
    * 现有分期付款计划过多。
    * 身份验证失败。

    \*\*解决方案：\*\*部分拒绝属于预期情况。保留银行卡付款作为备用方式。不要向客户显示拒绝的具体原因。
  </Accordion>

  <Accordion title="Payment stuck in pending">
    \*\*原因：\*\*客户未完成 BNPL 服务商的身份验证流程。

    \*\*解决方案：\*\*等待 `payment.succeeded` 或 `payment.failed` webhook 以获取最终状态。如果支付未完成，客户可以重试或使用其他支付方式。
  </Accordion>
</AccordionGroup>

## 相关页面

<CardGroup cols={2}>
  <Card title="Payment Methods Overview" icon="credit-card" href="/features/payment-methods">
    所有支持的付款方式。
  </Card>

  <Card title="Checkout Guide" icon="book" href="/developer-resources/checkout-session">
    创建和自定义结账会话。
  </Card>

  <Card title="Testing Process" icon="flask" href="/miscellaneous/testing-process">
    每种付款方式的测试数据。
  </Card>

  <Card title="Adaptive Currency" icon="globe" href="/features/adaptive-currency">
    货币支持和转换。
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.