配布タイプを設定する

stripe apps set distribution public

これによりマニフェストが更新されます:

{
  "id": "com.example.app",
  "version": "1.2.3",
  "name": "Example Tool",
  "icon": "./example_icon_32.png",
  "distribution_type": "public"
}

必要な権限を追加します

次の方法で権限を追加してください:

stripe apps grant permission "PERMISSION_NAME" "EXPLANATION"

アプリのバージョンを選択する

ダッシュボードの アプリページ でアプリのバージョンを選択してください。

Stripe ダッシュボード UI のために ui_extension のみを含めてください

• アプリに Stripe App ドロワーまたは設定ページ UI (ケイパビリティタイプ =ui_extension) が必要な場合は、UI 画面を実装し、アプリのマニフェストに適切な ui_extension ビューを追加します。Stripe App UI コンポーネントを参照してください。
• アプリがデータ連携のみを行う場合 (ケイパビリティタイプ = data_integration) で、UI を必要としない場合は、アプリ ドロワーコンテンツを含めないでください。代わりに、stripe-app.json ファイルで ui_extension ビューを空のままにします。

"ui_extension": []

アプリマニフェストのすべてのフィールド、型、説明について詳しくは、App manifest reference をご覧ください。

アプリマニフェストの作成時によくある間違い

1. アプリのマニフェストフィールド allowed_redirect_uris に localhost またはダミーの URL を含めることはできません。これらの入力はセキュリティ上の大きなリスクとなり、不正なリダイレクトを有効にする可能性があります。テスト用に localhost またはダミーの URL を追加した場合は、アプリをアップロードする前に削除してください。
2. アプリ名は、アプリリストとアプリマニフェストファイルで同じである必要があります。
3. アプリマニフェストにアプリのロゴの画像パスを含めるようにしてください。マニフェストで指定したロゴは、アプリリストにアップロードするロゴと一致している必要があります。
4. sandbox_install_compatible の値を true に更新して、アプリを Stripe サンドボックスアカウントにインストールできるようにします。これは、Stripe サンドボックスアカウントを使用するアプリのサブスクリプション機能または決済に関連する機能をテストするのに役立ちます。

アプリをアップロードする

stripe apps upload

Stripe ダッシュボード>開発者>アプリセクションでアプリの詳細を表示します。

次に、他のアカウントのインストーラー用のインストールプロセスを作成します。

• アプリとそのユースケースの要件に基づいて、適切な API 認証方法を選択します。
• サードパーティのOAuthを使用している場合は、アプリが完全に検証され、提供するサードパーティプロバイダー (例:Google、Facebook、LinkedIn) によって承認されていることを確認してください。アプリが検証されていない場合、通常は「Google はこのアプリを検証していません」というメッセージが表示されます。これらのプロバイダーから必要以上の権限をリクエストしないでください。
• アプリにサブスクリプションプランの決済ボタンがある場合は、Stripe App からプラットフォームにユーザーをルーティングしてから、Stripe Checkout にアクセスしてください。
  • 例: アプリの設定ページまたはアプリドロワーの UI にある「Upgrade to a paid subscription (有料サブスクリプションにアップグレード)」というボタン、または Link では、まず自社のウェブサイトにリンクします。ユーザーはここでコストとプランの詳細を確認してから、決済プロセスを開始できます。
• アプリに UI コンポーネントがある場合は、Stripe の デザイン UI を使用してください
• OAuth 2.0 を使用して Stripe で接続リクエストを認証する場合:
  • レビューのために OAuth アプリを送信する際は、公開インストールリンクを使用してリダイレクトする必要があります。これは設定タブ (チャネルのインストールリンクではない) にあり、パスは 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 です。Stripe ダッシュボードに UI がないアプリの例は Hubspot です。

魅力的なリストを作成する方法

アプリリストの提出ページには、3つの主要なセクションがあります:

• 最初のセクションでは、アプリの主な価値提案と、Stripe ユーザーに対して解決する主要な問題が明確に示されています。
• 第 2 および第 3 のセクションでは、アプリの主なユースケースについての詳細を提供し、アプリがそれぞれにどのように対処するかを説明します。

必須フィールド

テスト用認証情報の例

Stripe と Google Sheets のサンプルアプリのユーザーシナリオの例

提出品質要件については、アプリレビュー要件 ページを参照してください。

参考までに、レビューで最も一般的に見られる問題は以下の通りです:

• これがアプリの更新による再提出である場合、新しいユーザーが見る可能性のあるすべての内容をテストガイドラインがカバーしていることを確認してください。
• マニフェスト内の権限が十分な説明を持ち、発行 権限の詳細な正当化があることを確認してください。
• stripe-app.json の allowed_redirect_uris などのリンクが壊れていないか、localhostのURLでないことを確認してください。
• 画像の品質とブランディング法令遵守を確認してください。
• すべての認証フローを確認し、明確なインストール後の手順を提供してください:
• テスト資格情報が正しいことを確認し、2FAを必要としないこと。
• アプリからハードコーディングされたAPIキーを削除してください。
• サンドボックスと本番環境の両方で、異なるユーザー役割で機能をテストします。
• OAuthアプリの場合:設定 タブに公開リンクを提供し、外部テスト タブの認証リンクではないことを確認してください。
• UI のあるアプリの場合:主要な機能の画像が Stripe ダッシュボードのアプリインターフェースを表示していることを確認してください。
• Checkout を使用するアプリの場合:決済用リンクが最初にユーザーの外部決済ページを経由し、直接 Stripe Checkoutにアクセスしないことを確認してください。

リスティングフォームで 送信 をクリックした後、4 営業日以内に承認またはフィードバックのメールを受け取ります。

アプリが拒否された場合、次回の提出で審査に合格するのに役立つ詳細なフィードバックが得られます。

承認メールを受け取ったら、Stripe ダッシュボードの アプリ ページに移動します。そこから、レビューと公開 をクリックしてリストをプレビューできます。公開せずにさらに変更を加えたい場合は、キャンセルして編集 をクリックして、アプリを変更し、再度レビューのために再提出してください。

アプリを Stripe App Marketplace に公開するには、公開 をクリックします。アプリを公開することは、次のことを意味します:

• あらゆるユーザーが、Stripe App Marketplace でアプリを見つけられるようになります。
• あらゆる Stripe アカウントのユーザーが、アプリをインストールして使用できるようになります。
• 公開から 24 時間後に アプリのアナリティクス を確認できます。