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

Connect 拡張機能を Stripe Apps に移行する理由と方法をご紹介します。

[Connect 拡張機能](https://docs.stripe.com/building-extensions.md)は、Stripe Connect 上に構築された旧式の連携機能です。OAuth と API リクエストを通じて、分析ダッシュボードやデータウェアハウスなどの他の事業ツールに Stripe のデータを取り込みます。

[Stripe Apps](https://stripe.com/apps) は、2022 年以降、Stripe を他のツールと連携するための推奨手段として Connect 拡張機能に取って代わりました。

新しい Connect 拡張機能は作成できなくなりました。旧 Connect 拡張機能に関する記載はすべて [Stripe Partner Directory](https://stripe.partners/) から削除されました。旧 Connect 拡張機能をお持ちの場合は、[Stripe App Marketplace](https://marketplace.stripe.com/) で見つけてもらえる状態を維持するため、今すぐ Stripe Apps に移行してください。

## 移行する理由

Stripe Apps は、旧 Connect 拡張機能からのアップグレードです。移行すると、次のメリットが得られます。

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

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

旧 Connect 拡張機能を *Stripe App* (An app that you can build on top of Stripe to customize the functionality of the Stripe Dashboard UI, leverage Stripe user data, store data on Stripe, and more) に移行しない場合でも、現時点では Connect 拡張機能は引き続き現在と同様に動作します。ただし、旧 Connect 拡張機能は正式に非推奨となっており、継続的なサポートは保証されず、旧 Connect 拡張機能では新機能を利用できません。

また、新規ユーザーは[パートナーディレクトリ](https://stripe.partners)で旧 Connect 拡張機能を見つけることができません。

旧 Connect 拡張機能を、できるだけ早く *Stripe App* (An app that you can build on top of Stripe to customize the functionality of the Stripe Dashboard UI, leverage Stripe user data, store data on Stripe, and more) に移行することをお勧めします。

## Stripe Apps と Connect 拡張機能の比較

アプリは Connect 拡張機能のすべての機能に加えて、2 つの重要な機能を備えています。

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

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

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

| Connect 拡張機能                                                                                                       | Stripe Apps                                                                                          |
| ------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------- |
| すべての Stripe ユーザーが Connect 拡張機能を利用できます。                                                                             | すべての Stripe ユーザーがアプリをインストールできます。                                                                     |
| [Stripe パートナーディレクトリ](https://stripe.partners)や [Stripe App Marketplace](https://marketplace.stripe.com) では検索できません。 | [Stripe App Marketplace](https://marketplace.stripe.com) と Stripe ダッシュボードで検索できます。                    |
| 既存の Connect 拡張機能は、ダッシュボードの**開発者** > **拡張機能**で確認できます。                                                               | アプリは、ダッシュボードの**開発者** > **[アプリ](https://dashboard.stripe.com/apps)\**で確認できます。                         |
| Connect 拡張機能の権限は、すべて読み取りまたはすべて書き込みのいずれかに限られます。きめ細かな権限には対応していません。                                                   | アプリインストールの過程で詳細な権限セットをユーザーにリクエストし、セキュリティとユーザーの信頼を高めます。                                               |
| 新しい Connect 拡張機能を作成することはできません。                                                                                     | 開発者が Stripe のアプリプラットフォーム上に構築できます。                                                                    |
| ユーザーが OAuth を使用して Stripe アカウントを Connect 拡張機能に関連付けると、そのユーザーに代わって API リクエストを実行できます。                                  | [認証タイプ](https://docs.stripe.com/stripe-apps/api-authentication.md)を選択して、ユーザー登録と API リクエストのフローに使用します。 |
| ユーザーは追加のツールをインストールし、Stripe から離れて旧 Connect 拡張機能を操作します。                                                              | Stripe ダッシュボードで直接アプリを操作できます。                                                                         |
| Stripe の UI を拡張することはできません。                                                                                         | Stripe ダッシュボードで直接構築できます。                                                                             |

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

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

Connect 拡張機能を Stripe アプリに移行すると、既存のユーザーには[拡張機能設定](https://dashboard.stripe.com/test/extensions)ページに、アプリの権限を再度認証するよう促すバッジが表示されます。移行したアプリの使用を開始するには、ユーザーが権限を承認する必要があります。ユーザーの Stripe アカウントの管理者には、次の内容が表示されます。
![アプリの権限の移行例](https://b.stripecdn.com/docs-statics-srv/assets/migrated-app-permissions-diagram.8ed2661a5c4c75477ccd9aa77f02cd13.png)

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

既存のユーザーに移行を促したくない場合は、別の Stripe アカウントで Stripe アプリをアップロードして公開する必要があります。同じ Stripe アカウントで、既存の Connect 拡張機能と無関係の Stripe アプリの両方を持つことはできません。

## Stripe Apps に移行する

以下の手順に従って、Connect 拡張機能を Stripe アプリに移行してください。
![Connect 拡張機能を Stripe アプリに移行する手順](https://b.stripecdn.com/docs-statics-srv/assets/migrate_to_stripe_app_diagram.a741f6bfbd91e5840e123d581733bca9.png)

Connect 拡張機能の Stripe アプリへの移行

## Before you begin

- Stripe アプリを開発する際は、別個または新規の Stripe アカウントでアプリを[テスト](https://docs.stripe.com/stripe-apps/test-app.md)し、アップロードすることをお勧めします。アプリ ID はグローバルに一意であるため、テストアカウントのアプリには別の ID を使用する必要があります (`"id": "com.example.myapp"` や `"id": "com.example.myapp.test"` など)。
- 安全性をさらに高めるために、バックエンドのテスト用インスタンスを別途作成してください。Stripe アプリのテスト中は、本番の Connect 拡張機能を動かしているバックエンドのコードを変更しないようにしてください。
- Stripe アプリのテスト完了後、最終的に使用するアプリ ID でアプリを Connect 拡張機能を所有する同じ Stripe アカウントにアップロードし、[アプリを公開](https://docs.stripe.com/stripe-apps/publish-app.md)してください。

## アプリマニフェストを作成する

[Stripe アプリを作成してアプリマニフェストを作成](https://docs.stripe.com/stripe-apps/create-app.md)します。

## Optional: インタラクティブな機能を追加する

オプションで、UI コンポーネントを使用して、Stripe ダッシュボードでインタラクティブな機能を追加できます。

1. [Stripe アプリで UI コンポーネントを構築](https://docs.stripe.com/stripe-apps/build-ui.md)します。
2. [セルフホストのバックエンドを構築して、バックエンドに対してユーザーを認証](https://docs.stripe.com/stripe-apps/build-backend.md)します。

## 認証タイプを選択する

アプリをインストールしたユーザーに代わってバックエンドから API コールを行うには、利用可能な [API 認証タイプ](https://docs.stripe.com/stripe-apps/api-authentication.md)から選択する必要があります。ほとんどの旧 Connect 拡張機能では、`platform` または `oauth` オプションを使用すると、最小限の変更で既存の Stripe 連携をそのまま置き換えることができます。

## アプリに権限を追加する

[権限を追加](https://docs.stripe.com/stripe-apps/reference/permissions.md)をアプリマニフェストに追加しました。

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

移行ツールを見つけるには、[ダッシュボード](https://dashboard.stripe.com/apps)の[アプリの詳細]ページでアプリに移動します。このツールは、以下で強調表示されている複数の場所に存在します。
![未公開アプリ向け権限移行ツールのエントリーポイント](https://b.stripecdn.com/docs-statics-srv/assets/permission_tool_entry_point_unpublished.400af30ac4fb84772931a492e8b7edbe.png)

未公開アプリの吹き出しとボタン
![公開アプリ向け権限移行ツールのエントリーポイント](https://b.stripecdn.com/docs-statics-srv/assets/permission_tool_entry_point_published.1c4da81be36b34728ab23812763573ab.png)

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

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

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

CLI を使用して、Stripe に[アプリをアップロード](https://docs.stripe.com/stripe-apps/upload-install-app.md)します。

## アプリを公開する

[審査のためにアプリを送信し、Stripe App Marketplace で公開します](https://docs.stripe.com/stripe-apps/publish-app.md)。

アプリの審査に合格する可能性を高めるには、以下の Stripe のドキュメントに従ってください。

- [アプリの審査要件](https://docs.stripe.com/stripe-apps/review-requirements.md)
- [アプリ公開ガイド](https://docs.stripe.com/stripe-apps/publish-app.md)

> テスト資格情報を指定する際、テストアカウントがアプリのインストールフローにアクセスできることを確認してください。

アプリを Stripe App Marketplace に公開するには、アプリ審査に**合格する必要があります**。

## ユーザーのアカウント登録

移行後に既存のユーザーが Stripe アプリを使用するには、ダッシュボードでアプリの権限を再認証する必要があります。

次の 2 つの方法で、「新しい」ユーザーを Stripe アプリにアカウント登録できます。

- 旧 Connect 拡張機能を移行し、App Review に合格すると、Stripe App Marketplace でアプリを公開できます。
- 新規ユーザーは引き続き、ウェブサイトから Connect OAuth を使用して旧 Connect 拡張機能にユーザー登録できます。

> 移行の完了後に OAuth 経由で新しいユーザーのアカウント登録が行われないようにするために、OAuth コールバックを削除し、ウェブサイトの **Connect with Stripe (Stripe と連結)**ボタンを変更して、新しいユーザーを Stripe App Marketplace のアプリリストにリダイレクトできます。

## See also

- [Stripe Apps](https://docs.stripe.com/stripe-apps.md)
- [サンプルアプリ](https://docs.stripe.com/stripe-apps/sample-apps.md)