--- title: "Stripe App Marketplace への公開 | Tajo" description: "Stripe App の準備、申請、公開までを順を追って解説するガイド" url: https://tajo.io/jp/docs/stripe-apps/publish-app/ markdown: https://tajo.io/jp/docs/stripe-apps/publish-app.md lang: ja-JP author: "Set Noa" author_url: https://tajo.io/jp/set-noa/ robots: noindex --- 先行利用を申し込む お名前と会社のメールアドレスを入力してください。Tajoへのアクセス申請を確認するためのリンクをメールでお送りします。 # Stripe App Marketplace への公開 [Set Noa](https://tajo.io/jp/set-noa/) Stripe App を Marketplace に公開すると、すべての Stripe ユーザーが利用できるようになります。このガイドでは、必要な条件、準備の手順、申請のプロセスを説明します。 Caution **ステータス: 予定、未構築です。** Tajo には Stripe App がないため、このセクションの内容は現時点で何もインストールできません。このページに登場するアプリ識別子、URL、認証情報はすべて説明用のプレースホルダーであり、実際に動作するエンドポイントではありません。 ## 事前準備 Stripe App Marketplace に App を公開するには、次の条件を満たす必要があります。 - **有効化された Stripe アカウント**: テストモードのみに制限されたアカウントは使えません - **1 アカウントにつき 1 App**: 各 Stripe アカウントが Marketplace に公開できる公開 App は 1 つだけです - **英語のみ**: App のコンテンツ、UI テキスト、リスティング情報はすべて英語で記述する必要があります - **完成した App**: App は完全に動作し、テストを終えている必要があります Caution 複数の App を公開したい場合は、App ごとに別々の Stripe アカウントを作成してください。 ## 公開の手順 ### ステップ 1: マニフェストを更新する `stripe-app.json` の `distribution_type` を `public` に設定します。 ```json { "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 が[審査要件](https://tajo.io/jp/docs/stripe-apps/review-requirements)をすべて満たしていることを確認します。 1. 本番モードとサンドボックスモードの両方で入念にテストします 2. すべての権限が必要なものであり、用途が説明されていることを確認します 3. エラー処理とローディング状態が実装されていることを確認します 4. UI テキストがすべて英語であることを確認します ### ステップ 3: App をアップロードする Stripe CLI を使って App をアップロードします。 ```bash # Upload your app to Stripe stripe apps upload # Verify the upload stripe apps versions list ``` ### ステップ 4: リスティングを作成する Stripe Dashboard に移動してリスティングを完成させます。Marketplace への申請には、リスティングのすべての項目が必要です。 ### ステップ 5: 審査に申請する リスティングを完成させたら、Stripe Dashboard から App の審査を申請します。Stripe のチームが[品質要件](https://tajo.io/jp/docs/stripe-apps/review-requirements)に照らして App を評価します。 ### ステップ 6: 公開する 承認されたら App を公開し、Marketplace で利用できる状態にします。 ## 公開配布向けのマニフェスト設定 マニフェストには `distribution_type: "public"` を含め、必要な権限をすべて宣言し、それぞれの用途をわかりやすく記述する必要があります。 ```json { "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": "Read Stripe events so a sync picks up changes" }, { "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 は次のコマンドでアップロードします。 ```bash stripe apps upload ``` ## リスティングの要件 App のリスティングには、次の項目をすべて含める必要があります。 | 項目 | 要件 | 詳細 | | --- | --- | --- | | **Name** | 最大 35 文字 | Marketplace に表示される名前 | | **Icon** | 300x300 ピクセル、PNG または SVG | 正方形のアイコン、角丸なし (Stripe が自動で付けます) | | **Built by** | 会社名または開発者名 | App 名の下に表示されます | | **Category** | Stripe のカテゴリーから選択 | App に最も合うカテゴリーを選びます | | **Subtitle** | 最大 80 文字 | 検索結果に表示される短いタグライン | | **About** | 最大 1,000 文字 | App の機能を説明する詳しい紹介文 | | **Key Features** | 最大 5 件、画像つき | スクリーンショットや図で主要機能を示します | | **Pricing** | 無料、有料、フリーミアム | 料金モデルと費用を明確に示します | | **Support** | 問い合わせ用の URL またはメールアドレス | ユーザーがサポートを受けられる窓口 | | **Privacy Policy** | プライバシーポリシーの URL | データの取り扱いに必要な法的文書 | ### 名前のガイドライン - Marketplace 内で一意である必要があります - App の目的がはっきり伝わる名前にします - ユーザーが混乱しかねない一般的な語は避けます - 例: “Tajo for Brevo” (15 文字) ### アイコンのガイドライン - サイズ: 正確に 300x300 ピクセル - 形式: PNG または SVG - 角丸は自分で付けないでください。Stripe が自動で適用します - はっきり見分けられるロゴやシンボルを使います - 小さいサイズでも判読できることを確認します ### About セクション 次の内容を盛り込んだ、説得力のある紹介文を書きます。 - App が解決する課題 - 主な連携機能 - App が想定する利用者 - 事前準備や必要条件 例: > Tajo for Brevo は、Stripe の決済データを Brevo のマーケティングオートメーションにつなぎます。顧客を自動で同期し、決済イベントを記録し、購買行動に基づいてパーソナライズしたメール、SMS、WhatsApp のキャンペーンを開始できます。データに基づくリテンションマーケティングで顧客生涯価値を高めたい EC 事業者向けです。 ### 主な機能 主な機能の各項目には、次の要素を含めます。 - **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 を入念にテストします。 ### サンドボックスモードでのテスト ```bash # 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: reviewer@test.tajo.io 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. 承認されると、更新はすべてのユーザーへ自動的に配信されます Tip 軽微なバグ修正や機能に影響しない変更は、審査が早く終わることがあります。大きな機能追加や権限の変更には、通常どおりの審査が必要です。