コンテンツにスキップ

バージョン管理

API バージョンのアップグレード

SDK バージョンをアップグレードする

開発者向けのツール

ワークベンチ

イベントの送信先

開発者ダッシュボード

エージェントツールキット

Building with LLMs Visual Studio Code をご利用の場合ファイルのアップロード

セキュリティ

セキュリティ

Stripe を拡張する

Stripe のコネクター

コネクターを実装する

インストール

売り手のユーザ登録

Stripe Tax for WooCommerce

Stripe Tax for BigCommerce

パートナーコネクター

独自のコネクターを構築する

パートナー

Partner Ecosystem パートナー認定

Mirakl Connector の設定

統合変数を定義します。

ページをコピー

コネクタをインストールする前に、下記の変数が含まれるファイルを作成してください。

Stripe のリポジトリには、設定ファイルのサンプルがあります。このファイルをコピーし、名前を .env に変更できます。

一般的な設定

パラメータ	説明
APP_SECRET	生成されます。一般に、セキュリティ関連の操作にエントロピーを追加するために使用されます。詳細は Symfony のドキュメントをご覧ください。
OPERATOR_PASSWORD	生成されます。コネクタによって公開される API へのリクエストを保護するために使用されます。API を呼び出すときに、`X-AUTH-TOKEN` ヘッダーをこの値に設定します。
DATABASE_URL	データベースへの接続 URL。詳細については、Doctrine のドキュメントをご覧ください。例: `pgsql://symfony:symfony@db:5432/symfony?charset=UTF-8`。
MESSENGER_TRANSPORT_DSN	キューイングシステムに使用されるトランスポート。サポート対象のトランスポートについては、Symfony Messenger のドキュメントをご覧ください。例: `amqp://guest:guest@localhost:5672/%2f/messages`。デフォルトは、`doctrine://default` です。
STRIPE_CLIENT_SECRET	お客様の Stripe API シークレットキーは APIキー設定にあります。コネクタに特定の API キーを作成することをお勧めします。制限付きキーはサポートされません。
MIRAKL_HOST_NAME	Mirakl インスタンスのホスト名。例: `https://mymarketplace.mirakl.net`。
MIRAKL_API_KEY	Mirakl オペレータのキー。API 設定で Mirakl オペレータとして生成できます。コネクタに固有のオペレータを作成することをお勧めします。

ユーザ登録

パラメータ	説明
REDIRECT_ONBOARDING	売り手が Stripe でのアカウント作成を完了すると、コネクタによってこの URL にリダイレクトされます。デフォルトは `$MIRAKL_HOST_NAME/mmp/shop/account/shop` です。
BASE_HOST	コネクターをホスティングするサーバーのドメイン。例:`stripe-mirakl.example.com`。
SCHEME	ベースホストが使用するスキーム。デフォルトは `https` です。
STRIPE_SELLERS_WEBHOOK_SECRET	エンドポイントを追加する際、Stripe Webhook シークレットは Connect の Webhook 設定から利用できます。下記をご確認ください。
MIRAKL_CUSTOM_FIELD_CODE	追加する必要のあるカスタムフィールドのコード。以下をご確認ください。デフォルトは `stripe-url` です。

連結アカウントの Stripe Webhook エンドポイントの追加

Webhook 設定に移動します。
Webhook エンドポイントを追加します。
URL を <BASE_HOST>/api/public/webhook/sellers に設定します。
連結アカウントでイベントをリッスンするを選択します。
送信イベントに account.updated を追加します。
エンドポイントを追加をクリックします。
その Webhook シークレットを STRIPE_SELLERS_WEBHOOK_SECRET 環境変数に使用します。

Mirakl ショップへのカスタムフィールドの追加

Mirakl バックオフィスにオペレータとしてログインします。
Settings > Advanced Parameters > Shops にアクセスします。
カスタムフィールドタブに移動します。
次の値を使用して、新しいフィールドを作成します。

パラメータ	説明
コード	環境ファイルで別のキーを選択しない限り、`stripe-url` を使用します。
タイプ	`Link`
店舗の権限	`Read only`
必須フィールド	`No`

支払い

パラメータ	説明
PAYMENT_METADATA_COMMERCIAL_ORDER_ID	Mirakl の業務用注文 ID を伝えるために Charges で使用されるメタデータキー。デフォルトは `mirakl_commercial_order_id`。
ENABLE_PRODUCT_PAYMENT_SPLIT	商品の注文に関する支払いの分割ワークフローを有効にします。デフォルトは `false` です。
ENABLE_SERVICE_PAYMENT_SPLIT	サービスの注文に関する支払いの分割ワークフローを有効にします。デフォルトは `false` です。
ENABLE_PRODUCT_PAYMENT_REFUND	商品の注文に関する支払いの返金ワークフローを有効にします。デフォルトは `false` です。
ENABLE_SERVICE_PAYMENT_REFUND	サービスの注文に関する支払いの返金ワークフローを有効にします。デフォルトは `false` です。
STRIPE_OPERATOR_WEBHOOK_SECRET	エンドポイントを追加する際、Stripe Webhook シークレットはアカウントの Webhook 設定から利用できます。下記をご確認ください。

アカウントの Stripe Webhook エンドポイントの追加

Webhook 設定に移動します。
アカウントの Webhook エンドポイントを追加します。
URL を <BASE_HOST>/api/public/webhook/operator に設定します。
送信イベントに以下を追加します: charge.succeeded、charge.updated。
エンドポイントを追加をクリックします。
その Webhook シークレットを STRIPE_OPERATOR_WEBHOOK_SECRET 環境変数に使用します。

通知と警告

パラメータ	説明
MAILER_DSN	DSN のような URL フォーマットを使用した Symfony Mailer 設定全体。詳細は Symfony のドキュメントをご覧ください。例: `smtp://user:pass@host:port`。デフォルトは `smtp://null` (メーラーは無効) です。
TECHNICAL_ALERT_EMAIL	すべての技術的なアラートの受信者。例: `myemail@example.com`。デフォルトは空ですが、`MAILER_DSN` ごとにメーラーが有効になっている場合は必須です。
TECHNICAL_ALERT_EMAIL_FROM	すべての技術的なメールの送信者。デフォルトは空ですが、メーラーが設定されている場合は必須です。例: `noreply@example.com`。
OPERATOR_NOTIFICATION_URL	コネクタからの通知を受信するように設定されているお客様のサーバ上のエンドポイント。デフォルトは空 (通知が無効) です。
MAIL_ON_NOTIFICATION_ENDPOINT_DOWN	URL が `OPERATOR_NOTIFICATION_URL` で指定されていて、その URL が利用できない場合、または応答でエラーが発生する場合に、メールアラートを有効にします。デフォルトは `true` です。
MAIL_ON_NOTIFICATION_ENDPOINT_DOWN_COOLDOWN	メールによる各アラート間の時間間隔。スロットリングを無効にするには、`0` を使用します。最大値は通知ワーカーの最大寿命 (デフォルトは `3600`) によって異なります。デフォルトは `10` です。

参照情報

導入手順。