ツールキットを使用してサブスクリプションを Stripe Billing に移行する

最初にテスト移行を実行する場合は、ダッシュボードでサンドボックスを作成します。

1. ダッシュボード > サブスクリプション > 移行に移動します。

   または、+ サブスクリプションを作成の横にあるオーバーフローメニュー () をクリックし、サブスクリプションの移行を選択します。

2. 移行を開始するには、始めるをクリックします。

まず、エクスポートされたデータを、移行と互換性のある CSV ファイルと照合して、既存のサブスクリプションをエクスポートします。独自の CSV ファイルを作成するか、 Stripe が提供する以下の CSV テンプレートをダウンロードできます。

• 基本
• 複数価格アイテム
• 単発価格

また、ツールキットの CSV リファレンスでは、一般的な移行ユースケースの CSV ファイルの例もご覧いただけます。

1. CSV テンプレートをダウンロードをクリックします。

2. 請求のユースケースに基づいて CSV テンプレート (基本、複数価格アイテム、または単発の価格) を選択します。

   基本の CSV

   この例では、数量、税金、請求の起点、割引、トライアル、遡及適用などの一般的なサブスクリプションユースケースの移行を示します。

   基本の CSV ファイルには次のフィールドを指定します。

   複数価格アイテムの CSV

   この例は、各サブスクリプションに複数の商品が含まれる移行を示しています。

   複数価格アイテムの CSV ファイルに次のフィールドを指定します。

   単発の価格の CSV

   この例では、既存の商品に対する単発価格を使用したサブスクリプションの移行処理を表しています。

   単発の価格の CSV ファイルには次のフィールドを指定します。

3. CSV ファイルで、エクスポートするサブスクリプションの詳細を指定します。

   Stripe 内での移行の場合

   Stripe アカウント内でサブスクリプションを移行する場合は、CSV ファイルを指定してアップロードする前に、CSV の例をご覧ください。

CSV をアップロードをクリックします。CSV ファイルサイズの上限は 120 MB です。

Stripe は、ファイルを検証して、アップロードされたサブスクリプションが必須の CSV 形式に従っていることを確認します。このプロセスは、ファイルのサイズに応じて数時間かかることがあります。ファイルが有効な場合は、移行の次のステップに進むことができます。

検証エラーを解決する

アップロードしたファイルにエラーがある場合、ツールキットに失敗のサマリーが表示されます。エラーを修正するには、次のようにします。

1. Download file to review errors (ファイルをダウンロードしてエラーを確認する) をクリックします。

2. processing_error 列でエラーを確認します。

3. すべてのエラーを修正します。一般的なエラーは以下のとおりです。

   エラー	トラブルシューティング
   無効な日付	日付のすべてが Epoch または Unix タイムスタンプの形式であることを確認してください。
   start_date 範囲の誤り	各サブスクリプションの start_date が 24 時間以上先の日付であることを確認してください。
   データの未入力	すべてのレコードに必須フィールドが含まれていることを確認してください。
   価格と税の不整合	指定税率の価格に同じ tax_behavior (内税か外税か) が設定されていることを確認してください。

4. 修正したファイルをアップロードをクリックして、修正後の CSV をアップロードし直します (CSV ファイルサイズの上限は 120 MB です)。

5. 再検証が終わるまで待ってから、最新の検証ステータスを確認します。

Stripe が CSV ファイルを検証した後、アップロードしたサブスクリプションのサマリーで不一致がないことを確認してください。

1. サマリーを照合確認して以下が正確であることを確かめます。

   • アップロードの日付
   • アップロードされたファイルの名前
   • サブスクリプションの数
   • 顧客の人数
   • サブスクリプションの最初の本番環境移行日

2. すべて正しいことを確認したら、移行を開始するをクリックします。

   エラーが表示された場合は、移行をキャンセルするをクリックし、CSV ファイルのダウンロードから移行を再開します。

アップロードしたサブスクリプションを確認したら、移行の進捗を追跡します。

移行の進行中

サブスクリプションは、指定された開始日にスケジュールが設定されます。このプロセスは、ファイルのサイズに応じて、数分から数時間かかります。たとえば、100,000 件のサブスクリプションの検証と移行は完了までに約 30 分かかります。

Billing 移行ツールキットでサブスクリプションのスケジュールを使用して、サブスクリプションを移行することもできます。サブスクリプションを 24 時間スケジュールされた状態のままにして、そのまま本番環境に移行させることが可能です。サンドボックスではバッファ時間が 1 時間に短縮されるため、評価とテストをすばやく完了できます。

予定が設定されたサブスクリプション

移行後、サブスクリプションは、本番環境に移行する前に 24 時間、予定が設定された状態に保持されます。10 時間の期間の間は、ツールキットを使用してスケジュールが設定されたサブスクリプションをキャンセルすることができます。

現在、ツールキットを使用して予定が設定されたサブスクリプションを更新することはできません。スケジュールが設定されたサブスクリプションを更新したい場合は、更新エンドポイントを呼び出すか、サブスクリプションダッシュボードで各サブスクリプションを (1 つずつ) 更新します。

顧客は、カスタマーポータルから予定が設定されたサブスクリプションをキャンセルできません。本番環境のサブスクリプションのみをキャンセルできます。

サブスクリプションを本番環境に移行する

24 時間後に、予定が設定されたサブスクリプションは本番環境に移行し、該当する開始日に顧客に請求します。本番環境のすべてのサブスクリプションは、サブスクリプションダッシュボードで確認できます。

移行が本番環境で開始されたら、最初の支払いからサブスクリプションを監視することをお勧めします。移行したサブスクリプションの支払い日と金額が、指定した start_date と一致していることを確認します。

顧客は、カスタマーポータルから本番環境のサブスクリプションをキャンセルできます。

サブスクリプションを監視する

本番環境への移行が開始された後にサブスクリプションを監視する場合は、支払い方法に関する問題に注意してください。

たとえば、incorrect_number のような回復不可能なカード発行会社の拒否コードが指定されている取引を確認し、必要なアクションを実行して請求書が支払われるようにします。無効な支払い方法を持つ顧客には、テキストメッセージやアプリ内通知など、メール以外の方法で通知することを検討してください。

自動回収を適用する場合、未払いまたは期日超過の請求書がないかを確認し、顧客がデフォルトの支払い方法を設定し忘れていないか確認します。これを怠った場合、請求を回収できない可能性があります。

すべての移行を表示するには、以下のようにします。

1. 移行で、確認する移行を選択します。

2. 移行を開くには、ドロップダウンメニューで表示するをクリックします。

   以下のフィールドを追跡できます。

   • アップロード日
   • ファイル名
   • Stripe Billing 移行 ID
   • サブスクリプションの数
   • 移行ステータス