# Stripe App Marketplace にアプリを公開する方法 Stripe App Marketplace にアプリを承認してもらう方法を学びましょう。 アプリを作成し、公開可能にしたい場合は、このガイドを使用してください。アプリが自分の *チームメンバー* (A team member is a user with controlled access to some features of your Stripe account, like an administrator, developer, or support specialist) のみに利用可能である必要がある場合は、代わりに [アプリをアップロードしてインストールする](https://docs.stripe.com/stripe-apps/upload-install-app.md) 方法を学んでください。このガイドでは、[Stripe App Marketplace](https://marketplace.stripe.com) への公開方法と、アプリが Stripe のアプリ基準を満たしていることを確認するためのアプリレビューのプロセスを完了する方法について説明します。アプリを少数のアカウントにのみインストールする場合は、[外部テスト](https://docs.stripe.com/stripe-apps/test-app.md) を参照してください。 ## 要件と制限 - アカウントを [有効化](https://docs.stripe.com/get-started/account/activate.md) する必要があります。 - 公開できるアプリはアカウント当たり 1 つのみです。 - Stripe は英語のリストのみをサポートできます。 - Stripe App Marketplace からアプリを削除する必要がある場合は、Stripe に連絡してください。 - お客様の事業目的は、Stripe の [禁止/制限付き業種](https://stripe.com/legal/restricted-businesses) リストに含まれてはいけません。 ## アプリを公開するための手順 1. [アプリのマニフェストを更新する](https://docs.stripe.com/stripe-apps/publish-app.md#update-your-manifest) 1. [アプリを準備する](https://docs.stripe.com/stripe-apps/publish-app.md#prepare-your-app) 1. [リスティングを書く](https://docs.stripe.com/stripe-apps/publish-app.md#write-your-listing) 1. [アプリを審査に提出する](https://docs.stripe.com/stripe-apps/publish-app.md#submit-app-for-review)(その後、4 営業日待ちます) 1. [アプリを公開](https://docs.stripe.com/stripe-apps/publish-app.md#app-review-decision-and-publication) 公開する前に、リストの変更をリクエストするメールを送信する場合があります。アプリやリストに変更を加えた場合は、再提出して再度レビューに合格する必要があります。 ## アプリのマニフェストを更新する ### 配布タイプを設定する ```bash stripe apps set distribution public ``` これによりマニフェストが更新されます: ```json { "id": "com.example.app", "version": "1.2.3", "name": "Example Tool", "icon": "./example_icon_32.png", "distribution_type": "public" } ``` ### 必要な権限を追加します 次の方法で権限を追加してください: ```bash stripe apps grant permission "PERMISSION_NAME" "EXPLANATION" ``` ### アプリのバージョンを選択する ダッシュボードの [アプリページ](https://dashboard.stripe.com/apps) でアプリのバージョンを選択してください。 ### Stripe ダッシュボード UI のために ui_extension のみを含めてください - アプリに Stripe App ドロワーまたは設定ページ UI (ケイパビリティタイプ =`ui_extension`) が必要な場合は、UI 画面を実装し、アプリのマニフェストに適切な `ui_extension` ビューを追加します。Stripe App [UI コンポーネント](https://docs.stripe.com/stripe-apps/components.md)を参照してください。 - アプリがデータ連携のみを行う場合 (ケイパビリティタイプ = `data_integration`) で、UI を必要としない場合は、アプリ ドロワーコンテンツを含めないでください。代わりに、`stripe-app.json` ファイルで `ui_extension` ビューを空のままにします。 ```bash "ui_extension": [] ``` アプリマニフェストのすべてのフィールド、型、説明について詳しくは、[App manifest reference](https://docs.stripe.com/stripe-apps/reference/app-manifest.md) をご覧ください。 ### アプリマニフェストの作成時によくある間違い 1. アプリのマニフェストフィールド `allowed_redirect_uris` に localhost またはダミーの URL を含めることはできません。これらの入力はセキュリティ上の大きなリスクとなり、不正なリダイレクトを有効にする可能性があります。テスト用に localhost またはダミーの URL を追加した場合は、アプリをアップロードする前に削除してください。 1. アプリ名は、アプリリストとアプリマニフェストファイルで同じである必要があります。 1. アプリマニフェストにアプリのロゴの画像パスを含めるようにしてください。マニフェストで指定したロゴは、アプリリストにアップロードするロゴと一致している必要があります。 1. `sandbox_install_compatible` の値を `true` に更新して、アプリを Stripe サンドボックスアカウントにインストールできるようにします。これは、Stripe サンドボックスアカウントを使用するアプリのサブスクリプション機能または決済に関連する機能をテストするのに役立ちます。 ### アプリをアップロードする ```bash stripe apps upload ``` **Stripe ダッシュボード**\>**開発者**\>**アプリ**セクションでアプリの詳細を表示します。 ## アプリを準備します 次に、他のアカウントのインストーラー用のインストールプロセスを作成します。 - アプリとそのユースケースの要件に基づいて、適切な [API 認証方法](https://docs.stripe.com/stripe-apps/api-authentication.md)を選択します。 - サードパーティのOAuthを使用している場合は、アプリが完全に検証され、提供するサードパーティプロバイダー (例:Google、Facebook、LinkedIn) によって承認されていることを確認してください。アプリが検証されていない場合、通常は「Google はこのアプリを検証していません」というメッセージが表示されます。これらのプロバイダーから必要以上の権限をリクエストしないでください。 - アプリにサブスクリプションプランの決済ボタンがある場合は、Stripe App からプラットフォームにユーザーをルーティングしてから、Stripe Checkout にアクセスしてください。 - 例: アプリの設定ページまたはアプリドロワーの UI にある「Upgrade to a paid subscription (有料サブスクリプションにアップグレード)」というボタン、または Link では、まず自社のウェブサイトにリンクします。ユーザーはここでコストとプランの詳細を確認してから、決済プロセスを開始できます。 - アプリに UI コンポーネントがある場合は、Stripe の [デザイン UI](https://docs.stripe.com/stripe-apps/design.md) を使用してください - [OAuth 2.0](https://docs.stripe.com/stripe-apps/api-authentication/oauth.md) を使用して Stripe で接続リクエストを認証する場合: - レビューのために OAuth アプリを送信する際は、[公開インストールリンク](https://docs.stripe.com/stripe-apps/api-authentication/oauth.md#publish-app)を使用してリダイレクトする必要があります。これは**設定**タブ (チャネルのインストールリンクではない) にあり、パスは **https://marketplace.stripe.com/oauth/v2/authorize?client\_id=$(clientId)&redirect\_uri=$(redirect\_uri)&state=$(state)** のようになります。Stripe は連結する Stripe Authentication メソッドを廃止したため、代わりにこの OAuth メソッドを使用してください。 - **外部テスト用 URL**: この URL は、ローカルのテストと実装のみを目的としています。公開されているアプリケーションでは有効ではありません。実装とテストが完了したら、公開インストール用 URL (以下に記載) に置き換える必要があります。 - **公開インストール URL**: アプリケーションの審査依頼を送信する際は、本番環境の公開インストール URL を使用する必要があります。アプリケーションが Stripe App Marketplace に公開されるまで、この URL に一般およびアプリ開発者がアクセスすることはできませんが、Stripe App レビューチームはこの URL にアクセスして、レビューのためにアプリをインストールできます。 ## リストを作成してください アプリの種類は、アプリリストの表示方法を決定します。アプリの主な 2 つのタイプは、Stripe ダッシュボードに UI があるものとないものです。 ### アプリの種類の例 Stripe ダッシュボードに UI を持つアプリの例は、[Mailchimp](https://marketplace.stripe.com/apps/mailchimp) です。Stripe ダッシュボードに UI がないアプリの例は [Hubspot](https://marketplace.stripe.com/apps/hubspot-data-sync) です。 ### 魅力的なリストを作成する方法 アプリリストの提出ページには、3つの主要なセクションがあります: - 最初のセクションでは、アプリの主な価値提案と、Stripe ユーザーに対して解決する主要な問題が明確に示されています。 - 第 2 および第 3 のセクションでは、アプリの主なユースケースについての詳細を提供し、アプリがそれぞれにどのように対処するかを説明します。 ### 必須フィールド | コンテンツ | 仕様 | ガイドライン | 例 | | ----------------- | ----------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- | | 氏名 | 最大 35 文字です。次の単語や名前を含めてはいけません:「Stripe」、「アプリ」、「無料」、または「有料」。 | マーケットプレイス全体およびアプリリストページで、アプリのロゴの横に表示されます。`stripe-app.json` にアップロードされた名前と同じである必要があります。「Stripe」、「app」、「RAK」、「Generator」、「API Key」、「Authenticator」、「free」、「paid」の語句は使用できません。 | EmailWorld | | アイコンロゴ | 画像は、300x300 ピクセル以上の高解像度の、アスペクト比 1:1 (正方形) の .PNG または JPG 形式で、10MB 未満にする必要があります。アプリマニフェストで使用されているのと同じロゴである必要があります。 | - アプリマーケットプレイス全体およびアプリリストページで、アプリ名の横に表示されます。 - アプリリストへのアプリのロゴ画像の追加は、アプリマニフェストファイル `stripe-app.json` にアップロードされたものと同じである必要があります。 - 他の会社またはブランドのロゴは、明示的な法務許可なく、またはそれらの会社がお客様のアプリを承認していることを示唆する方法で使用しないでください。 - ロゴの画像は、アスペクト比 1:1 の正方形である必要があります。 | | | 構築者 | 最大 80 文字です。 | アプリを構築し管理する個人または組織の名前。 | EmailWorld, Inc | | カテゴリー | アプリに最も当てはまるカテゴリーを選択します。 | 別のカテゴリーの方が適切である場合には、アプリのレビュー中に Stripe で調整し、お客様にお知らせします。 | - サポート - 営業 | | サブタイトル | 最大 80 文字です。 | マーケットプレイス全体およびアプリリストページで、アプリ名の横に表示されます。アプリの価値を要約した簡潔なフレーズです。キーワードの詰め込み、マーケティング専門用語、誇張を避けてください。 | Stripe ダッシュボードで顧客のサポート履歴を表示および編集します。 | | 概要 | 最大 1000 文字です。 | 会社の業務内容、商品の対象ユーザー、ユーザーにとっての価値を簡単に説明してください。理想的な説明は、主な製品または全体の会社を概説する 1〜2 文で、その後に Stripe アプリの簡単な説明が続きます。誇張、マーケティング専門用語、キーワードの詰め込み、または証明できない主張を避けてください(例:「世界最高のサポート製品」)。 | EmailWorld は、成長中の EC ビジネス向けのメール配信サービスです。EmailWorld アプリは、私たちの高度なメッセージング機能を Stripe に統合し、数回のクリックでオーディエンスにリーチできるようにします。 | | 連携対象 | 自動で入力されますが、こちらで変更できます。 | あなたのアプリのマニフェスト (設定ファイル) はこれを自動的に入力しますが、提供されている選択メニューを使用して編集できます。これにより、アプリが [Stripe ダッシュボードのどの部分](https://docs.stripe.com/stripe-apps/reference/viewports.md)と連携するかを、ユーザーに知らせることができます。 | - 決済 - 顧客 | | 主な特徴 | Stripe ダッシュボードのコンテキストで、アプリ固有のユースケースを強調する最大 3 つの主要機能を追加します。 | - 各機能では、アプリと Stripe の連携方法を説明し、機能を強化します。実際の顧客データが表示されない、価値に焦点を当てた明確なタイトルと高品質のスクリーンショットを使用します。 - 主要機能の最初のセクションでは、アプリの価値提案の概要と、Stripe ユーザーにとってアプリとビジネスが解決する最も重要な問題について説明します。2 番目と 3 番目のセクションでは、主要なアプリのユースケースと、アプリが各問題を解決する方法について詳しく説明します。 - 主要機能のタイトル、説明、およびイメージは一致させる必要があります。タイトルと説明のコンテンツは、アップロードされた主要機能のイメージと一致し、正確に表す必要があります。 - 画像が高品質 (最大 5 MB) で適切にトリミングされていることを確認し、会社全体を説明するものではないようにしてください。 | | | タイトル | 最大 80 文字です。 | 主要な機能のビジュアルと説明の横に表示されます。これは、アプリのユースケースを平易な言葉で要約した簡潔なフレーズです。 | Stripe の顧客に関するメールのインサイトを得る。 | | 説明 | 最大 300 文字です。 | 機能の仕組みと、その機能を使用する人にとってのメリットを説明します。制限事項がある場合は併せて記載してください。オプションで、簡単な会社説明を含めることもできます。 | Stripe の顧客に関連するメールのアクティビティ (開封やクリックなど) を表示します。これにより、タブを切り替えることなく、キャンペーンがどれだけ売上につながるかを評価できます。 | | 画像 | 高解像度で幅 1600 ピクセル以上 (高さ制限なし)、10MB 以下、PNG または JPG 形式。 | Stripe ダッシュボードのコンテキストでアプリを表示します。テスト中は、実際の顧客データを示すスクリーンショットやアプリのスクリーンショットを使用しないでください。 | | | 料金体系 | | アプリが無料か、または有料サブスクリプションを必要とするかを伝えます。料金体系は隠れた手数料なしで表示され、市場外の価格と一貫している必要があります。サービスを無料と広告し、ユーザーがアプリをインストールした後で支払いを求めないでください。 | - 無料 - 無料トライアルの利用が可能 - 有料のサブスクリプションが必要 | | 料金体系ページ | アプリが有料サブスクリプションを必要とする場合に必要です。 | 見込みユーザーに料金体系モデルを説明する、料金体系ページへのリンクを提供します。 | | | サポートチャネル | ユーザーが連絡できる 1-2 のチャネル。 | 応答時間の見積もりも提供してください。 | - `help@helptable.com` - `helptable.com/support` | | 所在 | | 貴社の本社の所在地を選択してください。 | アメリカ | | 対応している言語 | | 英語は事前に選択されており、必須です。Stripe は英語のみをサポートしています。追加の言語をサポートしたい場合は、Stripe に連絡してください。 | 英語 | | プライバシーポリシー | | プライバシーポリシーへのリンクを提供してください。これは、ユーザーがあなたの会社とアプリのプライバシーポリシーを読むことができるURLです。 | `emailworld.com/privacy-policy` | | 利用規約 | *オプション* | 利用規約へのリンクを提供してください。これは、ユーザーが会社とアプリの両方の利用規約を確認できる URL である必要があります。 | | | 会社のウェブサイト | *オプション* | 会社の Web サイトへのリンクを指定します。あなたのウェブサイトは、あなたのビジネスの目的とアイデンティティを明確に表現する必要があります。 | | | よくある質問ページ | *オプション* | アプリのよくある質問ページへのリンクを指定します。 | | | 技術ドキュメント | *オプション* | アプリの技術文書ページへのリンクを提供してください。文書は、Stripe アプリのインストールからその機能を最大限に活用する方法まで、すべてを説明する必要があります。 | | | 権限 | *自動入力* | アプリのマニフェストが自動的にこれを入力します。アプリが必要とする権限をユーザーに知らせます。 | | | 機能のハイライト | | アプリの主な機能の概要を 1 ～ 3 つ強調し、ユーザーがアプリの内容を簡単に理解できるようにします。機能のタイトルにシンプルな言葉で機能の価値を述べてください。例えば、「Stripe からチケットを解決する」。実際の顧客データを表示しない高品質のビジュアルを使用してください。 | | | テストのガイダンス | | 本番環境のすべての主要機能をカバーする必要があります。アカウント登録フローを含めることを忘れないでください。アプリのレビューを迅速化するために、より複雑なフローの画面録画を添付し、必要に応じてビデオ内にリンクを注釈してください。 | [例のテストシナリオ](https://docs.stripe.com/stripe-apps/publish-app.md#example-testing-scenario) | | テストアカウントのテスト用認証情報 | | Stripe がアプリをインストールして使用するために使用できる 1 つ以上のテスト認証情報を含めてください。アプリ内で役割ベースの最高アクセス権限を持つ認証情報を含めてください。たとえば、「admin」のようにします。アプリのレビューに指定するテスト用のリンクは、Connect ユーザー登録経由ではなく、アプリのインストール経由で Stripe に接続するようにしてください。アプリを Stripe に接続する方法に関する詳細な手順を提供してください。多要素認証を無効にするか、審査担当者が通過するための手順を提供してください。テストアカウントにアプリを使用するための特定のデータ (CSV ファイルなど) が必要な場合は、それをアカウントに含める必要があります。アプリが地域固有のものであるか、地理的な制限がある場合は、サポート対象の地域に関する詳細を提供し、最新バージョンのアプリがインストールされている Stripe アカウントの認証情報をテストしてください。Stripe は、審査プロセスに実際の (テスト用以外の) アカウントを使用することを _許可していません _。テスト用に特定のアクセス方法を提供する必要がある場合は、[Stripe Support](https://support.stripe.com/contact/login)にお問い合わせください。 | [例のテスト認証情報](https://docs.stripe.com/stripe-apps/publish-app.md#example-testing-credentials) | ### テスト用認証情報の例 | テスト用アカウント名 | ユーザー名 | パスワード | | --------------- | --------------------------- | ---------------- | | Google スプレッドシート | `teststripeapps@stripe.com` | `teststripeapps` | | Stripe | `teststripeapps@stripe.com` | `teststripeapps` | ### Stripe と Google Sheets のサンプルアプリのユーザーシナリオの例 | ユーザーシナリオ | ステップごとの手順 | | -------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | ユーザーとしてサインインする | 1. Stripe App Marketplace からアプリをインストールします。 1. アプリを開きます。 1. **サインイン** ボタンをクリックします。 1. Google のテスト用認証情報 (以下で提供) を入力します。 1. Google アカウントへのアクセス権をアプリに付与します。 1. アプリにサインインした状態で Stripe ダッシュボードに戻ります。手順を完了した後、ダッシュボード内のアプリで Google Sheets のサービスを使用できます。 | | Stripe から Google スプレッドシートにデータをエクスポートする | 1. ダッシュボードの決済ページまたは顧客ページに移動します。 1. ダッシュボードでアプリを開きます。 1. アプリドロワーで、データをエクスポートするボタンをクリックします。 1. フォルダーを選択します (オプション)。 1. データを保存します。データは現在、Google Drive アカウントの CSV として利用可能です。 | ## アプリを審査に送信する 提出品質要件については、[アプリレビュー要件](https://docs.stripe.com/stripe-apps/review-requirements.md) ページを参照してください。 参考までに、レビューで最も一般的に見られる問題は以下の通りです: - これがアプリの更新による再提出である場合、新しいユーザーが見る可能性のあるすべての内容をテストガイドラインがカバーしていることを確認してください。 - マニフェスト内の権限が十分な説明を持ち、*発行* 権限の詳細な正当化があることを確認してください。 - `stripe-app.json` の `allowed_redirect_uris` などのリンクが壊れていないか、localhostのURLでないことを確認してください。 - 画像の品質とブランディング法令遵守を確認してください。 - すべての認証フローを確認し、明確なインストール後の手順を提供してください: - テスト資格情報が正しいことを確認し、2FAを必要としないこと。 - アプリからハードコーディングされたAPIキーを削除してください。 - サンドボックスと本番環境の両方で、異なるユーザー役割で機能をテストします。 - OAuthアプリの場合:**設定** タブに公開リンクを提供し、**外部テスト** タブの認証リンクではないことを確認してください。 - UI のあるアプリの場合:主要な機能の画像が Stripe ダッシュボードのアプリインターフェースを表示していることを確認してください。 - Checkout を使用するアプリの場合:決済用リンクが最初にユーザーの外部決済ページを経由し、直接 Stripe Checkoutにアクセスしないことを確認してください。 リスティングフォームで **送信** をクリックした後、4 営業日以内に承認またはフィードバックのメールを受け取ります。 ## アプリ審査の決定と公開 アプリが拒否された場合、次回の提出で審査に合格するのに役立つ詳細なフィードバックが得られます。 承認メールを受け取ったら、Stripe ダッシュボードの [アプリ](https://dashboard.stripe.com/apps) ページに移動します。そこから、**レビューと公開** をクリックしてリストをプレビューできます。公開せずにさらに変更を加えたい場合は、**キャンセルして編集** をクリックして、アプリを変更し、再度レビューのために再提出してください。 アプリを Stripe App Marketplace に公開するには、**公開** をクリックします。アプリを公開することは、次のことを意味します: - あらゆるユーザーが、Stripe App Marketplace でアプリを見つけられるようになります。 - あらゆる Stripe アカウントのユーザーが、アプリをインストールして使用できるようになります。 - 公開から 24 時間後に [アプリのアナリティクス](https://docs.stripe.com/stripe-apps/analytics.md) を確認できます。 ## See also - [アプリ審査の質的要件](https://docs.stripe.com/stripe-apps/review-requirements.md)