コンテンツにスキップ
アカウントを作成
または
サインイン
Stripe ドキュメントのロゴ
/
AI に質問する
アカウントを作成
サインイン
始める
支払い
売上
プラットフォームおよびマーケットプレイス
資金管理
開発者向けリソース
概要
バージョン管理
変更ログ
API バージョンのアップグレード
SDK バージョンをアップグレードする
Essentials
SDK
API
テスト
Stripe CLI
サンプルプロジェクト
ツール
ワークベンチ
開発者ダッシュボード
Stripe Shell
Visual Studio Code をご利用の場合
機能
ワークフロー
イベントの送信先
Stripe 健全性アラートファイルのアップロード
AI ソリューション
エージェントツールキット
モデルコンテキストプロトコル
セキュリティとプライバシー
セキュリティ
Stripebot ウェブクローラー
プライバシー
Stripe を拡張する
Stripe Appsを構築する
Stripe アプリを使用する
    概要
    Stripeが構築したアプリケーション
    Adobe Commerce
    Cegid
    Commercetools
    Mirakl
      インストール
      設定
      販売者をオンボーディングする
      支払いと入金
      参照情報
    NetSuite
    Oracle Opera
    Oracle Simphony
    Oracle Xstore
    PrestaShop
    Salesforce
    SAP
    Shopware 6
    Stripe Tax for BigCommerce
    Stripe Tax for WooCommerce
    パートナーアプリ
    独自のアプリを構築する
パートナー
Partner Ecosystem
パートナー認定
ホーム開発者向けリソースUse apps from StripeMirakl

注

このページはまだ日本語ではご利用いただけません。より多くの言語で文書が閲覧できるように現在取り組んでいます。準備が整い次第、翻訳版を提供いたしますので、もう少しお待ちください。

Mirakl アプリの設定

統合変数を定義します。

Mirakl アプリをインストールする前に、このガイドに概説されている変数を含むファイルを準備してください。始めるには、サンプル設定ファイルをコピーし、.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_NAMEMirakl インスタンスのホスト名。例: https://mymarketplace.mirakl.net。
MIRAKL_API_KEYMirakl Operator のキー。API 設定で Mirakl Operator として生成できます。プラグインには固有の Operator を作成することをお勧めします。

ユーザ登録

アプリのユーザー登録設定を行います。

パラメータ説明
REDIRECT_ONBOARDING売り手が Stripe でのアカウント作成を完了すると、プラグインによってこの URL にリダイレクトされます。デフォルトは $MIRAKL_HOST_NAME/mmp/shop/account/shop です。
BASE_HOSTプラグインをホスティングするサーバーのドメイン。例:stripe-mirakl.example.com。
SCHEMEベースホストが使用するスキーム。デフォルトは https です。
STRIPE_SELLERS_WEBHOOK_SECRETYour Stripe webhook secret available in your Connect webhook settings when adding the endpoint. See Add a Stripe webhook endpoint for connected accounts for details.
MIRAKL_CUSTOM_FIELD_CODE追加する必要のあるカスタムフィールドのコード。以下をご確認ください。デフォルトは stripe-url です。

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

  1. Go to your webhook settings.

  2. 宛先を追加 ボタンをクリックして、 webhook エンドポイントを追加します。

  3. イベント元オプションから連結アカウントを選択し、利用可能なイベントのリストから account.updated を選択します。希望する Stripe API のバージョンを入力してください。続行をクリックします。

  4. 使用可能な送信先タイプのリストからWebhook エンドポイントを選択します。続行をクリックします。

  5. エンドポイント URL を<BASE_HOST>/api/public/webhook/sellers に設定し、必要に応じて残りのフィールドに入力します。

  6. 送信先を作成するをクリックします。

  7. その Webhook シークレットを STRIPE_SELLERS_WEBHOOK_SECRET 環境変数に使用します。

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

  1. Mirakl バックオフィスにオペレータとしてログインします。

  2. Settings > Advanced Parameters > Shops にアクセスします。

  3. Custom Fields に移動します。

  4. 以下の値を使用して新しいフィールドを作成します。

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

支払い

アプリの決済設定を行います。

パラメータ説明
PAYMENT_METADATA_COMMERCIAL_ORDER_IDMirakl の業務用注文 ID を伝えるために Charges で使用されるメタデータキー。デフォルトは mirakl_commercial_order_id。
ENABLE_PRODUCT_PAYMENT_SPLIT商品の注文に関する支払いの分割ワークフローを有効にします。デフォルトは false です。
NABLE_SERVICE_PAYMENT_SPLITサービスの注文に関する支払いの分割ワークフローを有効にします。デフォルトは false です。
ENABLE_PRODUCT_PAYMENT_REFUND商品の注文に関する決済返金ワークフローを有効にします。デフォルトは false です。
ENABLE_SERVICE_PAYMENT_REFUNDサービスの注文に関する支払いの返金ワークフローを有効にします。デフォルトは false です。
STRIPE_OPERATOR_WEBHOOK_SECRETYour Stripe webhook secret is available in your account event destination details page when adding the endpoint. See Add a Stripe webhook endpoint for your account for details.

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

  1. Go to your webhook settings.

  2. 宛先を追加 ボタンをクリックして、 webhook エンドポイントを追加します。

  3. イベント発生オプションからあなたのアカウントを選択し、利用可能なイベントのリストから charge.succeeded と charge.updated を選択します。希望する Stripe API のバージョンを入力してください。続行をクリックします。

  4. 使用可能な送信先タイプのリストからWebhook エンドポイントを選択します。続行をクリックします。

  5. エンドポイント URL を<BASE_HOST>/api/public/webhook/operator に設定し、必要に応じて残りのフィールドに入力します。

  6. 送信先を作成するをクリックします。

  7. その Webhook シークレットを STRIPE_OPERATOR_WEBHOOK_SECRET 環境変数に使用します。

通知と警告

アプリの通知とアラート設定を行います。

パラメータ説明
MAILER_DSNDSN のような 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_DOWNURL が OPERATOR_NOTIFICATION_URL で指定されていて、その URL が利用できない場合、または応答でエラーが発生する場合に、メールアラートを有効にします。デフォルトは true です。
MAIL_ON_NOTIFICATION_ENDPOINT_DOWN_COOLDOWNメールによる各アラート間の時間間隔。スロットリングを無効にするには、0 を使用します。最大値は通知ワーカーの最大寿命 (デフォルトは 3600) によって異なります。デフォルトは 10 です。
このページはお役に立ちましたか。
はいいいえ
  • お困りのことがございましたら 、サポートにお問い合わせください。
  • 早期アクセスプログラムにご参加ください。
  • 変更ログをご覧ください。
  • ご不明な点がございましたら、お問い合わせください。
  • LLM ですか?llms.txt を読んでください。
  • Powered by Markdoc