Stripe App Marketplace への公開

Stripe App を Marketplace に公開すると、すべての Stripe ユーザーが利用できるようになります。このガイドでは、必要な条件、準備の手順、申請のプロセスを説明します。

事前準備

Stripe App Marketplace に App を公開するには、次の条件を満たす必要があります。

• 有効化された Stripe アカウント: テストモードのみに制限されたアカウントは使えません
• 1 アカウントにつき 1 App: 各 Stripe アカウントが Marketplace に公開できる公開 App は 1 つだけです
• 英語のみ: App のコンテンツ、UI テキスト、リスティング情報はすべて英語で記述する必要があります
• 完成した App: App は完全に動作し、テストを終えている必要があります

公開の手順

ステップ 1: マニフェストを更新する

stripe-app.json の distribution_type を public に設定します。

{
  "id": "com.tajo.brevo-integration",
  "version": "1.0.0",
  "name": "Tajo Brevo Integration",
  "icon": "./icon.png",
  "distribution_type": "public",
  "permissions": [
    {
      "permission": "customer_read",
      "purpose": "Sync customer data to Brevo contacts"
    },
    {
      "permission": "customer_write",
      "purpose": "Update customer metadata with Brevo sync status"
    },
    {
      "permission": "event_read",
      "purpose": "Track payment and subscription events for Brevo automation"
    }
  ]
}

ステップ 2: App を準備する

申請の前に、App が審査要件をすべて満たしていることを確認します。

1. 本番モードとサンドボックスモードの両方で入念にテストします
2. すべての権限が必要なものであり、用途が説明されていることを確認します
3. エラー処理とローディング状態が実装されていることを確認します
4. UI テキストがすべて英語であることを確認します

ステップ 3: App をアップロードする

Stripe CLI を使って App をアップロードします。

# Upload your app to Stripe
stripe apps upload

# Verify the upload
stripe apps versions list

ステップ 4: リスティングを作成する

Stripe Dashboard に移動してリスティングを完成させます。Marketplace への申請には、リスティングのすべての項目が必要です。

ステップ 5: 審査に申請する

リスティングを完成させたら、Stripe Dashboard から App の審査を申請します。Stripe のチームが品質要件に照らして App を評価します。

ステップ 6: 公開する

承認されたら App を公開し、Marketplace で利用できる状態にします。

公開配布向けのマニフェスト設定

マニフェストには distribution_type: "public" を含め、必要な権限をすべて宣言し、それぞれの用途をわかりやすく記述する必要があります。

{
  "id": "com.tajo.brevo-integration",
  "version": "1.2.0",
  "name": "Tajo for Brevo",
  "icon": "./assets/icon.png",
  "distribution_type": "public",
  "stripe_api_access_type": "oauth",
  "allowed_redirect_uris": [
    "https://tajo.io/stripe/callback"
  ],
  "permissions": [
    {
      "permission": "customer_read",
      "purpose": "Read customer profiles to sync with Brevo contacts"
    },
    {
      "permission": "customer_write",
      "purpose": "Write sync metadata to customer records"
    },
    {
      "permission": "charge_read",
      "purpose": "Access payment data for Brevo event tracking"
    },
    {
      "permission": "event_read",
      "purpose": "Subscribe to Stripe events for real-time Brevo sync"
    },
    {
      "permission": "product_read",
      "purpose": "Sync product catalog to Brevo for campaign personalization"
    },
    {
      "permission": "invoice_read",
      "purpose": "Track invoice events for Brevo transactional emails"
    }
  ],
  "ui_extension": {
    "views": [
      {
        "viewport": "stripe.dashboard.customer.detail",
        "component": "CustomerDetailView"
      },
      {
        "viewport": "stripe.dashboard.home.overview",
        "component": "OverviewView"
      }
    ]
  },
  "post_install_action": {
    "type": "onboarding"
  }
}

設定した App は次のコマンドでアップロードします。

stripe apps upload

リスティングの要件

App のリスティングには、次の項目をすべて含める必要があります。

名前のガイドライン

• Marketplace 内で一意である必要があります
• App の目的がはっきり伝わる名前にします
• ユーザーが混乱しかねない一般的な語は避けます
• 例: “Tajo for Brevo” (15 文字)

アイコンのガイドライン

• サイズ: 正確に 300x300 ピクセル
• 形式: PNG または SVG
• 角丸は自分で付けないでください。Stripe が自動で適用します
• はっきり見分けられるロゴやシンボルを使います
• 小さいサイズでも判読できることを確認します

About セクション

次の内容を盛り込んだ、説得力のある紹介文を書きます。

• App が解決する課題
• 主な連携機能
• App が想定する利用者
• 事前準備や必要条件

例:

Tajo for Brevo connects your Stripe payment data with Brevo’s marketing automation platform. Automatically sync customers, track payment events, and trigger personalized email, SMS, and WhatsApp campaigns based on real-time purchase behavior. Built for ecommerce businesses that want to maximize customer lifetime value through data-driven retention marketing.

主な機能

主な機能の各項目には、次の要素を含めます。

• Title: 機能の短い名前
• Description: 機能を説明する 1 文から 2 文
• Image: スクリーンショットまたは図 (推奨サイズは 1600x900 ピクセル)

Tajo Brevo 連携で推奨する機能は次のとおりです。

1. リアルタイム顧客同期、Stripe の顧客プロフィールを購入履歴ごと Brevo のコンタクトへ自動で同期します
2. イベント駆動の自動化、決済成功、サブスクリプションの変更、返金などの Stripe イベントから Brevo のワークフローを実行します
3. 商品カタログ同期、パーソナライズしたキャンペーン内容のために、Brevo の商品カタログを Stripe と同期した状態に保ちます
4. マルチチャネルキャンペーン、同期したデータを使って、ターゲットを絞ったメール・SMS・WhatsApp キャンペーンを実施します
5. ダッシュボードのインサイト、Stripe Dashboard の顧客画面で Brevo のエンゲージメント指標をそのまま確認できます

料金の情報

料金モデルをはっきり伝えます。

• 無料: インストールも利用も無料です
• 有料: 価格と課金の頻度を明記します
• フリーミアム: 無料で使える範囲と、支払いが必要な範囲を説明します
• 従量課金: 料金プランや単価の仕組みを説明します

App のテスト

申請の前に、App を入念にテストします。

サンドボックスモードでのテスト

# Start your app in test mode
stripe apps start --mode test

# Verify sandbox compatibility
stripe apps validate

テスト用認証情報のフォーマット

審査チームにテスト用の認証情報を渡すときは、次のフォーマットを使います。

Test Account Credentials
========================
Platform: Tajo
URL: https://app.tajo.io/test
Email: [email protected]
Password: [secure test password]

Brevo Test API Key: xkeysib-test-xxxxxxxxxxxx

Required Setup Steps:
1. Log in to the Tajo test account
2. Navigate to Settings > Integrations > Brevo
3. The Brevo API key is pre-configured
4. Install the Stripe App from the test link provided

Expected Behavior:
- Customer sync should begin within 60 seconds of installation
- Navigate to any Stripe customer to see Brevo contact data
- Create a test payment to verify event sync to Brevo

審査前のチェックリスト

申請する前に、次の点を確認します。

• App が本番モードとテストモードの両方で動作する
• すべての権限に用途の説明がある
• エラー状態が適切に処理されている
• 非同期処理でローディング状態が表示される
• 本番ビルドにテストデータがハードコードされていない
• プライバシーポリシーの URL にアクセスでき、内容が正しい
• サポートの連絡先が有効である
• リスティングの画像がすべてサイズ要件を満たしている
• App の説明が実際の機能と一致している

申請後の流れ

Stripe の審査チームからは通常 5 営業日から 10 営業日で回答があります。結果は次のいずれかです。

• 承認: App が公開できる状態になります
• 修正の依頼: 具体的なフィードバックが返されます
• 却下: 要件を満たしていない場合は却下されます

修正を求められた場合は、フィードバックにすべて対応してから再申請します。再申請のたびに、審査は最初からやり直しになります。

公開済み App の更新

すでに公開している App を更新するには、次の手順を実行します。

1. stripe-app.json のバージョンを上げます
2. 新しいバージョンをアップロードします: stripe apps upload
3. 更新分を審査に申請します
4. 承認されると、更新はすべてのユーザーへ自動的に配信されます