カナダでの将来のプレオーソリデビットによる支払いに備えて支払い方法の詳細を保存する

まず、Stripe アカウントが必要です。今すぐ登録してください。

アプリケーションから Stripe API にアクセスするには、Stripe の公式ライブラリを使用します。

# Available as a gem
sudo gem install stripe

# If you use bundler, you can add this line to your Gemfile
gem 'stripe'

将来の支払いに銀行口座を再利用するには、銀行口座を Customer (顧客) に関連付ける必要があります。

顧客がお客様のビジネスでアカウントを作成するときに、Customer オブジェクトを作成します。Customer オブジェクトの ID を、独自の内部的な顧客の表記に関連付けることにより、保存された決済手段の詳細を後で取得して使用できます。顧客がアカウントを作成していない場合でも、すぐに Customer オブジェクトを作成し、後でこのオブジェクトを顧客のアカウントの内部表記に関連付けることができます。

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

curl -X POST https://api.stripe.com/v1/customers \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

このガイドでは、カナダのプレオーソリデビット (PAD) を有効にする方法を紹介し、将来のカードによる支払いの設定と PAD の使用の違いを説明します。

支払い方法としてカナダのプレオーソリデビットを有効にする

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

Pre-authorized debit in Canada

1. acss_debit を payment_method_types のリストに追加します。
2. 追加の payment_method_options パラメーターを指定して、取引を説明します。詳細は以下をご覧ください。

Payments では、顧客が決済時に承認する Payment Schedule (支払いスケジュール) を指定する必要があります。ビジネスに適した同意書オプションの選択方法については、PAD 同意書を参照してください。

Checkout セッションを作成する

Stripe::Checkout::Session.create({
  mode: 'setup',
  payment_method_types: ['card'],
  payment_method_types: ['acss_debit'],

  # or you can take multiple payment methods with
  # payment_method_types: ['card', 'acss_debit', ...]
  payment_method_options: {
    acss_debit: {
      currency: 'cad',
      mandate_options: {
        payment_schedule: 'interval',
        interval_description: 'First day of every month',
        transaction_type: 'personal',
      }
    }
  },
  customer: customer.id,
  success_url: 'https://example.com/success',
  cancel_url: 'https://example.com/cancel',
})

Checkout セッション中に、銀行口座の詳細の収集と即時の確認を処理する UI モーダルが顧客に表示されます。オプションで少額入金を使用した確認へのフォールバックも可能です。顧客が少額入金による確認を選択した場合、Stripe は指定された銀行口座に 2 回の少額入金を自動的に送金します。この少額入金は、顧客のオンライン銀行明細書に表示されるまでに 1 〜 2 営業日かかります。入金が到着する予定になると、金額を確定し、Stripe で銀行口座を確認するためのリンクが記載されたメールが顧客に届きます。確認が完了すると、その決済手段は、今後の決済に使用できるようになります。

少額入金の確認メールを受信する

銀行口座の詳細を収集し、同意書を承認した後に、サンドボックスで少額入金の確認メールを受信するには、決済手段の詳細を確認する際に、payment_method[billing_details][email] フィールドに {any_prefix}+test_email@{any_domain} の形式でメールアドレスを指定します。

テスト用の口座番号

Stripe では、手動入力の銀行口座の組み込みが本番環境に移行する準備が整ったかどうかを確認するため、テスト用の口座番号をいくつか用意しています。支払いが自動的に成功または失敗するすべてのテスト用の口座は、以下のテスト用の少額入金を使用して確認してから設定を完了する必要があります。

サンドボックスで銀行口座確認の成功または失敗を再現するには、少額入金に以下の特定の金額を使用してください。

Checkout セッションが完了すると、PaymentMethod ID と Mandate ID を収集できます。これらを使用して、顧客に銀行口座の入力を再度求めることなく将来の決済を開始できます。

オフセッションで顧客に請求する準備ができたら、PaymentIntent の作成時に payment_method、customer、mandate ID を指定します。