Bancontact および SEPA ダイレクトデビットによるサブスクリプションを設定する

Bancontact および SEPA ダイレクトデビットを使用したサブスクリプションの作成と請求の方法をご紹介します。

Bancontact は 1 回限りの使用の支払い方法で、支払いごとに顧客の認証が必要となります。支払いが認証されると、Stripe は顧客の IBAN を SEPA ダイレクトデビット支払い方法に保存します。それ以降は、SEPA ダイレクトデビット支払い方法を使用して将来の決済を受け付けることができます。

この連携では、Stripe は、最初のサブスクリプションの支払いを Bancontact で請求して、顧客の銀行情報を収集します。無料トライアルを提供している場合、Stripe は Bancontact を通して顧客に 0.02 EUR を請求し、銀行情報を収集して、即時に返金します。

Checkout セッションは、顧客の購入意図の詳細を表すものです。顧客がサブスクリプションを開始しようとしたときにセッションを作成します。Checkout セッションに顧客がリダイレクトされると、購入完了のための決済フォームが表示されます。顧客は購入を完了すると、元のサイトにリダイレクトされます。

Stripe を設定する
サーバー側

任意の Stripe クライアントをインストールします。

Stripe CLI をインストールします (オプション)。CLI には Webhook のテストが用意されていて、これを実行することで商品および価格を作成できます。

Command Line
言語を選択homebrew
ソースからインストールする
 No results
# Install Homebrew to run this command: https://brew.sh/
brew install stripe/stripe-cli/stripe

# Connect the CLI to your dashboard
stripe login

その他のインストールオプションについては、Stripe CLI を使ってみるをご覧ください。

料金体系モデルを作成する
ダッシュボード
Stripe CLI

Recurring pricing models represent the products or services you sell, how much they cost, what currency you accept for payments, and the service period for subscriptions. To build the pricing model, create products (what you sell) and prices (how much and how often to charge for your products).

This example uses flat-rate pricing with two different service-level options: Basic and Premium. For each service-level option, you need to create a product and a recurring price. To add a one-time charge for something like a setup fee, create a third product with a one-time price.

Each product bills at monthly intervals. The price for the Basic product is 5 EUR. The price for the Premium product is 15 EUR. See the flat rate pricing guide for an example with three tiers.

商品を追加ページに移動し、2 つの商品を作成します。商品ごとに 1 つの価格を追加し、それぞれに毎月の継続請求期間を設定します。

プレミアム商品: 追加機能を備えたプレミアムサービス
- 価格：定額 | 15 EUR
基本商品: 最低限の機能を備えた基本サービス
- 価格：定額 | 5 EUR

価格を作成したら、価格 ID を記録しておき、他のステップで使用できるようにします。価格 ID は、price_G0FvDp6vZvdwRZ のように表示されます。

準備が完了したら、ページ右上の本番環境にコピーボタンを使用して、サンドボックスから本番環境に商品を複製します。

他の料金体系モデルについては、Billing の例をご覧ください。

Checkout セッションを作成する
クライアント側
サーバー側

サーバー側のエンドポイントを呼び出して Checkout セッションを作成する購入ボタンをウェブサイトに追加します。

index.html
<html>
  <head>
    <title>Checkout</title>
  </head>
  <body>
    <form action="/create-checkout-session" method="POST">
      <button type="submit">Checkout</button>
    </form>
  </body>
</html>

既存の Price の ID を使用して Checkout セッションを作成します。モードが subscription に設定されており、1 つ以上の継続価格を渡すことを確認してください。継続価格に加えて、1 回限りの価格を追加できます。Checkout セッションを作成したら、レスポンスで返された URL に顧客をリダイレクトします。

セッションの作成時には、payment_method_types を指定することも、ダッシュボードの設定に基づいて支払い方法が自動的に選択されるようにすることもできます。payment_method_types を指定しない場合は、ダッシュボードで Bancontact の継続支払いを有効にする必要があります。これにより、SEPA ダイレクトデビットは Bancontact の継続支払いにのみ有効になりますが、SEPA ダイレクトデビットの支払いが単独の支払い方法として有効になることはありません。

顧客は支払いを正常に完了すると、success_url にリダイレクトされます。これはお客様のウェブサイト上にあり、支払いの成功を顧客に知らせるページです。上記の例のように success_url に {CHECKOUT_SESSION_ID} テンプレート変数を含めて、成功ページでセッション ID を使用できるようにします。

顧客が支払いを完了せずに Checkout Session でお客様のロゴをクリックすると、Checkout が顧客を誘導してウェブサイトにリダイレクトします。これは顧客が Checkout にリダイレクトされる前に表示していたウェブサイトのページです。

デフォルトでは、Checkout セッションは作成後 24 時間で期限が切れます。

注意

次に挙げる理由により、支払い開始の検出時には、success_url へのリダイレクトのみに依存しないでください。

悪意を持つユーザが、支払いをせずに success_url に直接アクセスし、商品やサービスにアクセスできるようになる可能性があります。
顧客が支払いの成功後に success_url に到達するとは限りません。リダイレクトが発生する前に、顧客がブラウザタブを閉じることがあります。

支払いが成功したことを確認する

顧客が支払いを完了すると、success_url として指定された URL にリダイレクトされます。この URL は通常、顧客に支払いが成功したことを知らせるお客様の Web サイト上のページです。

ダッシュボード、カスタム Webhook、またはサードパーティーのプラグインを使用して、顧客に注文の確認メールを送信したり、売上をデータベースに記録したり、配送ワークフローを開始するなどの、支払い後のイベントを処理します。

成功した支払いは、ダッシュボードの支払いの一覧に表示されます。支払いをクリックすると、支払いの詳細ページに移動します。Checkout サマリーセクションには、請求先情報と購入された商品のリストが記載されています。これらを使用して、注文を手動でフルフィルメントすることができます。

顧客が継続サービスに対する支払いに成功すると、自動的にサブスクリプションが行われます。そのサブスクリプションは、ダッシュボードのサブスクリプションの一覧に新しいエントリとして記録されます。

メモ

Stripe は顧客が支払いに成功するたびにお客様にメール通知を送信し、今後受領する支払いの最新情報を把握できるようサポートします。ダッシュボードを使用してメール通知を設定します。

Zapier などのプラグインを使用すると、Stripe の支払いからの情報を利用して購入のフルフィルメントシステムを自動更新できます。

プラグインで対応可能な自動化の例の一部を以下に挙げます。

支払いの成功に対応して、注文の追跡に使用されるスプレッドシートを更新する
支払いの成功に対応して、在庫管理システムを更新する
メールまたはチャットアプリケーションを使用して、社内のカスタマーサービスチームへの通知をトリガーする

構築したシステムをテストする

テスト用 API キーを使用して、支払い方法として Bancontact を選択し、登録ボタンをクリックします。確定すると、支払いをオーソリまたは失敗させるオプションのあるテストページにリダイレクトされます。

Authorize test payment (テスト支払いをオーソリする) をクリックして、設定成功のケースをテストします。
Fail test payment (テスト支払いを失敗させる) をクリックして、顧客が認証に失敗するケースをテストします。

オプションサブスクリプションのトライアルを作成する

無料トライアルを使用すると、顧客が一定期間、支払いなしに商品にアクセスできます。サブスクリプションにトライアルを追加するには、Checkout セッションの作成時に、subscription_data.trial_period_days パラメーターまたは subscription_data.trial_end パラメーターを設定します。顧客の最初の支払いは、トライアル終了後に発生します。たとえば、サブスクリプションの開始時に 7 日間の無料トライアルを追加するには、subscription_data.trial_period_days を 7 に設定します。