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

Commercetools Merchant Center を設定して Checkout Connector をインストールする方法をご紹介します。

Integrate Stripe payments with the Commercetools Checkout, which provides a pre-built checkout UI for secure payments.

Commercetools Merchant Center に掲載されている Checkout Connector

はじめに

Before you install the app:

Stripe アカウントの詳細を入力して、接続を確立します。
Identify the organization and project in your Commercetools instance where you want to install the app.
コンポーザブルコマースプロジェクトで Commercetools Checkout を有効にします。
Prepare to install and configure the app directly from your Commercetools instance.

Install the app

Commercetools インスタンスの Connect Marketplace から、Stripe Payment for Checkout を選択します。
On the Commercetools configuration page, select the region, organization, and projects in which to install the app.
次に、環境変数と設定の詳細を指定します。
Commercetools Checkout の設定ページで Add payments (支払いを追加) をクリックして、決済手段を有効にします。
Add payments (決済を追加) ページで、次の操作を行います。
- For Payment app, select Stripe Payment for Checkout.
- Drop-in payment integration name (ドロップイン決済連携名) には、表示する連携名を入力します。
- Payment integration key (決済連携キー) には、2 文字から 256 文字の英数字、アンダースコア、ハイフンで構成されたキーを入力します。
- ステータスを切り替えて有効にします。

Configure the Stripe Payment app

Use the following installation variables to configure the app.

変数	説明
`CTP_API_URL`	Commercetools コンポーザブルコマース API の URL。デフォルト値は `https://api.europe-west1.gcp.commercetools.com` です。
`CTP_AUTH_URL`	OAuth 2.0 トークンの生成に使用される Commercetools プラットフォームでの認証用の URL。Commercetools コンポーザブルコマースへのすべての API コールには、OAuth 2.0 トークンが必要です。デフォルト値は `https://auth.europewest1.gcp.commercetools.com` です。
`CTP_CLIENT_ID`	Commercetools コンポーザブルコマースユーザーアカウントのクライアント ID。Commercetools クライアントはクライアント ID を使用して、SDK を介して Commercetools コンポーザブルコマースと通信します。
`CTP_CLIENT_SECRET`	Commercetools コンポーザブルコマースユーザーアカウントの Client Secret。Commercetools クライアントは Client Secret を使用して、SDK を介して Commercetools コンポーザブルコマースと通信します。
`CTP_JWKS_URL`	JSON Web キーセットを提供する URL。
`CTP_JWT_ISSUER`	JWT 検証プロセスに必要な JSON Web トークンの発行者。
`CTP_PROJECT_KEY`	Commercetools コンポーザブルコマースプロジェクトのキー。
`CTP_SCOPE`	スコープは、Commercetools クライアントがアクセスでき、読み取りと書き込みのアクセス権を持つエンドポイントを定義します。
`CTP_SESSION_URL`	Commercetools プラットフォームでのセッション作成用の URL。コネクターは、作成されたセッションを使用してイネーブラーとプロセッサーの間で情報を共有します。デフォルト値は `https://session.europewest1.gcp.commercetools.com` です。
`STRIPE_APPEARANCE_EXPRESS_CHECKOUT`	Stripe Elements はデザインのカスタマイズに対応しており、デザインオプションでサイトのデザインと親和性を持たせることができます。この値は、Express Checkout Element のデザインを定義します。
`STRIPE_APPEARANCE_PAYMENT_ELEMENT`	Stripe Elements はデザインのカスタマイズに対応しており、デザインオプションでサイトのデザインと親和性を持たせることができます。この値は、Payment Element のデザインを定義します。
`STRIPE_CAPTURE_METHOD`	Stripe のキャプチャー方法 (手動または自動)。デフォルト値は `automatic` です。
`STRIPE_SECRET_KEY`	Stripe はアカウントの API キーを使用して API リクエストを認証します。デフォルトのシークレット API キーを使用する代わりに、制限付きアクセスキーを作成することをお勧めします。
`STRIPE_WEBHOOK_ID`	Webhook エンドポイントに対する Stripe の一意の識別子。
`STRIPE_WEBHOOK_SIGNING_SECRET`	Webhook の署名を検証するために公式ライブラリで使用される Stripe シークレットキー。このキーは Stripe ダッシュボードで作成されます。

一般的な設定

コネクターの設定で、Payment Connector イネーブラーによって生成されたコンポーネントのキャプチャーモード (手動または自動) を変更できます。イネーブラーは、Payment Connector プロセッサーに接続されている支払いコンポーネントを管理します。プロセッサーは、Stripe でそれぞれのメタデータを設定した Payment Intent を作成し、Webhook イベントを Commercetools の支払い取引に変換します。

Stripe Payment Element と Express Checkout Element のデザインは、Stripe Payment Connector の設定から変更できます。

Webhook

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

Stripe は次の Webhook に対応しています。

イベントタイプ	説明
`charge.refunded`	`charge.captured` が true の場合、Commercetools で支払いに `Refund:Success` 取引を追加します。
`charge.succeeded`	支払いがキャプチャーされていない場合は、Commercetools で支払いを作成します。支払いが行われた場合は、Commercetools で支払いに `Authorization:Success` 取引を追加します。
`payment_intent.canceled`	Commercetools で支払いに `CancelAuthorization:Success` 取引を追加します。
`payment_intent.payment_failed`	コネクターアプリのプロセッサーログの情報を記録します。
`payment_intent.requires_action`	コネクターアプリのプロセッサーログの情報を記録します。
`payment_intent.succeeded`	このイベントは、次のいずれかのキャプチャー方法を使用して処理できます。自動: `paymentIntent.capture_method` が自動の場合は、Commercetools で支払いを作成して、それに `Charge:Success` 取引を追加します。手動: `paymentIntent.capture_method` が手動の場合は、Commercetools で支払いに `Charge:Success` 取引を追加します。

変更ログとコードへのアクセス

コネクターへの変更とアップグレードの最新状況は、Github リポジトリで確認できます。

注