コンテンツにスキップ
アカウント作成/サインイン
Stripe ドキュメントのロゴ
/
アカウントを作成サインイン
概要決済を受け付ける構築済みのシステムをアップグレード
オンライン決済
概要ユースケースを見つけるManaged Payments を使用する継続課金
対面決済
決済手段
決済業務
残高と売上処理にかかる期間領収書返金とキャンセル
高度な連携システム
決済以外の機能

メモ

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

カナダのプレオーソリデビットの支払いを受け付ける

カスタムの支払いフォームを構築するか、Stripe Checkout を使用してカナダのプレオーソリデビットの支払いを受け付けます。

Web サイトでのカナダのプレオーソリデビット (PAD) 決済の受け付けは、決済を追跡するオブジェクトの作成、決済手段に関する情報と同意書承認の収集、決済を処理するための Stripe への決済の送信、および顧客の銀行口座の確認で構成されます。

Checkout を使用すると、支払い方法タイプとして acss_debit を指定して Checkout セッションを作成し、支払いが完了するまで支払いのステータスを追跡し、処理できます。

メモ

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

互換性を判断する

カナダのプレオーソリデビット支払いに対応するには、Checkout セッションが次の条件をすべて満たしている必要があります。

  • 使用できるのは単一の項目だけです (Checkout はまだサブスクリプションには対応していません)。
  • ラインアイテムの価格はすべて、カナダドルまたはアメリカドル (通貨コード cad または usd) で示す必要があります。
  • すべてのラインアイテムの価格が、同じ通貨である必要があります。異なる通貨のラインアイテムが存在する場合は、通貨ごとに別の Checkout セッションを作成します。

取引通貨

カナダのほとんどの銀行口座で保有されているのはカナダドル (CAD) ですが、少数ながら米ドル (USD) などの他の通貨を保有する口座もあります。PAD では CAD と USD のどちらでの支払いも可能ですが、支払いの失敗を避けるため、顧客に適切な通貨を選択することが重要です。

多くのカードベースの支払い方法とは異なり、CAD の口座からの USD での引き落としや、USD の口座からの CAD での引き落としは成功しない可能性があります。多くの場合、このような引き落としを試行すると、遅延して支払い失敗が発生します。この遅延は最大 5 営業日です。

このような支払い失敗を避けるには、顧客の口座が USD での引き落としに対応していることが確認できている場合を除き、PAD の支払いは CAD で引き落としすることが最も安全です。

支払いを受け付ける

メモ

このガイドを使用する前に、まず Checkout で決済を受け付ける実装を構築します。

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

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

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

  1. acss_debit を payment_method_types のリストに追加します。
    • ダッシュボードで決済手段を管理する場合は、動的な決済手段 がデフォルトで有効になっているため、決済セッションに payment_method_types を含める必要はありません。ただし、payment_method_options を含める必要があります。
  2. すべての line_items が cad 通貨を使用していることを確認します。
  3. 追加の payment_method_options パラメーターを指定して、取引を説明します。詳細は以下をご覧ください。

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

パラメータ値必須
payment_method_options[acss_debit][mandate_options][payment_schedule]同意書の支払いスケジュール。使用可能な値は interval、sporadic、combined です。ビジネスに適したスケジュールを選択するには、PAD 同意書の概要を参照してください。はい
payment_method_options[acss_debit][mandate_options][interval_description]支払いスケジュールについて説明するテキスト。ビジネスに適した間隔の説明を作成するには、PAD 同意書の概要を参照してください。payment_schedule の値が interval または combined の場合は必須
payment_method_options[acss_debit][mandate_options][transaction_type]同意書を使用する取引のタイプ。personal 的な理由による取引の場合と business 的な理由による取引の場合があります。はい

Checkout セッションを作成する

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]"=cad \
  -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_options[acss_debit][mandate_options][payment_schedule]"=interval \
  -d "payment_method_options[acss_debit][mandate_options][interval_description]"="First day of every month" \
  -d "payment_method_options[acss_debit][mandate_options][transaction_type]"=personal \
  -d "payment_method_types[0]"=acss_debit \
  --data-urlencode success_url="https://example.com/success"

Checkout セッション中、顧客には銀行口座情報の収集と即時確認を処理する UI モーダルが表示され、オプションとして少額入金を使用した確認も選択できます。まれなケースですが、顧客が少額入金による確認を選択した場合、Stripe は指定された銀行口座に 2 件の少額入金を送金します。この入金が顧客のオンライン銀行明細書に表示されるまでには 1 ～ 2 営業日かかります。入金の予想到着日に、入金額の確認と Stripe での銀行口座確認を行うためのリンクが記載されたメールが顧客に届きます。確認が完了すると、支払いの処理が開始されます。

注文のフルフィルメント

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

組み込みをテストする

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

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

テスト用の口座番号

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

銀行番号支店番号口座番号シナリオ
00011000000123456789少額入金が確認された後、支払いが直ちに成功します。
00011000900123456789少額入金が確認された後、3 分遅延してから支払いが成功します。
00011000000222222227少額入金が確認された後、支払いが直ちに失敗します。
00011000900222222227少額入金が確認された後、3 分遅延してから支払いが失敗します。
00011000000666666661確認用の少額入金の送金が失敗します。
00011000000777777771支払い金額が原因でアカウントの週次支払い金額の上限を超えるため、支払いが失敗します。
00011000000888888881支払い金額がアカウントの取引限度額を超えているため、支払いが失敗します。

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

少額入金の金額シナリオ
32 および 45口座が無事に確認されます。
10 および 11許容された確認回数の超過をシミュレーションします。
その他の任意の数字の組み合わせ口座の確認が失敗します。

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

カナダのプレオーソリデビットの返金期間は、元の支払い日から最大 180 日間です。

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

カナダのプリオーソリデビットに対する不審請求の申請についてご紹介します。

その他の考慮事項

少額入金確認の失敗

銀行口座が少額入金の確認を保留している場合、顧客が確認に失敗する理由は以下のとおりです。

  • 少額入金が顧客の銀行口座に送信できませんでした (これは通常、銀行口座が解約済みまたは使用不可であるか、銀行口座番号が不正確である場合に発生します)。
  • 顧客が口座の確認に 3 回失敗しました。この上限を超えると、その銀行口座は確認することも、再利用することもできなくなります。
  • 顧客は要求された 10 日以内に銀行口座を確認しませんでした。

これらのいずれかの理由で銀行口座の確認に失敗した場合、checkout.session.async_payment_failed イベントを処理して、新たに注文を行うよう顧客に連絡できます。

オプション即時の確認のみ
サーバ側

デフォルトでは、カナダのプレオーソリデビットの決済で、顧客は銀行口座の即時確認、または少額入金を使用できます。オプションで、Checkout セッションの作成時に payment_method_options[acss_debit][verification_method]パラメーターを使用するだけで、銀行口座の即時確認のみを要求することもできます。

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 mode=payment \
  -d customer={{CUSTOMER_ID}} \
  -d "payment_method_types[0]"=acss_debit \
  -d "line_items[0][price_data][currency]"=cad \
  -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 "payment_method_options[acss_debit][mandate_options][payment_schedule]"=interval \
  --data-urlencode "payment_method_options[acss_debit][mandate_options][interval_description]"="On November 25, 2021" \
  -d "payment_method_options[acss_debit][mandate_options][transaction_type]"=personal \
  -d "payment_method_options[acss_debit][verification_method]"=instant \
  --data-urlencode success_url="https://example.com/success"

オプション少額入金による確認のみ
サーバ側

デフォルトでは、カナダのプレオーソリデビット決済では、顧客は銀行口座の即時確認、または少額入金を使用できます。オプションで、Checkout セッションの作成時に payment_method_options[acss_debit][verification_method] パラメーターを使用するだけで、銀行口座の即時確認のみを要求することもできます。

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 mode=payment \
  -d customer={{CUSTOMER_ID}} \
  -d "payment_method_types[0]"=acss_debit \
  -d "line_items[0][price_data][currency]"=cad \
  -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 "payment_method_options[acss_debit][mandate_options][payment_schedule]"=interval \
  --data-urlencode "payment_method_options[acss_debit][mandate_options][interval_description]"="On November 25, 2021" \
  -d "payment_method_options[acss_debit][mandate_options][transaction_type]"=personal \
  -d "payment_method_options[acss_debit][verification_method]"=microdeposits \
  --data-urlencode success_url="https://example.com/success"

オプション顧客の振替日を設定する
サーバ側

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

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

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

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

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

注意

認証方法 として マイクロデポジット を使用している場合、 ターゲット日 を設定することはできません。これは、認証プロセスにターゲット日より長い時間がかかる可能性があり、その結果、支払いが予定より遅れて到着する恐れがあるためです。

参照情報