ヨーロッパの決済方法 - Dodo Payments Documentation

カードの代わりに銀行または現地の決済アプリからの支払いを好むヨーロッパの顧客にリーチするため、iDEAL、Bancontact、EPS、Multibanco、BLIK、SEPA Direct Debit、Satispayを受け付けます。現地の決済方法がオンライン決済で最も一般的な市場では、その方法を提供することでコンバージョン率を高められます。

なぜヨーロッパの現地決済方法なのか？

Higher Conversion

iDEALはオランダで最も利用されているオンライン決済方法です。iDEALがなければ、他の方法では支払わないオランダの顧客を失うことになります。

Bank Authentication

銀行認証型の決済方法では、顧客は銀行アプリまたは銀行のWebサイトで支払いを承認します。

Real-Time Settlement

このページのほとんどの決済方法では、チェックアウト中に支払いが確認されます。SEPA Direct DebitとMultibancoのATM決済は後で確認されます。

対応決済方法

各決済方法は、checkoutがその通貨と請求タイプに一致する場合にのみ提供されます。

決済方法	国	通貨	サブスクリプション
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を提供するには、idealをallowed_payment_method_typesに含め、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モバイルアプリでの支払いに対応
checkout中に支払いを確認
顧客による追加登録が不要

設定

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）を使用すると、オーストリアの顧客は自身の銀行からオンライン銀行振込で支払えます。

特徴

オーストリアの銀行に直接接続
checkout中に支払いを確認
オーストリアの消費者から高い信頼を得ている

対応銀行

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で支払い参照番号を使って支払うこともできます。

支払い方法

顧客は次の3つの方法で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支払いは、顧客が参照番号を支払った時点で完了します。これはcheckoutのかなり後になる場合があります。支払いが確認されたタイミングを把握するには、webhookを使用してください。

BLIK（ポーランド）

BLIKはポーランドで最も人気のあるモバイル決済方法です。顧客は銀行アプリで生成した1回限りの6桁コードを使って支払います。BLIKの支払いはEURではなく、PLN（ポーランドズウォティ）で請求されます。

仕組み

顧客は銀行アプリでコードを生成し、checkoutで入力して、アプリ内で支払いを承認します。

利用条件

請求通貨： PLNのみ
取引タイプ： 1回限りの支払いのみ。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の請求通貨が必要です。Dodo PaymentsがPLNで請求するのは、Adaptive Currencyが有効な場合のみです。Adaptive Currencyを有効にすると、ポーランドの顧客にはPLNで請求され、BLIKを利用できるようになります。

SEPA Direct Debit（ユーロ圏）

SEPA Direct Debitを使用すると、ユーロ圏の顧客はカードではなく銀行口座から支払えます。EURのcheckoutで、1回限りの支払いとサブスクリプションの両方に提供されます。請求先の国は、オーストリア、ベルギー、エストニア、フィンランド、フランス、ドイツ、アイルランド、イタリア、ラトビア、リトアニア、オランダ、ポルトガル、スロバキア、またはスペインである必要があります。

SEPA Direct Debitは即時決済ではありません。支払いの確認には最大6営業日かかります。 カード決済とは異なり、checkoutで顧客が承認しただけでは入金が完了したことになりません。checkoutのリダイレクト時、またはpayment.processingの時点で注文を履行しないでください。payment.succeeded webhookを待ってください。

仕組み

顧客がcheckoutで引き落としを承認すると、Dodo Paymentsが銀行口座から資金を回収します。銀行による引き落としの処理は非同期で行われるため、最終結果に達するまで支払いはprocessing状態になります。

支払いの流れ

SEPAの支払いは次の段階を経ます。

段階	タイミング	支払いステータス	意味
承認	checkout時	`processing`	顧客が引き落としを承認し、リダイレクトされて戻ってきた状態です。まだ資金は移動していないため、注文を履行しないでください。
確認	最大6営業日後	`succeeded`	銀行による引き落とし処理が完了した状態です。ここで注文を履行します。
失敗	最大6営業日後	`failed`	資金不足などの理由で引き落としを回収できなかった状態です。注文を履行せず、顧客に通知してください。

顧客がサイトを離れてから数日後に確認が届くため、アクセスを許可するのはcheckoutのリダイレクトではなくwebhookハンドラーで行う必要があります。確認の遅延への対応を参照してください。

利用条件

請求通貨： EUR
取引タイプ： 1回限りの支払いとサブスクリプション

設定

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

テストモードでは、checkoutで次のいずれかのIBANを入力すると、特定の結果を強制できます。

テスト用IBAN	動作
`DE89370400440532013000`	支払いが成功します。
`DE08370400440532013003`	少なくとも3分の遅延後に支払いが成功します。
`DE62370400440532013001`	支払いが失敗します。
`DE78370400440532013004`	少なくとも3分の遅延後に支払いが失敗します。
`DE35370400440532013002`	支払いが成功した後、直ちに異議申し立てが行われます。
`DE65370400440002222227`	資金不足により支払いが失敗します。
`DE18370400440000066666`	銀行口座が使用できないため、決済方法を作成できません。

国別の動作をテストするには、別のユーロ圏の国の成功用IBANを使用します。

国	成功用IBAN
オーストリア	`AT611904300234573201`
ベルギー	`BE62510007547061`
エストニア	`EE382200221020145685`
フィンランド	`FI2112345600000785`
フランス	`FR1420041010050500013M02606`
アイルランド	`IE29AIBK93115212345678`
ルクセンブルク	`LU280019400644750000`

遅延テスト用IBANを使用して、checkoutのリダイレクトではなくwebhookハンドラーがアクセスを許可することを確認してください。SEPAの支払いは、顧客がcheckoutを離れてからかなり後に確認されます。

確認の遅延への対応

SEPAの決済はcheckoutの最大6営業日後に完了するため、ブラウザーのリダイレクトから支払いが完了したかどうかを判断することはできません。代わりにwebhookイベントを使用して履行を実行してください。イベントtypeを有効にし、各段階を処理します。

イベントタイプ	発生タイミング	対応
`payment.processing`	顧客がcheckoutで引き落としを承認し、リダイレクトされて戻ったとき。	履行しないでください。注文を保留中としてマークします。必要に応じて、支払いを処理中であることを顧客に伝えます。
`payment.succeeded`	最大6営業日後に銀行が引き落とし処理を完了したとき。	注文を履行します。アクセスを許可し、商品をプロビジョニングして、領収書を送信します。
`payment.failed`	引き落としを回収できなかったとき。	顧客に通知し、再試行を促します。注文を履行しないでください。

checkoutのリダイレクトやpayment.processingではなく、webhookのpayment.succeededで注文を履行してください。リダイレクトは顧客が引き落としを承認するとすぐに発生しますが、資金が決済されるのは数日後です。

次のExpressハンドラーは、イベントを処理する前にclient.webhooks.unwrapを使って各イベントの署名を検証します。エンドポイントの設定については、Webhooksガイドを参照してください。すべてのイベントについては、Webhook Event Guideを参照してください。

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

checkoutで顧客に期待値を伝えてください。アクセスが許可されるのは引き落としが完了した後だけなので、SEPAの顧客には注文を処理中であることと、支払いの確認後に通知することを伝えます。そうしないと、カード決済と同じようにすぐにアクセスできると期待される可能性があります。

Satispay（ヨーロッパ）

Satispayはヨーロッパのモバイル決済ネットワークで、最大のユーザーベースをイタリアに持ちます。顧客はカード情報や銀行情報を共有せず、Satispayアプリから支払います。Satispayの支払いはEURで請求されます。

特徴

カードネットワークに依存しないアプリベースの支払い
イタリアで広く普及し、他のヨーロッパ市場でも利用が拡大
1回限りの支払いとサブスクリプションの両方に対応

利用条件

請求通貨： EUR
取引タイプ： 1回限りの支払いとサブスクリプション
金額： 1回の支払いにつき€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に渡します。

Type	Method	Country
`ideal`	iDEAL	オランダ
`bancontact_card`	Bancontact	ベルギー
`eps`	EPS	オーストリア
`multibanco`	Multibanco	ポルトガル
`blik`	BLIK	ポーランド
`sepa`	SEPA Direct Debit	ユーロ圏
`satispay`	Satispay	ヨーロッパ（イタリア）

ヨーロッパ複数国向けcheckout

複数のヨーロッパ諸国で販売するには、フォールバックとしてカードを加え、すべての地域決済方法を含めます。

// `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 and subscriptions)
    '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を参照してください。

Enable Test Mode

ダッシュボードのサイドバーでLive Modeスイッチをオフにし、テストモードで作成したAPIキーを使用します。

Set Appropriate Billing Address

請求先住所の国を決済方法に合わせて設定します。

NL（iDEAL用）
BE（Bancontact用）
AT（EPS用）
PT（Multibanco用）
PL（BLIK用、請求通貨はPLN）
IT（Satispay用）

Complete the Test Flow

テストモードで、シミュレートされた銀行認証フローに従います。

ベストプラクティス

Always include regional methods for target markets

オランダの顧客に販売する場合は、iDEALを含めてください。iDEALを省くことは、米国でVisaを受け付けないようなものであり、売上の大きな割合を失うことになります。

Match currency to region

ヨーロッパの決済方法のほとんどはEURを必要とするため、価格設定がEUR取引に対応していることを確認してください。唯一の例外はBLIKで、PLN（ポーランドズウォティ）の請求でのみ提供されます。

Handle redirects gracefully

ヨーロッパの決済方法の多くは顧客を銀行または決済アプリへリダイレクトします。途中でフローを離脱した顧客にも対応できるよう、return URLの処理が機能することを確認してください。

Provide card fallbacks

ヨーロッパのすべての顧客がこれらの地域決済方法を利用できるわけではありません。たとえば、旅行者や国外居住者などです。フォールバックとしてcreditとdebitを含めてください。利用可能な決済方法がない場合、checkoutセッションは失敗します。

Consider Multibanco timing

MultibancoのATM支払いは完了まで数時間かかる場合があります。即時の支払い完了を前提に注文の履行を止めないでください。非同期の確認にはwebhookを使用します。

Account for the SEPA 6-day delay

SEPA Direct Debitの確認には最大6営業日かかります。checkoutのリダイレクト時やpayment.processingで注文を履行しないでください。アクセスはpayment.succeeded webhookからのみ許可し、checkoutで顧客に注文が保留中であることを伝えてください。確認の遅延への対応を参照してください。

トラブルシューティング

European method not appearing

確認事項：

顧客の請求先の国は、決済方法の国と一致していますか？
請求通貨はEURですか、それともBLIKの場合はPLNですか？
allowed_payment_method_typesに決済方法が含まれていますか？
checkoutは1回限りの支払い用ですか？iDEAL、Bancontact、EPS、Multibanco、BLIKはサブスクリプションには提供されません。

解決策： 国別の決済方法は、その国に対してのみ表示されます。請求先の国がDE（ドイツ）の顧客には、オランダ限定のiDEALは表示されません。

Bank authentication failed

原因：

顧客が銀行認証中にキャンセルした。
銀行の認証システムが一時的に利用できなかった。
顧客が誤った認証情報を入力した。

解決策： 顧客は再試行してください。失敗が続く場合は、別の決済方法を提案してください。

Redirect not completing

原因：

顧客が銀行へのリダイレクト中にブラウザーを閉じた。
ネットワークの問題により認証が中断された。
return URLが正しく設定されていない。

解決策： return URLが正しく、到達可能であり、成功と失敗の両方の状態を処理できることを確認してください。

Multibanco payment pending

原因： 顧客は支払い参照番号を受け取りましたが、まだ支払っていません。解決策： ATM支払いでは想定される動作です。webhookによる確認を待ってください。参照番号は、顧客に表示された制限時間後に期限切れになります。

SEPA payment stuck in processing

原因： SEPA Direct Debitは顧客の銀行を通じて非同期に決済されます。解決策： 想定される動作です。payment.processing状態は、引き落としが完了するまで最大6営業日続く場合があります。最終的なpayment.succeeded webhook（履行）またはpayment.failed webhook（履行しない）を待ってください。checkoutのリダイレクトを確認として扱わないでください。確認の遅延への対応を参照してください。

Payment Methods Overview

対応しているすべての決済方法を確認します。

Adaptive Currency

通貨の対応と自動換算について説明します。

Checkout Guide

checkoutの実装ガイドです。

Webhooks

支払いの確認を非同期で処理します。

​なぜヨーロッパの現地決済方法なのか？

Higher Conversion

Bank Authentication

Real-Time Settlement

​対応決済方法

​iDEAL（オランダ）

​仕組み

​対応銀行

​設定

​Bancontact（ベルギー）

​特徴

​設定

​EPS（オーストリア）

​特徴

​対応銀行

​設定

​Multibanco（ポルトガル）

​支払い方法

​ATM支払いの仕組み

​設定

​BLIK（ポーランド）

​仕組み

​利用条件

​設定

​SEPA Direct Debit（ユーロ圏）

​仕組み

​支払いの流れ

​利用条件

​設定

​SEPAテスト用IBAN

​確認の遅延への対応

​Satispay（ヨーロッパ）

​特徴

​利用条件

​設定

​API Method Types

​ヨーロッパ複数国向けcheckout

​テスト

​ベストプラクティス

​トラブルシューティング

​関連ページ

Payment Methods Overview

Adaptive Currency

Checkout Guide

Webhooks

なぜヨーロッパの現地決済方法なのか？

対応決済方法

iDEAL（オランダ）

仕組み

対応銀行

設定

Bancontact（ベルギー）

特徴

設定

EPS（オーストリア）

特徴

対応銀行

設定

Multibanco（ポルトガル）

支払い方法

ATM支払いの仕組み

設定

BLIK（ポーランド）

仕組み

利用条件

設定

SEPA Direct Debit（ユーロ圏）

仕組み

支払いの流れ

利用条件

設定

SEPAテスト用IBAN

確認の遅延への対応

Satispay（ヨーロッパ）

特徴

利用条件

設定

API Method Types

ヨーロッパ複数国向けcheckout

テスト

ベストプラクティス

トラブルシューティング

関連ページ