ツールキットを使用してサブスクリプションを Stripe Billing に移行する
ツールキットを使用して既存のサブスクリプションを Stripe に移行する方法をご紹介します。
Billing 移行ツールキットを使用して、サードパーティーシステム、自社製システム、または既存の Stripe アカウントの既存の subscriptions を Stripe Billing に移行します。
はじめに![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
- 移行のステージを確認していない場合は、最初に確認します。
- 移行を開始する前に、Stripe Billing のシステムを設定します。これは 1 回限りの設定であり、今後の移行で繰り返す必要はありません。
- 現在の決済代行業者からのPAN データのインポートをリクエストする。このステップが必要になるのは、別の決済代行業者からStripeに移行する場合のみです。 StripeからStripeに移行している場合には、この前提条件をスキップできます。
- サードパーティーまたは自社内のシステムから移行する場合は、既存のサブスクリプションのキャンセルと Stripe での新しいサブスクリプションの作成を行うタイミングを注意して設定してください。請求期間が短くならないようにするため、まず Stripe で新しいサブスクリプションを作成してから、古いサブスクリプションをキャンセルします。二重請求を避けるため、サブスクリプションの支払いが行われる前に、以前のシステムでサブスクリプションをキャンセルします。次の請求日が移行に近いサブスクリプションは、サイクル後に開始するようにスケジュールを設定して、最後の請求が以前のシステムで行われるようにします。
Billing 移行ツールキットを開く![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
最初にテスト移行を実行する場合は、右上隅にあるテスト環境のトグルを選択します。
ダッシュボード > サブスクリプション > 移行に移動します。
または、+ サブスクリプションを作成の横にあるオーバーフローメニュー () をクリックし、サブスクリプションの移行を選択します。
移行を開始するには、始めるをクリックします。
CSV ファイルをダウンロードする![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
まず、エクスポートされたデータを、移行と互換性のある CSV ファイルと照合して、既存のサブスクリプションをエクスポートします。独自の CSV ファイルを作成するか、 Stripe が提供する以下の CSV テンプレートをダウンロードできます。
また、ツールキットの CSV リファレンスでは、一般的な移行ユースケースの CSV ファイルの例もご覧いただけます。
CSV テンプレートをダウンロードをクリックします。
請求のユースケースに基づいて CSV テンプレート (基本、複数価格アイテム、または単発の価格) を選択します。
基本の CSV
この例では、数量、税金、請求の起点、割引、トライアル、遡及適用などの一般的なサブスクリプションユースケースの移行を示します。
基本の CSV ファイルには次のフィールドを指定します。
複数価格アイテムの CSV
この例は、各サブスクリプションに複数の商品が含まれる移行を示しています。
複数価格アイテムの CSV ファイルに次のフィールドを指定します。
単発の価格の CSV
この例では、既存の商品に対する単発価格を使用したサブスクリプションの移行処理を表しています。
単発の価格の CSV ファイルには次のフィールドを指定します。
CSV ファイルで、エクスポートするサブスクリプションの詳細を指定します。
Stripe 内での移行の場合
Stripe アカウント内でサブスクリプションを移行する場合は、CSV ファイルを指定してアップロードする前に、CSV の例をご覧ください。
CSV ファイルをアップロードする![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
CSV をアップロードをクリックします。CSV ファイルサイズの上限は 120 MB です。
Stripe は、ファイルを検証して、アップロードされたサブスクリプションが必須の CSV 形式に従っていることを確認します。このプロセスは、ファイルのサイズに応じて数時間かかることがあります。ファイルが有効な場合は、移行の次のステップに進むことができます。
検証エラーを解決する![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
アップロードしたファイルにエラーがある場合、ツールキットに失敗のサマリーが表示されます。エラーを修正するには、次のようにします。
Download file to review errors (ファイルをダウンロードしてエラーを確認する) をクリックします。
processing_
列でエラーを確認します。error すべてのエラーを修正します。一般的なエラーは以下のとおりです。
エラー トラブルシューティング 無効な日付 日付のすべてが Epoch または Unix タイムスタンプの形式であることを確認してください。 start_
範囲の誤りdate 各サブスクリプションの start_
が 24 時間以上先の日付であることを確認してください。date データの未入力 すべてのレコードに必須フィールドが含まれていることを確認してください。 価格と税の不整合 指定税率の価格に同じ tax_
(内税か外税か) が設定されていることを確認してください。behavior 修正したファイルをアップロードをクリックして、修正後の CSV をアップロードし直します (CSV ファイルサイズの上限は 120 MB です)。
再検証が終わるまで待ってから、最新の検証ステータスを確認します。
アップロードしたサブスクリプションを確認する![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Stripe が CSV ファイルを検証した後、アップロードしたサブスクリプションのサマリーで不一致がないことを確認してください。
サマリーを照合確認して以下が正確であることを確かめます。
- アップロードの日付
- アップロードされたファイルの名前
- サブスクリプションの数
- 顧客の人数
- サブスクリプションの最初の本番環境移行日
すべて正しいことを確認したら、移行を開始するをクリックします。
エラーが表示された場合は、移行をキャンセルするをクリックし、CSV ファイルのダウンロードから移行を再開します。
移行の進捗を追跡する![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
アップロードしたサブスクリプションを確認したら、移行の進捗を追跡します。
移行の進行中![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
サブスクリプションは、指定された開始日にスケジュールが設定されます。このプロセスは、ファイルのサイズに応じて、数分から数時間かかります。たとえば、100,000 件のサブスクリプションの検証と移行は完了までに約 30 分かかります。
Billing 移行ツールキットは、サブスクリプションスケジュールを使用してサブスクリプションを移行します。これにより、サブスクリプションを本番環境に移行する前に 24 時間、スケジュールが設定された状態に保持することができます。テスト環境では、評価とテストを速やかに行えるよう猶予期間が 1 時間まで短縮されます。
予定が設定されたサブスクリプション![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
移行後、サブスクリプションは、本番環境に移行する前に 24 時間、予定が設定された状態に保持されます。10 時間の期間の間は、ツールキットを使用してスケジュールが設定されたサブスクリプションをキャンセルすることができます。
現在、ツールキットを使用して予定が設定されたサブスクリプションを更新することはできません。スケジュールが設定されたサブスクリプションを更新したい場合は、更新エンドポイントを呼び出すか、サブスクリプションダッシュボードで各サブスクリプションを (1 つずつ) 更新します。
顧客は、カスタマーポータルから予定が設定されたサブスクリプションをキャンセルできません。本番環境のサブスクリプションのみをキャンセルできます。
サブスクリプションを本番環境に移行する![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
24 時間後に、予定が設定されたサブスクリプションは本番環境に移行し、該当する開始日に顧客に請求します。本番環境のすべてのサブスクリプションは、サブスクリプションダッシュボードで確認できます。
移行が本番環境で開始されたら、最初の支払いからサブスクリプションを監視することをお勧めします。移行したサブスクリプションの支払い日と金額が、指定した start_date と一致していることを確認します。
顧客は、カスタマーポータルから本番環境のサブスクリプションをキャンセルできます。
すべての移行を表示![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
すべての移行を表示するには、以下のようにします。
移行で、確認する移行を選択します。
移行を開くには、ドロップダウンメニューで表示するをクリックします。
以下のフィールドを追跡できます。
- アップロード日
- ファイル名
- Stripe Billing 移行 ID
- サブスクリプションの数
- 移行ステータス
オプション移行をキャンセルする![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
予定が設定されたサブスクリプションに問題がある場合は、移行をロールバックして、予定が設定されたサブスクリプションを元に戻すことができます。ダッシュボードには、ツールキットを使用して移行をキャンセルできるかどうかを示すタイムスタンプが表示されます。サブスクリプションのスケジュールを設定してから 10 時間以内にキャンセルする必要があります。 10 時間後に、ツールキットのキャンセルオプションが無効になります。
- キャンセルする移行移行で探します。
- ドロップダウンメニューで、移行をキャンセルするをクリックします。
10 時間後にキャンセル![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
10 時間後に移行をキャンセルするには、キャンセルエンドポイントを呼び出すか、サブスクリプションダッシュボードで各サブスクリプションを (1 つずつ) キャンセルします。
オプション複数の移行を実行する![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
任意の数のサブスクリプションの移行を一度に実行できます。大規模な移行の場合は、サブスクリプションをバッチに分割して、小規模なバッチから開始します。これにより、検証の問題をすばやく特定し、検証にかかる時間を短縮できます。
新しい移行を開始するには、以下の手順を実行します。
新しい移行を開始するをクリックします。
CSV ファイルのダウンロードから移行プロセスを再開します。
また、ツールキットの CSV リファレンスでは、一般的な移行ユースケースの CSV ファイルの例もご覧いただけます。