ヨーロッパの決済方法 - 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がその通貨と請求タイプに一致する場合にのみ提供されます。

Method	Country	Currency	Subscriptions
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 のチェックアウトで一回限りの支払いに利用できます。定期購入には利用できません。

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
取引タイプ: 一回限りの支払いのみ。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

テストモードでは、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 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（PLN の請求通貨を使用する BLIK）
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

ヨーロッパのほとんどの決済方法では、顧客を銀行または決済アプリにリダイレクトします。フローの途中で離脱した顧客にも対応できるよう、return 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 は表示されません。

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（フルフィルメントを実行しない）を待ってください。チェックアウトのリダイレクトを確認として扱わないでください。確認の遅延への対応を参照してください。

Payment Methods Overview

サポートされているすべての決済方法を確認できます。

Adaptive Currency

通貨のサポートと自動換算。

Checkout Guide

チェックアウトの実装ガイド一式。

Webhooks

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

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

Higher Conversion

Bank Authentication

Real-Time Settlement

​対応決済方法

​iDEAL（オランダ）

​仕組み

​対応銀行

​設定

​Bancontact（ベルギー）

​特徴

​設定

​EPS（オーストリア）

​特徴

​対応銀行

​設定

​Multibanco（ポルトガル）

​支払い方法

​ATM支払いの仕組み

​設定

​BLIK（ポーランド）

​仕組み

​利用条件

​設定

​SEPA Direct Debit（ユーロ圏）

​仕組み

​支払いの流れ

​利用条件

​設定

​SEPAテスト用IBAN

​確認の遅延への対応

​Satispay（ヨーロッパ）

​特徴

​利用条件

​設定

​API Method Types

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

​テスト

​Multibanco のテスト用メールアドレス

​ベストプラクティス

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

​関連ページ

Payment Methods Overview

Adaptive Currency

Checkout Guide

Webhooks

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

対応決済方法

iDEAL（オランダ）

仕組み

対応銀行

設定

Bancontact（ベルギー）

特徴

設定

EPS（オーストリア）

特徴

対応銀行

設定

Multibanco（ポルトガル）

支払い方法

ATM支払いの仕組み

設定

BLIK（ポーランド）

仕組み

利用条件

設定

SEPA Direct Debit（ユーロ圏）

仕組み

支払いの流れ

利用条件

設定

SEPAテスト用IBAN

確認の遅延への対応

Satispay（ヨーロッパ）

特徴

利用条件

設定

API Method Types

ヨーロッパ複数国向けcheckout

テスト

Multibanco のテスト用メールアドレス

ベストプラクティス

トラブルシューティング

関連ページ