European Payment Methods - Dodo Payments Documentation

接受 iDEAL、Bancontact、EPS、Multibanco、BLIK、SEPA Direct Debit 和 Satispay，让偏好使用银行账户或本地支付应用而非卡片付款的欧洲客户能够完成支付。在本地支付方式是在线支付主流方式的市场，提供该方式可以提高转化率。

Why Local European Payment Methods?

Higher Conversion

iDEAL 是荷兰使用最广泛的在线支付方式。没有它，您会失去不愿使用其他方式付款的荷兰客户。

Bank Authentication

对于通过银行验证的方式，客户会在银行应用或银行网站上批准支付。

Real-Time Settlement

本页中的大多数支付方式会在结账期间确认付款。SEPA Direct Debit 和 Multibanco ATM 付款会稍后确认。

支持的方式

每种方式仅会在结账符合其货币和计费类型时提供：

支付方式	国家/地区	货币	订阅
iDEAL	荷兰	EUR	否
Bancontact	比利时	EUR	否
EPS	奥地利	EUR	否
Multibanco	葡萄牙	EUR	否
BLIK	波兰	PLN	否
SEPA Direct Debit	欧元区	EUR	否
Satispay	欧洲（意大利）	EUR	是

iDEAL（荷兰）

iDEAL 是荷兰使用最广泛的在线支付方式。它直接连接所有主要荷兰银行，客户使用自己的银行批准每笔支付。

工作原理

客户选择 iDEAL，选定银行，然后在银行处完成验证：

支持的银行

iDEAL 支持所有主要荷兰银行，包括：

ABN AMRO
ASN Bank
Bunq
ING
Knab
Rabobank
RegioBank
Revolut
SNS
Triodos Bank
Van Lanschot

配置

要提供 iDEAL，请在 allowed_payment_method_types 中包含 ideal，并使用 EUR 计费：

// `client` is an initialized DodoPayments client.
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: ['ideal', 'credit', 'debit'],
  billing_currency: 'EUR',
  billing_address: {
    country: 'NL',
    zipcode: '1012JS'
  },
  return_url: 'https://example.com/success'
});

Bancontact（比利时）

Bancontact 是比利时的国家支付系统。几乎所有比利时银行都使用它进行在线支付。

功能

支持比利时客户已有的 Bancontact 借记卡
支持通过 Bancontact 移动应用付款
在结账期间确认支付
客户无需额外注册

配置

要提供 Bancontact，请包含 bancontact_card，并使用 EUR 计费：

// `client` is an initialized DodoPayments client.
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: ['bancontact_card', 'credit', 'debit'],
  billing_currency: 'EUR',
  billing_address: {
    country: 'BE',
    zipcode: '1000'
  },
  return_url: 'https://example.com/success'
});

EPS（奥地利）

EPS（Electronic Payment Standard）允许奥地利客户通过自己的银行进行在线银行转账。

功能

直接连接奥地利银行
在结账期间确认支付
深受奥地利消费者信任

支持的银行

EPS 支持主要奥地利银行，包括：

Erste Bank
Bank Austria
Raiffeisen
BAWAG
Volksbank

配置

要提供 EPS，请包含 eps，并使用 EUR 计费：

// `client` is an initialized DodoPayments client.
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: ['eps', 'credit', 'debit'],
  billing_currency: 'EUR',
  billing_address: {
    country: 'AT',
    zipcode: '1010'
  },
  return_url: 'https://example.com/success'
});

Multibanco（葡萄牙）

Multibanco 是葡萄牙的银行间网络。客户可以在线支付，也可以在 ATM 上使用支付参考号付款。

支付选项

客户可以通过三种方式完成 Multibanco 支付：

网上银行：通过客户的网上银行进行银行转账。
ATM 支付：客户会收到支付参考号，然后在任意 Multibanco ATM 上付款。
移动银行：通过客户的银行应用付款。

ATM 支付的工作原理

进行 ATM 支付时，客户会收到类似以下内容的支付参考号：

Entity: 12345
Reference: 123 456 789
Amount: €50.00

客户可以在任意葡萄牙 ATM 或通过网上银行使用此参考号付款。参考号仅在有限时间内有效，客户会在收到参考号时看到有效期限。

配置

要提供 Multibanco，请包含 multibanco，并使用 EUR 计费：

// `client` is an initialized DodoPayments client.
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: ['multibanco', 'credit', 'debit'],
  billing_currency: 'EUR',
  billing_address: {
    country: 'PT',
    zipcode: '1000-001'
  },
  return_url: 'https://example.com/success'
});

当客户支付参考号后，Multibanco ATM 支付才会完成，这可能发生在结账很久之后。使用 webhooks 了解支付何时得到确认。

BLIK（波兰）

BLIK 是波兰最受欢迎的移动支付方式。客户使用在银行应用中生成的一次性 6 位代码付款。BLIK 支付使用 PLN（波兰兹罗提）计费，而不是 EUR。

工作原理

客户在银行应用中生成代码，在结账时输入代码，然后在应用中批准支付：

可用性

**计费货币：**仅 PLN
**交易类型：**仅限一次性支付。BLIK 不提供给订阅使用。
**覆盖范围：**所有支持 BLIK 的主要波兰银行

配置

要提供 BLIK，请包含 blik，并将 billing_currency 设置为 PLN：

// `client` is an initialized DodoPayments client.
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: ['blik', 'credit', 'debit'],
  billing_currency: 'PLN',
  billing_address: {
    country: 'PL',
    zipcode: '00-001'
  },
  return_url: 'https://example.com/success'
});

BLIK 要求使用 PLN 作为计费货币，并且只有在启用 Adaptive Currency 后，Dodo Payments 才会使用 PLN 计费。启用 Adaptive Currency 后，波兰客户将以 PLN 计费，BLIK 也会变为可用。

SEPA Direct Debit（欧元区）

SEPA Direct Debit 允许欧元区客户直接从银行账户付款，而不是使用银行卡。当账单国家/地区为奥地利、比利时、爱沙尼亚、芬兰、法国、德国、爱尔兰、意大利、拉脱维亚、立陶宛、荷兰、葡萄牙、斯洛伐克或西班牙时，该支付方式可用于 EUR 结账中的一次性付款，但不适用于订阅。

SEPA Direct Debit 不是即时支付。支付最多需要 6 个工作日才能确认。 与卡片支付不同，客户在结账时的授权并不意味着资金已经到账。不要在结账重定向或 payment.processing 时履行订单。请等待 payment.succeeded webhook。

工作原理

客户在结账时授权扣款，Dodo Payments 随后从其银行账户收取资金。银行会异步完成扣款，因此支付会一直处于 processing 状态，直到获得最终结果：

支付时间线

SEPA 支付会经历以下阶段：

阶段	时间	支付状态	含义
授权	结账时	`processing`	客户批准了扣款并被重定向回来。资金尚未转移，因此不要履行订单。
确认	之后最多 6 个工作日	`succeeded`	银行已完成扣款。现在履行订单。
失败	之后最多 6 个工作日	`failed`	无法收取扣款，例如余额不足。不要履行订单，并通知客户。

确认会在客户离开您的网站数日后到达，因此必须由 webhook handler 而不是结账重定向来授予访问权限。请参阅处理确认延迟。

可用性

账单货币： EUR
交易类型： 仅限一次性付款。SEPA Direct Debit 不适用于订阅。

配置

要提供 SEPA Direct Debit，请包含 sepa，并使用 EUR 计费：

// `client` is an initialized DodoPayments client.
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: ['sepa', 'credit', 'debit'],
  billing_currency: 'EUR',
  billing_address: {
    country: 'DE',
    zipcode: '10115'
  },
  return_url: 'https://example.com/success'
});

SEPA 测试 IBAN

在测试模式下，在结账时输入以下任一 IBAN，以强制产生特定结果：

测试 IBAN	行为
`DE89370400440532013000`	支付成功。
`DE08370400440532013003`	延迟至少三分钟后支付成功。
`DE62370400440532013001`	支付失败。
`DE78370400440532013004`	延迟至少三分钟后支付失败。
`DE35370400440532013002`	支付成功，然后立即产生争议。
`DE65370400440002222227`	由于余额不足，支付失败。
`DE18370400440000066666`	银行账户不可用，因此无法创建支付方式。

要测试特定国家/地区的行为，请使用其他欧元区国家/地区对应的成功 IBAN：

国家/地区	成功 IBAN
奥地利	`AT611904300234573201`
比利时	`BE62510007547061`
爱沙尼亚	`EE382200221020145685`
芬兰	`FI2112345600000785`
法国	`FR1420041010050500013M02606`
爱尔兰	`IE29AIBK93115212345678`
卢森堡	`LU280019400644750000`

使用延迟测试 IBAN，确认您的 webhook handler 而不是结账重定向来授予访问权限。SEPA 支付会在客户离开结账页面很久之后才确认。

处理确认延迟

SEPA 会在结账后最多 6 个工作日完成结算，因此浏览器重定向无法告知您支付是否已完成。请改为根据 webhook 事件执行订单履行。启用事件 type 并处理每个阶段：

事件类型	触发时间	操作
`payment.processing`	客户在结账时授权扣款并被重定向回来。	不要履行订单。将订单标记为待处理。您可以告知客户支付正在处理中。
`payment.succeeded`	最多 6 个工作日后，银行完成扣款。	履行订单：授予访问权限、配置产品并发送收据。
`payment.failed`	无法收取扣款。	通知客户并提示其重试。不要履行订单。

请根据 webhook 中的 INLINE_CODE_PLACEHOLDER_bfeed7a4ab5393d_END 履行订单，而不是根据结账重定向或 payment.processing。重定向会在客户授权扣款后立即发生，此时距离资金到账可能还有数日。

以下 Express handler 会在处理事件前，使用 client.webhooks.unwrap 验证每个事件的签名。有关 endpoint 设置，请参阅 Webhooks 指南。有关所有事件，请参阅 Webhook Event 指南。

Handling SEPA payment events

import express from 'express';
import DodoPayments from 'dodopayments';

const client = new DodoPayments({
  bearerToken: process.env.DODO_PAYMENTS_API_KEY,
  webhookKey: process.env.DODO_PAYMENTS_WEBHOOK_KEY,
});
const app = express();

// markOrderPending, fulfillOrder, and markOrderFailed are your own order functions.
app.post('/webhooks/dodo', express.raw({ type: 'application/json' }), async (req, res) => {
  let event;
  try {
    // Checks the webhook-id, webhook-signature, and webhook-timestamp headers.
    event = client.webhooks.unwrap(req.body.toString(), { headers: req.headers });
  } catch {
    return res.status(400).send('Invalid signature');
  }

  switch (event.type) {
    case 'payment.processing': {
      // SEPA debit authorized but NOT settled. This can last up to 6 business days.
      // Record the order as pending; do not grant access yet.
      await markOrderPending(event.data.payment_id);
      break;
    }
    case 'payment.succeeded': {
      // The debit cleared, so it's safe to fulfill now.
      await fulfillOrder(event.data.payment_id);
      break;
    }
    case 'payment.failed': {
      // The debit could not be collected (for example, insufficient funds).
      await markOrderFailed(event.data.payment_id);
      // Notify the customer and prompt a retry.
      break;
    }
  }

  res.json({ received: true });
});

在结账时向客户说明预期情况。只有扣款完成后才会授予访问权限，因此请告知 SEPA 客户其订单正在处理中，并会在支付确认后通知他们。否则，他们可能会像使用卡片支付一样期待立即获得访问权限。

Satispay（欧洲）

Satispay 是一个欧洲移动支付网络，用户主要集中在意大利。客户无需分享卡片或银行详细信息，即可通过 Satispay 应用付款。Satispay 支付使用 EUR 计费。

功能

基于应用的支付，不依赖卡片网络
在意大利普及率高，并且在其他欧洲市场的使用量不断增长
支持一次性支付和订阅

可用性

**计费货币：**EUR
**交易类型：**一次性支付和订阅
**金额：**每笔支付 €0.50 至 €999,999.99

配置

要提供 Satispay，请包含 satispay，并使用 EUR 计费：

// `client` is an initialized DodoPayments client.
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: ['satispay', 'credit', 'debit'],
  billing_currency: 'EUR',
  billing_address: {
    country: 'IT',
    zipcode: '00100'
  },
  return_url: 'https://example.com/success'
});

API Method Types

在 allowed_payment_method_types 中传入以下值：

类型	方式	国家/地区
`ideal`	iDEAL	荷兰
`bancontact_card`	Bancontact	比利时
`eps`	EPS	奥地利
`multibanco`	Multibanco	葡萄牙
`blik`	BLIK	波兰
`sepa`	SEPA Direct Debit	欧元区
`satispay`	Satispay	欧洲（意大利）

多国家/地区欧洲结账

要在多个欧洲国家/地区销售，请包含所有区域支付方式，并将卡片作为备用方式：

// `client` is an initialized DodoPayments client.
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: [
    'ideal',           // Netherlands
    'bancontact_card', // Belgium
    'eps',             // Austria
    'multibanco',      // Portugal
    'blik',            // Poland (requires PLN billing currency)
    'sepa',            // Eurozone (one-time payments only)
    'satispay',        // Europe / Italy
    'credit',          // Fallback
    'debit'            // Fallback
  ],
  billing_currency: 'EUR',
  return_url: 'https://example.com/success'
});

Dodo Payments 只会向每位客户显示与其计费国家/地区和货币匹配的方式。荷兰客户会看到 iDEAL，比利时客户会看到 Bancontact。本次会话使用 EUR 计费，因此不会显示 BLIK。

测试

您可以在测试模式下测试欧洲支付方式。测试流程会模拟银行验证步骤。

SEPA Direct Debit 使用不同的测试流程。您无需模拟银行流程，而是直接输入测试 IBAN。请参阅 SEPA 测试 IBAN。

Multibanco 也使用不同的测试流程。结账页面会显示凭证，而不是银行流程；你输入的电子邮箱会决定结果。请参阅 Multibanco 测试邮箱。

Enable Test Mode

在控制台侧边栏中关闭 Live Mode 开关，并使用在测试模式下创建的 API keys。

Set Appropriate Billing Address

将账单地址的国家/地区设置为与支付方式匹配：

NL 用于 iDEAL
BE 用于 Bancontact
AT 用于 EPS
PT 用于 Multibanco
PL 用于 BLIK（账单货币为 PLN）
IT 用于 Satispay

Complete the Test Flow

在测试模式下按照模拟的银行身份验证流程操作。

Multibanco 测试邮箱

点击 Pay 后，结账页面会显示 Multibanco 凭证。在测试模式下，你输入的电子邮箱会决定结果：

电子邮箱	结果
任意电子邮箱，例如 `jenny@example.com`	付款约 3 分钟后成功。
`succeed_immediately@example.com`	付款在几秒内成功。
`expire_immediately@example.com`	付款在几秒内失败。
`expire_with_delay@example.com`	付款约 3 分钟后失败。
`fill_never@example.com`	付款始终无法完成。

要查看成功页面，请使用 succeed_immediately@example.com，等待几秒，然后点击 Done。

最佳实践

Always include regional methods for target markets

如果你向荷兰客户销售，请务必加入 iDEAL。不提供 iDEAL 就像在美国不接受 Visa 一样：你会损失相当大一部分销售额。

Match currency to region

大多数欧洲支付方式都要求使用 EUR，因此请确保你的定价支持 EUR 交易。唯一的例外是 BLIK，它仅支持使用 PLN（波兰兹罗提）结算。

Handle redirects gracefully

大多数欧洲支付方式都会将客户重定向到其银行或支付应用。请确保返回 URL 的处理逻辑适用于中途放弃流程的客户。

Provide card fallbacks

并非所有欧洲客户都能使用这些区域性支付方式，例如游客和外籍居民。请加入 credit 和 debit 作为备用方式。如果没有可用的支付方式，结账会话将失败。

Consider Multibanco timing

Multibanco ATM 付款可能需要数小时才能完成。不要因等待即时付款而阻止履约。请使用 webhooks 进行异步确认。

Account for the SEPA 6-day delay

SEPA Direct Debit 最多需要 6 个工作日才能确认。不要根据结账重定向或 payment.processing 执行履约。仅在收到 payment.succeeded webhook 后授予访问权限，并在结账时告知客户其订单处于待处理状态。请参阅处理确认延迟。

故障排除

European method not appearing

检查：

客户的账单国家/地区是否与支付方式所属国家/地区匹配？
账单货币是否为 EUR，或 BLIK 使用的 PLN？
该支付方式是否包含在 allowed_payment_method_types 中？
结账是否针对一次性付款？iDEAL、Bancontact、EPS、Multibanco、BLIK 和 SEPA Direct Debit 不适用于订阅。

解决方案： 特定国家/地区的支付方式只会显示在其对应的国家/地区。账单国家/地区为 DE（德国）的客户看不到 iDEAL，因为 iDEAL 仅适用于荷兰。

Bank authentication failed

原因：

客户在银行身份验证过程中取消了操作。
银行的身份验证系统暂时不可用。
客户输入了错误的凭据。

**解决方案：**客户应重试。如果问题仍然存在，请建议使用其他支付方式。

Redirect not completing

原因：

客户在银行重定向过程中关闭了浏览器。
网络问题中断了身份验证。
返回 URL 配置错误。

**解决方案：**检查返回 URL 是否正确且可访问，并确保其能够处理成功和失败状态。

Multibanco payment pending

**原因：**客户收到了付款参考号，但尚未付款。**解决方案：**ATM 付款出现这种情况是正常的。请等待 webhook 确认。参考号会在显示给客户的限定时间后过期。

SEPA payment stuck in processing

**原因：**SEPA Direct Debit 会通过客户的银行进行异步清算。**解决方案：**这是正常现象。payment.processing 状态可能会持续最多 6 个工作日，之后扣款才会完成清算。请等待最终的 payment.succeeded webhook（执行履约）或 payment.failed webhook（不要执行履约）。不要将结账重定向视为确认。请参阅处理确认延迟。

Payment Methods Overview

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

Adaptive Currency

货币支持和自动转换。

Checkout Guide

完整的结账实施指南。

Webhooks

异步处理付款确认。

​Why Local European Payment Methods?

Higher Conversion

Bank Authentication

Real-Time Settlement

​支持的方式

​iDEAL（荷兰）

​工作原理

​支持的银行

​配置

​Bancontact（比利时）

​功能

​配置

​EPS（奥地利）

​功能

​支持的银行

​配置

​Multibanco（葡萄牙）

​支付选项

​ATM 支付的工作原理

​配置

​BLIK（波兰）

​工作原理

​可用性

​配置

​SEPA Direct Debit（欧元区）

​工作原理

​支付时间线

​可用性

​配置

​SEPA 测试 IBAN

​处理确认延迟

​Satispay（欧洲）

​功能

​可用性

​配置

​API Method Types

​多国家/地区欧洲结账

​测试

​Multibanco 测试邮箱

​最佳实践

​故障排除

​相关页面

Payment Methods Overview

Adaptive Currency

Checkout Guide

Webhooks

Why Local European Payment Methods?

支持的方式

iDEAL（荷兰）

工作原理

支持的银行

配置

Bancontact（比利时）

功能

配置

EPS（奥地利）

功能

支持的银行

配置

Multibanco（葡萄牙）

支付选项

ATM 支付的工作原理

配置

BLIK（波兰）

工作原理

可用性

配置

SEPA Direct Debit（欧元区）

工作原理

支付时间线

可用性

配置

SEPA 测试 IBAN

处理确认延迟

Satispay（欧洲）

功能

可用性

配置

API Method Types

多国家/地区欧洲结账

测试

Multibanco 测试邮箱

最佳实践

故障排除

相关页面