Phương thức thanh toán tại châu Âu - Dodo Payments Documentation

Khách hàng châu Âu đặc biệt ưa chuộng các phương thức thanh toán nội địa tích hợp với hệ thống ngân hàng của họ. Việc cung cấp các phương thức này có thể tăng tỷ lệ chuyển đổi từ 20-40% tại các thị trường mục tiêu.

Tại sao nên cung cấp phương thức thanh toán nội địa tại châu Âu?

Higher Conversion

iDEAL chiếm khoảng 60% các khoản thanh toán trực tuyến tại Hà Lan. Không cung cấp phương thức này đồng nghĩa với việc mất khách hàng.

Lower Fraud

Các khoản thanh toán được ngân hàng xác thực có tỷ lệ gian lận gần như bằng không và không có chargeback.

Real-Time Settlement

Hầu hết các phương thức thanh toán tại châu Âu đều cung cấp xác nhận thanh toán tức thì.

Các phương thức được hỗ trợ

Phương thức	Quốc gia	Thị phần	Tiền tệ	Gói đăng ký
iDEAL	Hà Lan	~60%	EUR	Không
Bancontact	Bỉ	~50%	EUR	Không
EPS	Áo	~30%	EUR	Không
Multibanco	Bồ Đào Nha	~40%	EUR	Không
BLIK	Ba Lan	~60%	PLN	Không
SEPA Direct Debit	Khu vực Eurozone	Được sử dụng rộng rãi	EUR	Không
Satispay	Châu Âu (Ý)	Đang tăng trưởng	EUR	Có

iDEAL (Hà Lan)

iDEAL là phương thức thanh toán trực tuyến phổ biến nhất tại Hà Lan, kết nối trực tiếp với tất cả các ngân hàng lớn của Hà Lan.

Cách thức hoạt động

Các ngân hàng được hỗ trợ

Tất cả các ngân hàng lớn của Hà Lan đều được hỗ trợ:

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

Cấu hình

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 (Bỉ)

Bancontact là hệ thống thanh toán quốc gia của Bỉ, được hầu hết các ngân hàng Bỉ sử dụng cho thanh toán trực tuyến.

Tính năng

Hoạt động với các thẻ ghi nợ hiện có của Bỉ
Hỗ trợ ứng dụng di động (Payconiq by Bancontact)
Xác nhận thanh toán tức thì
Khách hàng không cần đăng ký thêm

Cấu hình

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 (Áo)

EPS (Electronic Payment Standard) cho phép khách hàng Áo thực hiện chuyển khoản ngân hàng trực tuyến trực tiếp.

Tính năng

Tích hợp trực tiếp với các ngân hàng Áo
Xác nhận thanh toán theo thời gian thực
Được người tiêu dùng Áo tin tưởng
Không có chargeback

Các ngân hàng được hỗ trợ

Các ngân hàng lớn của Áo bao gồm:

Erste Bank
Bank Austria
Raiffeisen
BAWAG
Volksbank

Cấu hình

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 (Bồ Đào Nha)

Multibanco là mạng lưới liên ngân hàng của Bồ Đào Nha, cung cấp cả thanh toán trực tuyến và thanh toán qua ATM.

Tùy chọn thanh toán

Ngân hàng trực tuyến — Chuyển khoản ngân hàng trực tiếp qua internet banking
Thanh toán qua ATM — Khách hàng nhận mã tham chiếu để thanh toán tại bất kỳ ATM Multibanco nào
Ngân hàng di động — Thanh toán qua ứng dụng di động của ngân hàng

Cách thức thanh toán qua ATM hoạt động

Đối với thanh toán qua ATM, khách hàng sẽ nhận được mã tham chiếu thanh toán:

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

Khách hàng có thể thanh toán tại bất kỳ ATM nào ở Bồ Đào Nha hoặc qua internet banking bằng mã tham chiếu này.

Cấu hình

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'
});

Thanh toán Multibanco qua ATM có thể bị trì hoãn giữa thời điểm checkout và thời điểm thanh toán thực tế. Hãy theo dõi webhooks để nhận xác nhận thanh toán.

BLIK (Ba Lan)

BLIK là phương thức thanh toán di động phổ biến nhất tại Ba Lan, cho phép khách hàng thanh toán bằng mã gồm 6 chữ số, được tạo một lần trong ứng dụng ngân hàng. BLIK quyết toán bằng PLN (Złoty Ba Lan), không phải EUR.

Cách thức hoạt động

Phạm vi khả dụng

Tiền tệ thanh toán: Chỉ PLN
Loại giao dịch: Chỉ thanh toán một lần (không khả dụng cho gói đăng ký)
Phạm vi hỗ trợ: Tất cả ngân hàng lớn tại Ba Lan hỗ trợ BLIK

Cấu hình

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 yêu cầu tiền tệ thanh toán là PLN. Nếu bạn báo giá bằng EUR, hãy bật Adaptive Currency để khách hàng Ba Lan được tính phí bằng PLN và BLIK trở nên khả dụng.

SEPA Direct Debit (Khu vực Eurozone)

SEPA Direct Debit cho phép khách hàng trên toàn Khu vực Eurozone thanh toán trực tiếp từ tài khoản ngân hàng thay vì sử dụng thẻ. Phương thức này được cung cấp trên các trang thanh toán bằng EUR cho các khoản thanh toán một lần.

SEPA Direct Debit không tức thì — một khoản thanh toán có thể mất tối đa 6 ngày làm việc để được xác nhận. Không giống mọi phương thức khác trên trang này, việc khách hàng ủy quyền ghi nợ khi thanh toán không có nghĩa là tiền đã được ghi có. Không bao giờ hoàn tất đơn hàng khi chuyển hướng từ checkout hoặc khi nhận payment.processing; hãy chờ webhook payment.succeeded.

Cách thức hoạt động

Khách hàng ủy quyền ghi nợ trong quá trình checkout, sau đó Dodo Payments thu tiền từ tài khoản ngân hàng của họ. Vì ngân hàng xử lý việc ghi nợ không đồng bộ, khoản thanh toán sẽ chuyển qua trạng thái processing trước khi đạt đến kết quả cuối cùng:

Tiến trình thanh toán

Giai đoạn	Thời điểm	Trạng thái thanh toán	Ý nghĩa
Ủy quyền	Khi checkout	`processing`	Khách hàng đã chấp thuận ghi nợ và được chuyển hướng trở lại. Tiền chưa được chuyển — không hoàn tất đơn hàng.
Xác nhận	Sau tối đa 6 ngày làm việc	`succeeded`	Ngân hàng đã xử lý xong việc ghi nợ. Hãy hoàn tất đơn hàng ngay.
Thất bại	Sau tối đa 6 ngày làm việc	`failed`	Không thể thu tiền ghi nợ (ví dụ: không đủ tiền). Không hoàn tất đơn hàng; thông báo cho khách hàng.

Vì xác nhận đến vài ngày sau khi khách hàng rời khỏi trang web, webhook handler — chứ không phải chuyển hướng từ checkout — phải là cơ chế cấp quyền truy cập. Xem Xử lý độ trễ xác nhận bên dưới.

Tính khả dụng

Tiền tệ thanh toán: EUR
Loại giao dịch: Chỉ thanh toán một lần (không hỗ trợ subscription)

Cấu hình

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'
});

IBAN SEPA dùng để kiểm thử

Ở chế độ kiểm thử, nhập một trong các IBAN dưới đây khi checkout để buộc tạo ra một kết quả cụ thể.

IBAN kiểm thử	Hành vi
`DE89370400440532013000`	Thanh toán thành công.
`DE08370400440532013003`	Thanh toán thành công sau độ trễ ít nhất ba phút.
`DE62370400440532013001`	Thanh toán thất bại.
`DE78370400440532013004`	Thanh toán thất bại sau độ trễ ít nhất ba phút.
`DE35370400440532013002`	Thanh toán thành công, sau đó ngay lập tức bị dispute.
`DE65370400440002222227`	Thanh toán thất bại do không đủ tiền.
`DE18370400440000066666`	Tài khoản ngân hàng không thể sử dụng, vì vậy không thể tạo phương thức thanh toán.

Để kiểm thử hành vi theo từng quốc gia, hãy sử dụng IBAN thành công tương ứng của một quốc gia khác trong Eurozone:

Quốc gia	IBAN thành công
Áo	`AT611904300234573201`
Bỉ	`BE62510007547061`
Estonia	`EE382200221020145685`
Phần Lan	`FI2112345600000785`
Pháp	`FR1420041010050500013M02606`
Ireland	`IE29AIBK93115212345678`
Luxembourg	`LU280019400644750000`

Các IBAN kiểm thử có độ trễ hữu ích để xác nhận rằng webhook handler — thay vì chuyển hướng từ checkout — là cơ chế cấp quyền truy cập, vì thanh toán SEPA được xác nhận rất lâu sau khi khách hàng rời khỏi checkout.

Xử lý độ trễ xác nhận

Vì SEPA được quyết toán trong vòng tối đa 6 ngày làm việc sau checkout, bạn không thể dựa vào chuyển hướng của trình duyệt để biết liệu khoản thanh toán đã được ghi có hay chưa. Thay vào đó, hãy điều khiển việc hoàn tất đơn hàng bằng các webhook event. Bật payload.type và xử lý từng giai đoạn:

Loại event	Thời điểm phát sinh	Việc cần làm
`payment.processing`	Khách hàng đã ủy quyền ghi nợ khi checkout và được chuyển hướng trở lại.	Không hoàn tất đơn hàng. Đánh dấu đơn hàng đang chờ và, nếu muốn, thông báo cho khách hàng rằng khoản thanh toán đang được xử lý.
`payment.succeeded`	Ngân hàng đã xử lý xong việc ghi nợ (sau tối đa 6 ngày làm việc).	Hoàn tất đơn hàng — cấp quyền truy cập, provision sản phẩm, gửi receipt.
`payment.failed`	Không thể thu tiền ghi nợ.	Thông báo cho khách hàng và yêu cầu thử lại; không hoàn tất đơn hàng.

Handling SEPA payment events

app.post('/webhooks/dodo', async (req, res) => {
  const event = req.body;

  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 — safe to fulfill now.
      await fulfillOrder(event.data.payment_id);
      break;
    }
    case 'payment.failed': {
      // The debit could not be collected (e.g. insufficient funds).
      await markOrderFailed(event.data.payment_id);
      // Notify the customer and prompt a retry.
      break;
    }
  }

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

Luôn hoàn tất đơn hàng khi nhận payment.succeeded từ webhook, không bao giờ thực hiện việc này khi chuyển hướng từ checkout hoặc khi nhận payment.processing. Chuyển hướng được thực hiện ngay khi khách hàng ủy quyền ghi nợ — trước khi tiền thực sự được ghi có vài ngày. Hãy xác minh chữ ký webhook trước khi xử lý; xem hướng dẫn Webhooks để thiết lập và Hướng dẫn Webhook Event để xem danh sách event đầy đủ.

Hãy thiết lập kỳ vọng cho khách hàng ngay tại checkout. Vì quyền truy cập chỉ được cấp sau khi khoản ghi nợ được xử lý xong, hãy cho khách hàng SEPA biết rằng đơn hàng của họ đang được xử lý và họ sẽ được thông báo khi thanh toán được xác nhận — nếu không, họ có thể mong đợi quyền truy cập tức thì như khi thanh toán bằng thẻ.

Satispay (Europe)

Satispay là một mạng lưới thanh toán di động phổ biến ở châu Âu, đặc biệt là tại Ý, cho phép khách hàng thanh toán trực tiếp từ ứng dụng Satispay mà không cần chia sẻ thông tin thẻ hoặc ngân hàng. Satispay quyết toán bằng EUR.

Tính năng

Thanh toán qua ứng dụng, độc lập với các mạng lưới thẻ
Mức độ sử dụng cao trên toàn nước Ý và đang phát triển ở các thị trường châu Âu khác
Hỗ trợ cả thanh toán một lần và subscription

Tính khả dụng

Tiền tệ thanh toán: EUR
Loại giao dịch: Thanh toán một lần và subscription

Cấu hình

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'
});

Các loại API Method

Loại	Method	Quốc gia
`ideal`	iDEAL	Hà Lan
`bancontact_card`	Bancontact	Bỉ
`eps`	EPS	Áo
`multibanco`	Multibanco	Bồ Đào Nha
`blik`	BLIK	Ba Lan
`sepa`	SEPA Direct Debit	Eurozone
`satispay`	Satispay	Europe (Italy)

Checkout châu Âu đa quốc gia

Đối với các doanh nghiệp phục vụ nhiều quốc gia châu Âu, hãy thêm tất cả các phương thức theo khu vực:

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 tự động chỉ hiển thị các phương thức phù hợp dựa trên vị trí của khách hàng. Khách hàng Hà Lan sẽ thấy iDEAL; khách hàng Bỉ sẽ thấy Bancontact.

Kiểm thử

Các phương thức thanh toán châu Âu có thể được kiểm thử trong Test Mode. Quy trình kiểm thử mô phỏng quy trình xác thực ngân hàng.

SEPA Direct Debit được kiểm thử theo cách khác — thay vì quy trình ngân hàng mô phỏng, bạn nhập trực tiếp IBAN kiểm thử. Xem IBAN SEPA dùng để kiểm thử.

Enable test mode

Sử dụng test API keys của Dodo Payments.

Set appropriate billing address

Đặt quốc gia của địa chỉ thanh toán khớp với phương thức thanh toán:

NL cho iDEAL
BE cho Bancontact
AT cho EPS
PT cho Multibanco
PL cho BLIK (với tiền tệ thanh toán PLN)
IT cho Satispay

Complete the test flow

Thực hiện theo quy trình xác thực ngân hàng mô phỏng trong môi trường kiểm thử.

Thực tiễn tốt nhất

Always include regional methods for target markets

Nếu bán hàng cho khách hàng Hà Lan, hãy thêm iDEAL. Không làm vậy cũng giống như không chấp nhận Visa tại Mỹ — bạn sẽ mất một lượng doanh số đáng kể.

Match currency to region

Hầu hết các phương thức thanh toán châu Âu đều yêu cầu EUR — hãy đảm bảo bảng giá của bạn hỗ trợ các giao dịch bằng Euro. Ngoại lệ duy nhất là BLIK, chỉ được cung cấp với tiền tệ thanh toán PLN (Złoty Ba Lan).

Handle redirects gracefully

Tất cả các phương thức châu Âu đều chuyển hướng khách hàng đến trang web của ngân hàng. Hãy đảm bảo việc xử lý return URL của bạn đủ tin cậy và có tính đến trường hợp người dùng thoát giữa chừng.

Provide card fallbacks

Không phải mọi khách hàng châu Âu đều có quyền truy cập vào các phương thức theo khu vực này (khách du lịch, người nước ngoài sinh sống tại địa phương, v.v.). Luôn thêm credit và debit làm phương án dự phòng.

Consider Multibanco timing

Thanh toán Multibanco qua ATM có thể mất vài giờ để hoàn tất. Đừng chặn việc hoàn tất đơn hàng vì thanh toán tức thì — hãy sử dụng webhook để xác nhận không đồng bộ.

Account for the SEPA 6-day delay

SEPA Direct Debit mất tối đa 6 ngày làm việc để được xác nhận. Không bao giờ hoàn tất đơn hàng khi chuyển hướng từ checkout hoặc khi nhận payment.processing — chỉ cấp quyền truy cập từ webhook payment.succeeded và thiết lập kỳ vọng tại checkout để khách hàng biết đơn hàng đang chờ xử lý. Xem Xử lý độ trễ xác nhận.

Khắc phục sự cố

European method not appearing

Kiểm tra:

Quốc gia thanh toán của khách hàng có khớp với quốc gia của method không?
Tiền tệ có được đặt là EUR không?
Method có được thêm vào allowed_payment_method_types không?

Giải pháp: Các phương thức châu Âu bị giới hạn nghiêm ngặt theo khu vực. Khách hàng có quốc gia thanh toán là DE (Đức) sẽ không thấy iDEAL, vì iDEAL chỉ dành cho Hà Lan.

Bank authentication failed

Nguyên nhân:

Khách hàng đã hủy trong quá trình xác thực ngân hàng
Hệ thống xác thực của ngân hàng tạm thời không khả dụng
Khách hàng đã nhập sai thông tin đăng nhập

Giải pháp: Khách hàng nên thử lại. Nếu sự cố vẫn tiếp diễn, hãy đề xuất thử một phương thức thanh toán khác.

Redirect not completing

Nguyên nhân:

Khách hàng đã đóng trình duyệt trong khi được chuyển hướng đến ngân hàng
Sự cố mạng trong quá trình xác thực
Return URL được cấu hình không chính xác

Giải pháp: Xác minh return URL chính xác và có thể truy cập. Đảm bảo URL này xử lý cả trạng thái thành công và thất bại.

Multibanco payment pending

Nguyên nhân: Khách hàng đã nhận mã tham chiếu thanh toán nhưng chưa thanh toán.Giải pháp: Đây là hành vi dự kiến đối với các khoản thanh toán qua ATM. Hãy chờ webhook xác nhận. Mã tham chiếu thường hết hạn sau 24–72 giờ.

SEPA payment stuck in processing

Nguyên nhân: SEPA Direct Debit được xử lý không đồng bộ thông qua ngân hàng của khách hàng.Giải pháp: Đây là hành vi dự kiến. Trạng thái payment.processing có thể kéo dài tối đa 6 ngày làm việc trước khi khoản ghi nợ được xử lý xong. Hãy chờ webhook cuối cùng payment.succeeded (hoàn tất đơn hàng) hoặc payment.failed (không hoàn tất đơn hàng) — không coi chuyển hướng từ checkout là xác nhận. Xem Xử lý độ trễ xác nhận.

Tuân thủ PSD2

Tất cả các phương thức thanh toán châu Âu đều tuân thủ các quy định PSD2 (Payment Services Directive 2):

Strong Customer Authentication (SCA) — Được tích hợp vào quy trình xác thực ngân hàng
Secure Communication — Tất cả dữ liệu được truyền qua các kênh bảo mật
Consumer Protection — Tuân thủ đầy đủ các quyền của người tiêu dùng EU

Các trang liên quan

Payment Methods Overview

Xem tất cả các phương thức thanh toán được hỗ trợ.

Adaptive Currency

Hỗ trợ tiền tệ và chuyển đổi tự động.

Checkout Guide

Hướng dẫn triển khai checkout đầy đủ.

Webhooks

Xử lý các xác nhận thanh toán không đồng bộ.

Lần sửa đổi cuối 26 tháng 8, 2026

​Tại sao nên cung cấp phương thức thanh toán nội địa tại châu Âu?

Higher Conversion

Lower Fraud

Real-Time Settlement

​Các phương thức được hỗ trợ

​iDEAL (Hà Lan)

​Cách thức hoạt động

​Các ngân hàng được hỗ trợ

​Cấu hình

​Bancontact (Bỉ)

​Tính năng

​Cấu hình

​EPS (Áo)

​Tính năng

​Các ngân hàng được hỗ trợ

​Cấu hình

​Multibanco (Bồ Đào Nha)

​Tùy chọn thanh toán

​Cách thức thanh toán qua ATM hoạt động

​Cấu hình

​BLIK (Ba Lan)

​Cách thức hoạt động

​Phạm vi khả dụng

​Cấu hình

​SEPA Direct Debit (Khu vực Eurozone)

​Cách thức hoạt động

​Tiến trình thanh toán

​Tính khả dụng

​Cấu hình

​IBAN SEPA dùng để kiểm thử

​Xử lý độ trễ xác nhận

​Satispay (Europe)

​Tính năng

​Tính khả dụng

​Cấu hình

​Các loại API Method

​Checkout châu Âu đa quốc gia

​Kiểm thử

​Thực tiễn tốt nhất

​Khắc phục sự cố

​Tuân thủ PSD2

​Các trang liên quan

Payment Methods Overview

Adaptive Currency

Checkout Guide

Webhooks

Tại sao nên cung cấp phương thức thanh toán nội địa tại châu Âu?

Các phương thức được hỗ trợ

iDEAL (Hà Lan)

Cách thức hoạt động

Các ngân hàng được hỗ trợ

Cấu hình

Bancontact (Bỉ)

Tính năng

Cấu hình

EPS (Áo)

Tính năng

Các ngân hàng được hỗ trợ

Cấu hình

Multibanco (Bồ Đào Nha)

Tùy chọn thanh toán

Cách thức thanh toán qua ATM hoạt động

Cấu hình

BLIK (Ba Lan)

Cách thức hoạt động

Phạm vi khả dụng

Cấu hình

SEPA Direct Debit (Khu vực Eurozone)

Cách thức hoạt động

Tiến trình thanh toán

Tính khả dụng

Cấu hình

IBAN SEPA dùng để kiểm thử

Xử lý độ trễ xác nhận

Satispay (Europe)

Tính năng

Tính khả dụng

Cấu hình

Các loại API Method

Checkout châu Âu đa quốc gia

Kiểm thử

Thực tiễn tốt nhất

Khắc phục sự cố

Tuân thủ PSD2

Các trang liên quan