コンテンツにスキップ
アカウントを作成
または
サインイン
Stripe ドキュメントのロゴ
/
アカウントを作成
サインイン
概要構築済みのシステムをアップグレード
オンライン決済
概要ユースケースを見つけるManaged Payments を使用する
決済手段
支払いインターフェイス
決済シナリオ
店頭支払い
決済にとどまらない機能

注

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

今後の支払いのために SEPA ダイレクトデビット詳細を保存する

将来の SEPA ダイレクトデビット支払いに備えて支払い方法の詳細を保存する方法を紹介します。

セットアップモードの Checkout を使用して、事前に SEPA ダイレクトデビット支払いの詳細を収集し、後で最終的な金額や支払い日を決定できます。この機能の用途を紹介します。

注

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

Customer を作成または取得する
サーバ側

以降の支払いに SEPA ダイレクトデビットの支払い方法を再利用するには、その方法を Customer に関連付ける必要があります。

顧客がアカウントを作成する際、Customer オブジェクトを作成してください。この Customer オブジェクトの ID を、顧客を表す社内の内部表記と関連付けることで、保存されている支払い方法の詳細を後で取得して使用することができます。

新しい Customer を作成するか、または既存の Customer を取得して、この支払いと関連付けます。サーバに以下のコードを含め、新しい Customer を作成します。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl -X POST https://api.stripe.com/v1/customers \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

支払いを事前設定する

注

このガイドは、Checkout の基本的な支払いを事前設定するシステムが存在することを前提としています。

このガイドでは、SEPA ダイレクトデビットを有効にする方法を説明し、将来のカードによる決済の設定と SEPA ダイレクトデビットの使用の違いを紹介します。

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

新しい Checkout セッションを作成する際に、sepa_debit を payment_method_types のリストに追加する必要があります。

Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
Stripe::Checkout::Session.create({
  mode: 'setup',
  payment_method_types: ['card'],
  payment_method_types: ['card', 'sepa_debit'],
  customer: customer.id,
  success_url: 'https://example.com/success',
  cancel_url: 'https://example.com/cancel',
})

組み込みをテストする

組み込みのテストには、以下の IBAN を使用できます。各 IBAN に対応する支払い方法の詳細が収集されますが、支払い時にはそれぞれ異なる動作を示します。

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 ダイレクトデビットの同意書参照番号をカスタマイズすると、同意書の識別をシンプルに行えます。これを行うには、オプションの 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 を付けることはできません。

参照情報

このページはお役に立ちましたか。
はいいいえ