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

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

1. ダッシュボード> Subscriptions> 移行 に移動します。

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

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

まず、エクスポートされたデータを、移行と互換性のある CSV ファイルと照合して、既存のサブスクリプションをエクスポートします。独自の CSV ファイルを作成するか、Stripe が提供する以下の CSV テンプレート (基本、複数価格項目、単発価格) のいずれかをダウンロードすることができます。また、一般的な移行ユースケース用の CSV ファイルの例もご覧いただけます。

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

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

   基本の CSV

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

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

   属性	タイプ	例	説明
   customer (必須)	Stripe 顧客 ID	cus_xxx1	サブスクリプションを作成する顧客の ID。
   start_date (必須)	エポックの Unix 形式のタイムスタンプ	1658179441	サブスクリプションの作成日を指定します。このとき、24 時間 (またはそれ以上) 先の値を指定する必要があります。サンドボックスでは、1 時間後に設定することが可能です。
   price (必須)	Stripe 価格 ID	price_1LDGNmDK0D4Fox2RxIaXQkBp	継続価格を使用する必要があります。複数のアイテムを移行する場合は、代わりに items.x.{price, quantity} 形式を使用します。単発の価格も、adhoc_items.x.{amount, product, interval,currency} でサポートされています。
   quantity	番号	1	サブスクリプションの数量を決定します。デフォルトでは、各サブスクリプションは 1 つの商品に対するものですが、Stripe では 1 つのアイテムの複数の数量に対するサブスクリプションに顧客を登録できます。
   metadata.*	文字列	subscription_1	オブジェクトに関連付けることができる以下のキーと値のペアを関連付けます。これは、オブジェクトに関する追加情報を構造化された形式で格納するのに便利です。必要に応じて任意のメタデータフィールド (metadata_third_party_sub_id など) を追加できます。Stripe 内での移行の場合は、internal:Stripe と入力します。
   automatic_tax	ブール値	false	Stripe Tax による税金の自動計算設定を使用するには、true を指定します。
   billing_cycle_anchor	エポックの Unix 形式のタイムスタンプ	1658179441	顧客にサブスクリプションを請求する次回の日付を決定します。
   coupon	Stripe クーポン ID	50_off	このサブスクリプションに適用するクーポンの ID。
   trial_end	エポックの Unix 形式のタイムスタンプ	1658179441	フェーズを開始日から trial_end 日付までトライアルに設定します。サイクルの終了日より前の値を指定する必要があり、トライアルと組み合わせることはできません。
   proration_behavior	列挙値	create_prorations または none	移行後にサブスクリプションが比例配分を作成するかどうかを決定します。デフォルト値は create_prorations です。
   collection_method	列挙値	charge_automatically または send_invoice	自動的に請求する場合、Stripe は各請求期間の終了時に、顧客に関連付けられたデフォルトのソースを使用して、基になるサブスクリプションの決済を試みます。請求書を送信すると、Stripe は顧客に決済手順をメールで送信し、サブスクリプションを有効としてマークします。作成時のデフォルトは charge_automatically です。send_invoice の場合は、days_until_due を設定する必要があります。
   default_tax_rate	Stripe Tax の ID	txr_1LPcLzAWeZvbCyjpzDA4qs1l	サブスクリプションの default_tax_rates を設定します。これにより、このフェーズ中にサブスクリプションによって発行された請求書の default_tax_rates も決定されます。この値は、automatic_tax と互換性がありません。
   backstart_start_date	Timestamp	1658179441	作成されたサブスクリプションの start_date を決定します。これは過去の日付でなければなりません。設定されている場合、proration_behavior には none を指定する必要があります。これにより、backdate_start_date から実際の start_date までの比例配分を適用した請求書が作成されなくなります。詳細については、請求を行わずに遡及適用するをご覧ください。
   days_until_due	整数	30	請求書の作成日から期日までの日数。この値は必須であり、collection_method が send_invoice に設定された請求書にのみ有効です。
   cancel_at_period_end	ブール値	false	期間の終了時にサブスクリプションをキャンセルするには、true を指定します。

   複数価格アイテムの CSV

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

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

   属性	タイプ	例	説明
   customer (必須)	Stripe 顧客 ID	cus_xxx1	サブスクリプションを作成する顧客の ID。
   start_date (必須)	エポックの Unix 形式のタイムスタンプ	1658179441	サブスクリプションの作成日を指定します。このとき、24 時間 (またはそれ以上) 先の値を指定する必要があります。サンドボックスでは、1 時間後に設定することが可能です。
   items.0.price (必須)	Stripe 価格 ID	price_1LDGNmDK0D4Fox2RxIaXQkBp	Price オブジェクトの ID。継続価格にする必要があります。
   items.0.quantity	番号	1	サブスクリプションの数量を決定します。デフォルトでは、各サブスクリプションは 1 つの商品に対するものですが、Stripe では 1 つのアイテムの複数の数量に対するサブスクリプションに顧客を登録できます。
   items.1.price (必須)	Stripe 価格 ID	price_1LujbnDCA5oQnOCew7kwa4T5	Price オブジェクトの ID。継続価格にする必要があります。
   items.1.quantity	番号	1	サブスクリプションの数量を決定します。デフォルトでは、各サブスクリプションは 1 つの商品に対するものですが、Stripe では 1 つのアイテムの複数の数量に対するサブスクリプションに顧客を登録できます。
   metadata_third_party_sub_id	文字列	subscription_1	以下のキーと値のペアをオブジェクトに関連付けます。これは、オブジェクトに関する追加情報を構造化された形式で格納するのに便利です。
   automatic_tax	ブール値	false	Stripe Tax による税金の自動計算設定を使用するには、true を指定します。
   billing_cycle_anchor	エポックの Unix 形式のタイムスタンプ	1658179441	顧客にサブスクリプションを請求する次回の日付を決定します。
   coupon	Stripe クーポン ID	50_off	このサブスクリプションに適用するクーポンの ID。
   proration_behavior	列挙値	create_prorations	移行後にサブスクリプションが比例配分を作成するかどうかを決定します。デフォルト値は create_prorations です。
   collection_method	列挙値	charge_automatically または send_invoice	自動的に請求する場合、Stripe は各請求期間の終了時に、顧客に関連付けられたデフォルトのソースを使用して、基になるサブスクリプションの決済を試みます。デフォルト値は charge_automatically です。請求書を送信する場合、Stripe は顧客に決済手順を記載した請求書をメールで送信し、サブスクリプションを有効としてマークします。send_invoice を使用している場合は、days_until_due を設定する必要があります。
   default_tax_rate	Stripe Tax の ID	txr_1LPcLzAWeZvbCyjpzDA4qs1l	サブスクリプションの default_tax_rates を設定します。これにより、このフェーズ中にサブスクリプションによって発行された請求書の default_tax_rates も決定されます。この値は、automatic_tax と互換性がありません。
   backstart_start_date	Timestamp	1705753518	作成されたサブスクリプションの start_date を決定します。これは過去の日付でなければなりません。設定されている場合、proration_behavior には none を指定する必要があります。これにより、backdate_start_date から実際の start_date までの比例配分を適用した請求書が作成されなくなります。詳細については、請求を行わずに遡及適用するをご覧ください。
   days_until_due	整数	30	請求書の作成日から期日までの日数。これは必須であり、collection_method が send_invoice に設定された請求書にのみ有効です。
   cancel_at_period_end	ブール値	false	期間の終了時にサブスクリプションをキャンセルするには、true を指定します。
   add_invoice_items.0.amount	番号	19.99	正の数。小数を含む完全な単位を使用します (例:21.50)。
   add_invoice_items.0.product	Stripe 製品 ID	prod_PjfC3kWS58IoOX	請求書を追加する商品の ID。
   add_invoice_items.0.currency	文字列	usd	サポートされている通貨の小文字 3 文字の ISO 通貨コード。

   単発の価格の CSV

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

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

   属性	タイプ	例	説明
   customer (必須)	Stripe 顧客 ID	cus_xxx1	サブスクリプションを作成する顧客の ID。
   start_date (必須)	エポックの Unix 形式のタイムスタンプ	1710937191	サブスクリプションの作成日を指定します。このとき、24 時間 (またはそれ以上) 先の値を指定する必要があります。サンドボックスでは、1 時間後に設定することが可能です。
   adhoc_items.0.amount (必須)	番号	19.99	正の数。小数を含む完全な単位を使用します (例:21.50)。
   adhoc_items.0.product (必須)	Stripe 製品 ID	prod_NwSGSFZb7ENuTW	単発の価格に属する商品の ID。
   adhoc_items.0.interval (必須)	日、週、月、または年	month	請求の頻度。
   adhoc_items.0.currency (必須)	文字列	usd	サポートされている通貨の小文字 3 文字の ISO 通貨コード。
   adhoc_items.0.quantity	番号	1	サブスクリプションの数量を決定します。デフォルトでは、各サブスクリプションは 1 つの商品に対するものですが、Stripe では 1 つのアイテムの複数の数量に対するサブスクリプションに顧客を登録できます。
   adhoc_items.1.amount	番号	19.99	正の数。小数を含む完全な単位を使用します (例:21.50)。
   adhoc_items.1.interval	日、週、月、または年	month	請求の頻度。
   adhoc_items.1.currency	文字列	usd	サポートされている通貨の小文字 3 文字の ISO 通貨コード。
   adhoc_items.1.quantity	番号	1	サブスクリプションの数量を決定します。デフォルトでは、各サブスクリプションは 1 つの商品に対するものですが、Stripe では 1 つのアイテムの複数の数量に対するサブスクリプションに顧客を登録できます。
   metadata.source	番号	external:zuora	以下のキーと値のペアをオブジェクトに関連付けます。これは、オブジェクトに関する追加情報を構造化された形式で格納するのに便利です。metadata_third_party_sub_id など、必要に応じて任意のメタデータフィールドを追加できます。Stripe 内での移行の場合は、internal:Stripe と入力します。
   metadata_third_party_sub_id	文字列	subscription_1	以下のキーと値のペアをオブジェクトに関連付けます。これは、オブジェクトに関する追加情報を構造化された形式で格納するのに便利です。
   automatic_tax	ブール値	false	Stripe Tax による税金の自動計算設定を使用するには、true を指定します。
   billing_cycle_anchor	エポックの Unix 形式のタイムスタンプ	1713615591	顧客にサブスクリプションを請求する次回の日付を決定します。
   coupon	Stripe クーポン ID	black_friday	このサブスクリプションに適用するクーポンの ID。
   proration_behavior	列挙値	create_prorations	移行後にサブスクリプションが比例配分を作成するかどうかを決定します。デフォルト値は create_prorations です。
   collection_method	列挙値	charge_automatically または send_invoice	自動的に請求する場合、Stripe は各請求期間の終了時に、顧客に関連付けられたデフォルトのソースを使用して、基になるサブスクリプションの決済を試みます。デフォルト値は charge_automatically です。請求書を送信する場合、Stripe は顧客に決済手順を記載した請求書をメールで送信し、サブスクリプションを有効としてマークします。send_invoice を使用している場合は、days_until_due を設定する必要があります。
   default_tax_rate	Stripe Tax の ID	txr_1LPcLzAWeZvbCyjpzDA4qs1l	サブスクリプションの default_tax_rates を設定します。これにより、このフェーズ中にサブスクリプションによって発行された請求書の default_tax_rates も決定されます。この値は、automatic_tax と互換性がありません。
   backstart_start_date	エポックの Unix 形式のタイムスタンプ	1705753518	作成されたサブスクリプションの start_date を決定します。これは過去の日付でなければなりません。設定されている場合、proration_behavior には none を指定する必要があります。これにより、backdate_start_date から実際の start_date までの比例配分を適用した請求書が作成されなくなります。詳細については、請求を行わずに遡及適用するをご覧ください。
   days_until_due	整数	30	請求書の作成日から期日までの日数。これは必須であり、collection_method が send_invoice に設定された請求書にのみ有効です。
   cancel_at_period_end	ブール値	false	期間の終了時にサブスクリプションをキャンセルするには、true を指定します。
   add_invoice_items.0.amount	番号	19.99	正の数。小数を含む完全な単位を使用します (例:21.50)。
   add_invoice_items.0.product	Stripe 製品 ID	prod_PjfC3kWS58IoOX	請求書を追加する商品の ID。
   add_invoice_items.0.currency	文字列	usd	サポートされている通貨の小文字 3 文字の ISO 通貨コード。

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

   Stripe 内での移行の場合

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

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

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

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

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

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

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

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

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

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

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

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

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

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