拡張機能を Stripe Apps に移行する

拡張機能は、Stripe Connect 上で構築されていたレガシーのシステムです。これらの拡張機能は、OAuth や API リクエストを介して、Stripe データを分析ダッシュボードやデータウェアハウスなどの他のビジネスツールに取り込みます。

2022 年現在、Stripe アプリは拡張機能に代わり Stripe を他のツールに導入するための推奨方法となっています。

新しい拡張機能を作成できなくなりました。レガシーの拡張機能に関する記載は、Stripe パートナーディレクトリからすべて削除されています。レガシーの拡張機能を使用している場合は、今すぐ Stripe アプリに移行して、Stripe App Marketplace で検索できるようにしてください。

移行する理由

Stripe アプリは、レガシーの拡張機能のアップグレード版にあたります。アプリに移行することで、以下のメリットがあります。

• Stripe ダッシュボードと Stripe App Marketplace で広範囲に表示することによる見つけやすさの向上
• アプリでアクセスできるデータと API を設定 (およびユーザーが把握) できるようにする、より細かい権限
• 埋め込みの UI コンポーネントを使用した、Stripe ダッシュボードでのインタラクティブな機能 (ユーザーは Stripe のサイト内でアプリを直接操作できます)
• 移行を選択した場合、拡張機能の既存ユーザーの操作が中断されることはありません

移行しない場合のプロセス

レガシーの拡張機能を Stripe アプリに移行しないことを選択した場合でも、現時点で拡張機能はこれまで通り機能し続けます。レガシーの拡張機能は正式に非推奨となったため、継続的なサポートは保証されず、追加される新機能を使用することもできません。

また、新しいユーザーはパートナーディレクトリでレガシーの拡張機能を見つけることができません。

レガシーの拡張機能は、できるだけ早く Stripe アプリに移行することをお勧めします。

Stripe Apps と拡張機能の比較

アプリでは、拡張機能のすべての機能に加えて、2 つの重要な機能を実行できます。

1. Stripe ダッシュボードの埋め込み UI コンポーネントを活用したインタラクティブ機能 。

2. アプリでアクセス可能なデータをユーザーが把握できるようにするための詳細な権限。

この他の違いとして、ユーザーはアプリをパートナーディレクトリーではなく Stripe App Marketplace から見つけることができます。

拡張機能のユーザーへの影響

レガシーの拡張機能を所有するアカウントに Stripe アプリをアップロードして公開すると、拡張機能のユーザーが Stripe アプリに切り替えるための移行プロセスが有効になります。移行プロセスによって、拡張機能の既存ユーザーが中断に直面することはありません。

拡張機能を Stripe アプリに移行すると、既存のユーザーの拡張機能の設定ページにバッジが表示され、アプリの権限を再度認証するように求められます。ユーザーは、移行したアプリを使用するために権限の承認を行う必要があります。ユーザーの Stripe アカウントの管理者は、以下のプロセスに従うことになります。

ユーザーにシームレスな移行プロセスを提供するため、既存のアカウントにアプリをアップロードして拡張機能をアプリに移行するようにしてください。

既存のユーザーに移行を求めたくない場合は、別の Stripe アカウントで Stripe アプリをアップロードして公開するようにします。既存の拡張機能と、関連のない Stripe アプリを同一の Stripe アカウントで両方設定することはできません。

Stripe Apps に移行する

拡張機能を Stripe Apps に移行するには、次の手順に従います。

拡張プログラムを Stripe アプリに移行する

はじめに

• Stripe アプリを開発する際は、別個または新規の Stripe アカウントでアプリをテストし、アップロードすることをお勧めします。アプリ ID はグローバルに一意であるため、テストアカウントのアプリには別の ID を使用する必要があります ("id": "com.example.myapp" や "id": "com.example.myapp.test" など)。
• セキュリティをさらに強化するには、バックエンドのテスト用インスタンスを別に作成します。Stripe アプリをテストする際、本番環境の拡張機能が利用しているバックエンドのコードの変更は避けてください。
• Stripe アプリをテストした後、拡張機能を所有している Stripe アカウントにアプリを (アプリ ID を指定して) アップロードし、アプリを公開します。

アプリに権限を追加する

権限を追加をアプリマニフェストに追加しました。

適切な権限を特定するための情報が必要な場合は、アプリをアップロードした後で、アプリの詳細ページの権限移行ツールを使用し、不足している推奨権限を表示できます。このツールは、アカウントに対する最近のリクエストを確認し、アプリに必要な権限を分析します。

移行ツールを見つけるには、ダッシュボードの[アプリの詳細]ページでアプリに移動します。このツールは、以下で強調表示されている複数の場所に存在します。

未公開アプリの吹き出しとボタン

アプリの公開時にオーバーフローメニューオプションにプッシュ

警告

ユーザーが Stripe アプリの新しい権限を承認すると、以前に拡張機能に付与されていた無制限の読み取り/書き込み権限がすべて上書きされます。移行時に既存のユーザーが権限関連の中断に直面することを防ぐために、ユーザーを移行する前に、アプリマニフェストに必要な権限を含めるようにしてください。