コンテンツにスキップ
アカウント作成/サインイン
Stripe ドキュメントのロゴ
/
アカウントを作成サインイン
概要構築済みのシステムをアップグレード
オンライン決済
概要ユースケースを見つけるManaged Payments を使用する
対面決済
決済手段
決済シナリオ
決済以外の機能

メモ

このページはまだ日本語ではご利用いただけません。より多くの言語で文書が閲覧できるように現在取り組んでいます。準備が整い次第、翻訳版を提供いたしますので、もう少しお待ちください。

SEPA ダイレクトデビットによる支払いを受け付ける

SEPA ダイレクトデビット支払いの受け付けについて説明します。

注意

Stripe は、通貨、支払い方法の制限、その他のパラメーターを評価することで、適切な支払い方法を顧客に自動的に提示できます。

  • 決済の受け付けガイドに従って、動的な決済手段を使用するチェックアウトの導入を構築します。
  • 動的な決済手段を使用しない場合は、チェックアウトの導入で、決済方法を手動で設定するために以下のステップに従ってください。

Web サイトでの SEPA ダイレクトデビット支払いの受け付けは、支払いを追跡するオブジェクトの作成、支払い方法に関する情報と同意書承認の収集、および支払いを処理するための Stripe への支払いの送信で構成されます。Stripe はこの PaymentIntent と呼ばれる支払いオブジェクトを使用して、支払いが完了するまで、支払いのすべての状態の追跡と処理を行います。

メモ

SEPA Direct Debit は遅延通知型の支払い方法であるため、支払い後すぐには売上が利用可能になりません。通常、支払いがお客様のアカウントに入金されるまでに 5 business days かかります。

互換性を判断する

Checkout で SEPA ダイレクトデビットによる決済に対応するには、すべてのラインアイテムの価格をユーロ (通貨コード eur) で示す必要があります。

支払いを受け付ける

メモ

このガイドは、Checkout システムに基本的な決済の受け付けが存在することを前提として作成されています。

このガイドでは、SEPA ダイレクトデビットを有効化する手順をご案内します。動的な決済方法を使用して支払いを受け付ける方法と、決済方法を手動で設定する方法との違いを明らかにしています。

支払い方法として SEPA ダイレクトデビットを有効にする

新しい Checkout Session (セッション) を作成する際は、以下を行う必要があります。

  1. sepa_debit を payment_method_types のリストに追加します。
  2. すべての line_items が eur 通貨を使用していることを確認します。
Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price_data][currency]"=eur \
  -d "line_items[0][price_data][product_data][name]"=T-shirt \
  -d "line_items[0][price_data][unit_amount]"=2000 \
  -d "line_items[0][quantity]"=1 \
  -d mode=payment \
  -d "payment_method_types[0]"=card \
  -d "payment_method_types[1]"=sepa_debit \
  --data-urlencode success_url="https://example.com/success"

注文のフルフィルメント

決済受け付け後に、注文のフルフィルメントを実行する方法を説明します。

組み込みをテストする

Stripe は、組み込みの本番環境への移行準備が整っているかを確認する際に使用できるテスト用の番号をいくつか用意しています。

SEPA ダイレクトデビットを使用する Checkout の実装をテストする際は、SEPA ダイレクトデビットのテスト用番号を使用します。

IBAN をテストする
アカウント番号説明
IE29AIBK93115212345678PaymentIntent のステータスは、processing から succeeded に変化します。
IE24AIBK93115212345671The PaymentIntent status transitions from processing to succeeded after at least three minutes.
IE02AIBK93115212345679PaymentIntent のステータスは、processing から requires_payment_method に変化します。
IE94AIBK93115212345672The PaymentIntent status transitions from processing to requires_payment_method after at least three minutes.
IE51AIBK93115212345670PaymentIntent のステータスは、processing から succeeded に変化しますが、不審請求の申請が即座に作成されます。
IE10AIBK93115200343434支払金額がアカウントの週次支払い金額の上限を超えるため、支払いは charge_exceeds_source_limit エラーコードで失敗します。
IE69AIBK93115200121212支払い金額がアカウントの取引金額の上限を超えているため、支払いは charge_exceeds_weekly_limit エラーコードで失敗します。
IE10AIBK93115202222227支払いは insufficient_funds エラーコードで失敗します。

返金および不審請求の申請を処理する

SEPA ダイレクトデビットの返金期間は、元の支払い日から最大 180 日間です。

顧客は、元の支払いから最大 13 カ月、銀行を通じて支払いに対して不審請求を申請でき、異議申し立てのプロセスはありません。

SEPA ダイレクトデビットに対する不審請求の申請についてご紹介します。

オプションプレフィックスを使用して同意書参照番号をカスタマイズする

SEPA ダイレクトデビットの同意書参照番号をカスタマイズすると、同意書の識別をシンプルに行えます。これを行うには、オプションの payment_method_options.sepa_debit.mandate_options.reference_prefix 値を指定します。一意のシーケンスの先頭に reference_prefix を追加して、参照全体が一意のままになるようにします。

reference_prefix は以下の要件を満たしている必要があります。

  • 最大長: 12 文字
  • 数字または大文字で始める必要があります
  • 使用できる文字:
    • 大文字
    • 番号
    • スペース
    • 特殊文字: .、/、&、-、_
  • 先頭に STRIPE を付けることはできません。

プレフィックスには任意の区切り文字を含めます。デフォルトでは区切り文字は追加されません。末尾のスペースは、最大 1 スペースまでトリミングされます。有効な接頭辞を使用すると、結果の参照は常に 24 文字の長さになります。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d currency=eur \
  -d amount=100 \
  -d "payment_method_types[]"=sepa_debit \
  -d "payment_method_options[sepa_debit][mandate_options][reference_prefix]"=EX4MPL3-

生成される参照は EX4MPL3-19CNCI920C2M02O3 のようになります。

エラーコードメッセージ
invalid_sepa_mandate_reference_prefix_formatreference_prefix は最大 12 文字で、使用できるのは大文字、数字、スペース、および特殊文字 /、_、-、&、. のみです。先頭に STRIPE を付けることはできません。

オプション顧客の引き落とし日を設定する

Stripe が顧客の銀行口座から引き落としを行う日付は、ターゲット日 を使用して制御できます。ターゲット日は、現在の日付から 3 日以上、15 日以内である必要があります。

目標日は、顧客のアカウントから離脱するための資金をスケジュールします。

次のいずれかの基準を満たす目標日は、引き落としを翌営業日まで延期します。

  • 週末、祝日、またはその他の非営業日に当たる予定期日。
  • 3 営業日以内に到来する予定期日。

このパラメーターは、ベストエフォート方式で機能します。顧客の銀行は、祝日の関係やその他の理由により、異なる日付に引き落としを処理する場合があります。

参照情報