Stripe Billing を使用してCommercetools のサブスクリプションを有効にする

Commercetools の加盟店センターの商品カタログセクションで必要な属性とバリアントを定義することで、任意の Commercetools 商品の サブスクリプションを有効にできます。顧客がサブスクリプション商品を購入すると、統合により Stripe Billing を使用して、その注文に対する継続支払いを登録します。Stripe はこのサブスクリプションを管理し、Commercetools のサブスクリプション設定に基づいて決済の回収を定期的に試行します。決済が失敗した場合、Stripe は顧客に通知して請求先情報の更新を依頼できます。これは サブスクリプションとメールの設定で設定できます。決済が成功すると、ウェブサイトは Stripe から webhook 通知を受け取ります。モジュールは、更新のたびに Commercetools 内で新しい注文を自動的に作成します。このアプリは、各反復の前に個々の継続サブスクリプション商品の配送料と税額を再計算します。

はじめに

• コンポーザブルコマースの Stripe 決済アプリをインストールしました。
• Stripe アカウントで Stripe Billing が有効になっています。
• payment-app-subscription-information というアプリによって生成された商品タイプを使用して、関連する商品とそのバリエーションを作成しました。
• Webhook エンドポイントは、次のイベントを処理します。
  • invoice.paid
  • invoice.payment_failed

製品バリエーションの設定

サブスクリプションを有効化および設定する方法

サブスクリプションは、継続商品が Commercetools ストアフロントで公開されると自動的に有効になります。商品は Commercetools 加盟店センターで 1 回限りおよび継続として設定されます。商品バリアントをサブスクリプションとしてマークするには、payment-app-subscription-information カスタムタイプを適用し、以下のフィールドを定義します。

コアコンポーネント概要

Stripe のサブスクリプション管理は、主に以下の主要サービスによって管理されます。

• StripeSubscriptionService: サブスクリプション業務のメインオーケストレーター
• CtPaymentCreationService: CommerceTools の決済作成を処理します
• StripePaymentService: 決済処理と注文作成を管理します
• SubscriptionEventConverter: Stripe イベントを CT 取引に変換します

比例配分の処理

比例配分の処理

このアプリは、Commercetools 製品カタログセクション内の製品バリエーション設定に基づいて、比例配分を自動的にサポートします。有効にすると、以下のようになります。

• ダウングレードの場合、返金は自動的に作成され、元の注文の一部として記録されます。
• 追加の決済が必要なアップグレードの場合、新しい注文の作成が残りの請求期間の比例配分された金額でトリガーされます。

利用可能なサービス

この構成可能なコマースアプリは、混在カートや注文作成のサポートなど、サブスクリプション管理のためのコアロジックを提供します。このアプリは、サブスクリプションコマースのユースケースを拡張するために必要な必須の API エンドポイント、サブスクリプションの作成と管理、顧客のサブスクリプションリストの取得、他の commercetools 製品によるサブスクリプションの更新、サブスクリプションのキャンセルを提供します。パッケージ化された事前構築済みのサービスを使用して、アプリを拡張できます。