Commercetools から Stripe Payment Connector をインストールして設定する

Commercetools のストアフロントで、Connect Marketplace のコネクターをインストールして設定します。

Stripe Payment Connector をインストールする前に、以下のことを確認してください。

コネクターをインストールする Commercetools インスタンス内の組織とプロジェクトを指定します。
Commercetools インスタンスから直接コネクターを設定してインストールできるように準備します。

Stripe Payment Connector をインストールする

Commercetools インスタンス内の Commercetools Connect Marketplace で Stripe Payment Connector を選択します。
Commercetools プロジェクトビューのコネクターリスト
コネクターをインストールするために必要なリージョン、プロジェクト、組織を選択します。
Commercetools のプロジェクト設定
設定の詳細と環境情報を入力する
環境変数とコネクターの設定
Stripe ダッシュボードでテスト用取引 URL を使用して Webhook を作成し、Webhook 署名シークレットをコピーします。
このテスト用取引 URL は、Payment Connector デプロイ後のスクリプトによって正しい URL に自動更新されます。

Stripe Payment Connector を設定する

CTP_PROJECT_KEY: Commercetools のコンポーザブル・コマースプロジェクトのキー。
CTP_SCOPE: Commercecetools クライアントがアクセスできるエンドポイント、およびエンドポイントへの読み取りと書き込みのアクセス権を制限するスコープ。
CTP_AUTH_URL: Commercetools プラットフォームの認証用 URL。これは、Commercetools のコンポーザブル・コマースへのあらゆる API コールで必要となる OAuth 2.0 トークンを生成するために使用されます。デフォルト値は https://auth.europewest1.gcp.commercetools.com です。
CTP_API_URL: Commercetools のコンポーザブル・コマース API の URL。デフォルト値は https://api.europe-west1.gcp.commercetools.com です。
CTP_SESSION_URL: Commercetools プラットフォームでのセッション作成用 URL。コネクターは、作成されたセッションに依存する形でイネーブラーとプロセッサーの間で情報を共有することができます。デフォルト値は https://session.europewest1.gcp.commercetools.com です。
CTP_JWKS_URL: JSON Web Key Set を提供する URL。
CTP_JWT_ISSUER: JWE 検証プロセスで必要となる JSON Web Token 内部のカード発行会社。
STRIPE_CAPTURE_METHOD: Stripe のキャプチャー方法 (手動または自動)。デフォルト値は automatic です。
STRIPE_APPEARANCE_PAYMENT_ELEMENT: Stripe Elements はデザインカスタマイズに対応しているため、デザインオプションを使用してサイトのデザインに合わせた調整が可能です。この値は、Payment Element コンポーネントの固有デザインを定義します。
STRIPE_APPEARANCE_EXPRESS_CHECKOUT: Stripe Elements はデザインカスタマイズに対応しているため、デザインオプションを使用してサイトのデザインに合わせた調整が可能です。この値は、Express Checkout Element コンポーネントの固有デザインを定義します。
CTP_CLIENT_SECRET: Commercetools のコンポーザブル・コマースで使用するユーザーアカウントの client secret。これは、Commercetools クライアントが SDK を介して Commercetools のコンポーザブル・コマースと通信するために使用されます。
CTP_CLIENT_ID: Commercetools のコンポーザブル・コマースで使用するユーザーアカウントのクライアント ID。これは、Commercetools クライアントが SDK を介して Commercetools のコンポーザブル・コマースと通信するために使用されます。
STRIPE_SECRET_KEY: Stripe はアカウントの API キーを使用して、API リクエストを認証します。この目的で制限付きのアクセスキーを作成し、デフォルトの API シークレットキーは使用しないことを強くお勧めします
STRIPE_WEBHOOK_ID: Webhook エンドポイントに使用される Stripe の一意の ID。
STRIPE_WEBHOOK_SIGNING_SECRET: 正式なライブラリを使用して Webhook 署名を確認するための Stripe のシークレットキー。このキーは Stripe ダッシュボードで作成されます。

この支払いコネクターは、次の 2 つの主要リンクを作成します。

Payment Connector JS Enabler コンポーネント: 支払いコンポーネントが埋め込まれている URL (例: https://assets-{{uuid}}.assets.uscentral1.gcp.preview.commercetools.app/connector-enabler.es.js)
Payment Connector のプロセッサー: すべての Webhook が送信され、Commerceetools の支払いトランザクションに変換される URL (例: https://service-{{uuid}}.uscentral1.gcp.preview.commercetools.app)

決済システムを拡張する

特定のニーズに合わせて既存の決済システムを構築および拡張する場合は、以下の手順に従います。

GitHub で入手できるコネクターコードベースを使用します。
コネクターをローカルにデプロイします。
プロセッサーとイネーブラーの両方で .env 設定を更新します。

このパスを選択すると、コネクターのデプロイと設定に対する責任を負うことになります。

一般的な設定

Payment Connector の設定で、Payment Connector Element によって生成されたコンポーネントのキャプチャーモードを変更できます (手動または自動)。
Payment Connector Enabler は、Payment Connector のプロセッサーに接続されている支払いコンポーネントを管理します。
Payment Connector のプロセッサーは、対応するメタデータを使用して Stripe で支払いインテントを作成し、Webhook イベントを Commercetools の支払いトランザクションに変換します。
Payment Connector の設定から、Stripe Payment Element および Express Checkout Element のコンポーネントのデザインを変更できます。

Webhook

お客様のアカウントでイベントが発生すると、Stripe は Webhook を使用してご利用のアプリケーションに通知します。顧客の銀行が支払いを確定または拒否したとき、または支払いがキャンセルまたは返金されたときに、Webhook で支払いトランザクションを更新できます。

Stripe は以下の Webhook をサポートしています。

charge.succeeded: 支払いがキャプチャーされていない場合に Commercetools の支払いを新しく作成します。支払いが行われると、“Authorization:Success” のトランザクションを支払いに追加します。
payment_intent.succeeded: このイベントは、次の 2 つの方法によって処理されます。
- 自動キャプチャー: paymentIntent.capture_method が automatic の場合に Commercetools の支払いを新しく作成し、「Charge:Success」のトランザクションを支払いに追加します。
- 手動キャプチャー: paymentIntent.capture_method が manual の場合に「Charge:Success」のトランザクションを Commercetools の支払いに追加します。
charge.refunded: charge.captured が true の場合に「Refund:Success」のトランザクションを Commercetools の支払いに追加します。
payment_intent.canceled: 「CancelAuthorization:Success」のトランザクションを Commercetools の支払いに追加します。
payment_intent.payment_failed: プロセッサーログ内のコネクターアプリに情報を記録します。
payment_intent.requires_action: プロセッサーログ内のコネクターアプリに情報を記録します。