> ## 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.

# European Payment Methods

> 接受 iDEAL、Bancontact、EPS、Multibanco、Przelewy24、BLIK 和 Satispay，以提高欧洲市场的转化率。了解区域可用性、银行覆盖范围和配置。

European customers strongly prefer local payment methods that integrate with their banking systems. Offering these methods can increase conversion rates by 20-40% in target markets.

## Why Local European Payment Methods?

<CardGroup cols={3}>
  <Card title="Higher Conversion" icon="chart-line">
    iDEAL captures \~60% of Dutch online payments. Not offering it means losing customers.
  </Card>

  <Card title="Lower Fraud" icon="shield-check">
    Bank-authenticated payments have near-zero fraud rates and no chargebacks.
  </Card>

  <Card title="Real-Time Settlement" icon="bolt">
    Most European methods provide instant payment confirmation.
  </Card>
</CardGroup>

## Supported Methods

| Method               | Country  | Market Share | Currency | Subscriptions |
| :------------------- | :------- | :----------- | :------- | :-----------: |
| **iDEAL**            | 荷兰       | \~60%        | EUR      |       No      |
| **Bancontact**       | 比利时      | \~50%        | EUR      |       No      |
| **EPS**              | 奥地利      | \~30%        | EUR      |       No      |
| **Multibanco**       | 葡萄牙      | \~40%        | EUR      |       No      |
| **Przelewy24 (P24)** | 波兰       | \~30%        | PLN      |       No      |
| **BLIK**             | 波兰       | \~60%        | PLN      |       No      |
| **Satispay**         | 欧洲 (意大利) | 增长中          | EUR      |      Yes      |

## iDEAL (Netherlands)

iDEAL is the dominant online payment method in the Netherlands, connecting directly to all major Dutch banks.

### How It Works

```mermaid theme={null}
sequenceDiagram
    participant Customer
    participant Checkout
    participant Dodo
    participant iDEAL
    participant Bank
    
    Customer->>Checkout: Select iDEAL
    Checkout->>Dodo: Create payment
    Dodo->>iDEAL: Initiate payment
    iDEAL->>Customer: Redirect to bank selection
    Customer->>Bank: Select bank & authenticate
    Bank->>iDEAL: Payment confirmed
    iDEAL->>Dodo: Success callback
    Dodo->>Checkout: Payment complete
```

### Supported Banks

All major Dutch banks are supported:

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

### Configuration

```javascript theme={null}
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_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 (Belgium)

Bancontact is Belgium's national payment scheme, used by virtually all Belgian banks for online payments.

### Features

* Works with existing Belgian debit cards
* Mobile app support (Payconiq by Bancontact)
* Instant payment confirmation
* No additional registration needed for customers

### Configuration

```javascript theme={null}
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_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 (Austria)

EPS (Electronic Payment Standard) enables direct online bank transfers for Austrian customers.

### Features

* Direct integration with Austrian banks
* Real-time payment confirmation
* High trust among Austrian consumers
* No chargebacks

### Supported Banks

Major Austrian banks including:

* Erste Bank
* Bank Austria
* Raiffeisen
* BAWAG
* Volksbank

### Configuration

```javascript theme={null}
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_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 (Portugal)

Multibanco is Portugal's interbank network, offering both online payments and ATM-based payments.

### Payment Options

1. **Online Banking** — Direct bank transfer via internet banking
2. **ATM Payment** — Customer receives a reference to pay at any Multibanco ATM
3. **Mobile Banking** — Payment via bank mobile apps

### How ATM Payment Works

For ATM payments, customers receive a payment reference:

```
Entity: 12345
Reference: 123 456 789
Amount: €50.00
Expiry: 24 hours
```

Customer can pay at any Portuguese ATM or via online banking using this reference.

### Configuration

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

<Note>
  Multibanco ATM payments may have a delay between checkout and actual payment. Monitor webhooks for payment confirmation.
</Note>

## Przelewy24（波兰）

Przelewy24 (P24) 是波兰领先的在线支付方式，整合了银行转账和所有主要波兰银行的本地钱包。与其他欧洲方式不同，Przelewy24 以 **PLN**（波兰兹罗提）而非 EUR 结算。

### 工作原理

```mermaid theme={null}
sequenceDiagram
    participant Customer
    participant Checkout
    participant Dodo
    participant Przelewy24
    participant Bank

    Customer->>Checkout: Select Przelewy24
    Checkout->>Dodo: Create payment
    Dodo->>Przelewy24: Initiate payment
    Przelewy24->>Customer: Redirect to bank / wallet selection
    Customer->>Bank: Authenticate & approve
    Bank->>Przelewy24: Payment confirmed
    Przelewy24->>Dodo: Success callback
    Dodo->>Checkout: Payment complete
```

### 可用性

* **计费货币：** 仅 PLN
* **交易类型：** 仅一次性付款（不适用于订阅）
* **覆盖范围：** 所有主要波兰银行及流行的本地钱包

### 配置

```javascript theme={null}
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_123', quantity: 1 }],
  allowed_payment_method_types: ['przelewy24', 'credit', 'debit'],
  billing_currency: 'PLN',
  billing_address: {
    country: 'PL',
    zipcode: '00-001'
  },
  return_url: 'https://example.com/success'
});
```

<Note>
  Przelewy24 需要 **PLN** 计费货币。如果您的价格以 EUR 报价，请启用 [Adaptive Currency](/features/adaptive-currency) 以便波兰客户以 PLN 计费并使 Przelewy24 可用。
</Note>

## BLIK（波兰）

BLIK 是波兰最受欢迎的移动支付方式，允许客户使用其银行应用生成的一次性 6 位代码进行支付。与 Przelewy24 类似，BLIK 以 **PLN**（波兰兹罗提）结算，而不是 EUR。

### 工作原理

```mermaid theme={null}
sequenceDiagram
    participant Customer
    participant Checkout
    participant Dodo
    participant BLIK
    participant BankApp

    Customer->>Checkout: Select BLIK
    Checkout->>Dodo: Create payment
    Customer->>BankApp: Generate 6-digit code
    Customer->>Checkout: Enter BLIK code
    Checkout->>Dodo: Submit code
    Dodo->>BLIK: Authorize payment
    BLIK->>BankApp: Confirmation request
    Customer->>BankApp: Approve payment
    BankApp->>BLIK: Payment confirmed
    BLIK->>Dodo: Success callback
    Dodo->>Checkout: Payment complete
```

### 可用性

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

### 配置

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

<Note>
  BLIK 需要使用 **PLN** 作为计费货币。如果您以 EUR 报价，请启用 [自适应货币](/features/adaptive-currency)，以便波兰客户将以 PLN 计费，并且 BLIK 将可用。
</Note>

## Satispay（欧洲）

Satispay 是一个流行的欧洲移动支付网络，特别是在意大利，允许客户无需分享卡或银行详细信息即可直接从 Satispay 应用支付。Satispay 以 **EUR** 结算。

### 功能

* 基于应用的支付，独立于卡网络
* 在意大利有很高的采用率，并在其他欧洲市场增长中
* 支持一次性支付和订阅

### 可用性

* **计费货币：** EUR
* **交易类型：** 一次性支付和订阅

### 配置

```javascript theme={null}
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_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 方法类型

| Type              | Method           | Country |
| :---------------- | :--------------- | :------ |
| `ideal`           | iDEAL            | 荷兰      |
| `bancontact_card` | Bancontact       | 比利时     |
| `eps`             | EPS              | 奥地利     |
| `multibanco`      | Multibanco       | 葡萄牙     |
| `przelewy24`      | Przelewy24 (P24) | 波兰      |
| `blik`            | BLIK             | 波兰      |
| `satispay`        | Satispay         | 欧洲（意大利） |

## 多国家欧洲结账

对于服务多个欧洲国家的企业，请包括所有区域方法：

```javascript theme={null}
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_123', quantity: 1 }],
  allowed_payment_method_types: [
    'ideal',           // Netherlands
    'bancontact_card', // Belgium
    'eps',             // Austria
    'multibanco',      // Portugal
    'przelewy24',      // Poland (requires PLN billing currency)
    'blik',            // Poland (requires PLN billing currency)
    'satispay',        // Europe / Italy
    'credit',          // Fallback
    'debit'            // Fallback
  ],
  billing_currency: 'EUR',
  return_url: 'https://example.com/success'
});
```

Dodo 会根据客户位置自动显示相关方法。荷兰客户将看到 iDEAL；比利时客户将看到 Bancontact。

## 测试

欧洲支付方式可以在沙盒模式下进行测试。测试流程模拟银行身份验证过程。

<Steps>
  <Step title="Enable test mode">
    使用您的 Dodo Payments 测试 API 密钥。
  </Step>

  <Step title="Set appropriate billing address">
    将计费地址国家设置为与支付方式匹配：

    * `NL` 用于 iDEAL
    * `BE` 用于 Bancontact
    * `AT` 用于 EPS
    * `PT` 用于 Multibanco
    * `PL` 用于 Przelewy24 和 BLIK（计费货币为 PLN）
    * `IT` 用于 Satispay
  </Step>

  <Step title="Complete the test flow">
    按照测试环境中的模拟银行身份验证流程。
  </Step>
</Steps>

## 最佳实践

<AccordionGroup>
  <Accordion title="Always include regional methods for target markets">
    如果您向荷兰客户销售，请包含 iDEAL。不这样做就像在美国不接受 Visa —— 您会失去大量销售。
  </Accordion>

  <Accordion title="Match currency to region">
    大多数欧洲支付方式需要 EUR —— 确保您的定价支持欧元交易。唯一的例外是 Przelewy24，仅在 **PLN** （波兰兹罗提）计费时提供。
  </Accordion>

  <Accordion title="Handle redirects gracefully">
    所有欧洲方法都涉及重定向到银行网站。确保您的返回 URL 处理稳健，并考虑用户在流程中途放弃的情况。
  </Accordion>

  <Accordion title="Provide card fallbacks">
    并非所有欧洲客户都能访问这些区域方法（游客、外籍人士等）。始终包含 `credit` 和 `debit` 作为后备。
  </Accordion>

  <Accordion title="Consider Multibanco timing">
    Multibanco ATM 支付可能需要数小时才能完成。不要在即时支付时阻止履行 —— 使用 webhooks 进行异步确认。
  </Accordion>
</AccordionGroup>

## 故障排除

<AccordionGroup>
  <Accordion title="European method not appearing">
    **检查：**

    1. 客户计费国家是否与方法的国家匹配？
    2. 货币设为 EUR 吗？
    3. 方法是否包含在 `allowed_payment_method_types`？

    **解决方案：** 欧洲方法严格为区域性。一位计费国家为 `DE`（德国）的客户看不到 iDEAL，因为它仅限于荷兰。
  </Accordion>

  <Accordion title="Bank authentication failed">
    **原因：**

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

    **解决方案：** 客户应重试。如果问题持续，建议尝试不同的支付方式。
  </Accordion>

  <Accordion title="Redirect not completing">
    **原因：**

    * 客户在银行重定向期间关闭浏览器
    * 身份验证期间的网络问题
    * 返回 URL 配置错误

    **解决方案：** 验证返回 URL 的正确性和可访问性。确保它处理成功和失败状态。
  </Accordion>

  <Accordion title="Multibanco payment pending">
    **原因：** 客户已收到付款参考，但尚未付款。

    **解决方案：** 这是 ATM 支付的预期行为。等待 webhook 确认。参考通常在 24-72 小时内过期。
  </Accordion>
</AccordionGroup>

## PSD2 合规性

所有欧洲支付方式符合 PSD2（支付服务指令 2）法规：

* **强客户身份验证 (SCA)** —— 内置于银行身份验证流程中
* **安全通信** —— 所有数据通过安全渠道传输
* **消费者保护** —— 完全符合欧盟消费者权利

## 相关页面

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

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

  <Card title="Checkout Guide" icon="book" href="/developer-resources/checkout-session">
    完整的结账实施指南。
  </Card>

  <Card title="Webhooks" icon="webhook" href="/developer-resources/webhooks">
    异步处理支付确认。
  </Card>
</CardGroup>
