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

ツールキットを使用して既存のサブスクリプションを Stripe に移行する方法をご紹介します。

Stripe ダッシュボードの [Billing 移行ツールキット](https://dashboard.stripe.com/billing/migrations)を使用して、サードパーティーシステム、自社製のシステム、または既存の Stripe アカウントの既存のサブスクリプションを Stripe Billing に移行します。

## Before you begin

1. [移行のステージ](https://docs.stripe.com/billing/subscriptions/migrate-subscriptions.md#migration-stages)を確認していない場合は、最初に確認します。
1. 移行を開始する前に、[Stripe Billing のシステムを設定](https://docs.stripe.com/billing/subscriptions/build-subscriptions.md)します。これは 1 回限りの設定であり、今後の移行で繰り返す必要はありません。
1. 現在の決済代行業者からの[PAN データのインポートをリクエストする](https://docs.stripe.com/get-started/data-migrations/pan-import.md)。このステップが必要になるのは、別の決済代行業者からStripeに移行する場合のみです。 StripeからStripeに移行している場合には、この前提条件をスキップできます。
1. サードパーティーまたは自社内のシステムから移行する場合は、既存のサブスクリプションのキャンセルと Stripe での新しいサブスクリプションの作成を行うタイミングを注意して設定してください。請求期間が短くならないようにするため、まず Stripe で新しいサブスクリプションを作成してから、古いサブスクリプションをキャンセルします。二重請求を避けるため、サブスクリプションの支払いが行われる前に、以前のシステムでサブスクリプションをキャンセルします。次の請求日が移行に近いサブスクリプションは、サイクル後に開始するようにスケジュールを設定して、最後の請求が以前のシステムで行われるようにします。

## Billing 移行ツールキットを開く

最初にテスト移行を実行する場合は、ダッシュボードで*サンドボックス* (A sandbox is an isolated test environment that allows you to test Stripe functionality in your account without affecting your live integration. Use sandboxes to safely experiment with new features and changes)を作成します。

1. [ダッシュボード](https://dashboard.stripe.com/billing)\> [Subscriptions](https://dashboard.stripe.com/test/subscriptions)\> [**移行**](https://dashboard.stripe.com/test/billing/migrations) に移動します。

   または、**+ サブスクリプションを作成**の横にあるオーバーフローメニュー (⋯) をクリックし、[サブスクリプションの移行](https://dashboard.stripe.com/settings/billing/migrations)を選択します。

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

## CSV ファイルをダウンロードする

まず、エクスポートされたデータを、移行と互換性のある CSV ファイルと照合して、既存のサブスクリプションをエクスポートします。独自の CSV ファイルを作成するか、Stripe が提供する以下の CSV テンプレート ([基本](https://docs.stripe.com/billing/subscriptions/import-subscriptions-toolkit.md#basic)、[複数価格項目](https://docs.stripe.com/billing/subscriptions/import-subscriptions-toolkit.md#multi-price)、[単発価格](https://docs.stripe.com/billing/subscriptions/import-subscriptions-toolkit.md#ad-hoc)) のいずれかをダウンロードすることができます。また、一般的な移行[ユースケース](https://docs.stripe.com/billing/subscriptions/import-subscriptions-toolkit.md#migration-use-cases)用の CSV ファイルの例もご覧いただけます。

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

1. 請求のユースケースに基づいて 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` と互換性がありません。                                                                                                                                                                  |
| `backdate_start_date`  | Timestamp             | `1658179441`                              | 作成されたサブスクリプションの `start_date` を決定します。これは過去の日付でなければなりません。設定されている場合、`proration_behavior` には `none` を指定する必要があります。これにより、`backdate_start_date` から実際の `start_date` までの比例配分を適用した請求書が作成されなくなります。詳細については、[請求を行わずに遡及適用する](https://docs.stripe.com/billing/subscriptions/backdating.md#backdating-no-charge)をご覧ください。 |
| `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` と互換性がありません。                                                                                                                                                                  |
| `backdate_start_date`          | Timestamp             | `1705753518`                              | 作成されたサブスクリプションの `start_date` を決定します。これは過去の日付でなければなりません。設定されている場合、`proration_behavior` には `none` を指定する必要があります。これにより、`backdate_start_date` から実際の `start_date` までの比例配分を適用した請求書が作成されなくなります。詳細については、[請求を行わずに遡及適用する](https://docs.stripe.com/billing/subscriptions/backdating.md#backdating-no-charge)をご覧ください。 |
| `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`                                     | [サポートされている通貨](https://docs.stripe.com/currencies.md)の小文字 3 文字の ISO 通貨コード。                                                                                                                                                                                                                                |

   ### 単発の価格の CSV

   この例では、既存の商品に対する[単発価格](https://docs.stripe.com/api/subscriptions/create.md#create_subscription-items-price_data)を使用したサブスクリプションの移行処理を表しています。

   ### 単発の価格の 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`                                     | [サポートされている通貨](https://docs.stripe.com/currencies.md)の小文字 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`                                     | [サポートされている通貨](https://docs.stripe.com/currencies.md)の小文字 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` と互換性がありません。                                                                                                                                                                  |
| `backdate_start_date`             | エポックの Unix 形式のタイムスタンプ | `1705753518`                              | 作成されたサブスクリプションの `start_date` を決定します。これは過去の日付でなければなりません。設定されている場合、`proration_behavior` には `none` を指定する必要があります。これにより、`backdate_start_date` から実際の `start_date` までの比例配分を適用した請求書が作成されなくなります。詳細については、[請求を行わずに遡及適用する](https://docs.stripe.com/billing/subscriptions/backdating.md#backdating-no-charge)をご覧ください。 |
| `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`                                     | [サポートされている通貨](https://docs.stripe.com/currencies.md)の小文字 3 文字の ISO 通貨コード。                                                                                                                                                                                                                                |

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

   > #### Stripe 内での移行の場合
   > 
   > Stripe アカウント内でサブスクリプションを移行する場合は、CSV ファイルを指定してアップロードする前に、[CSV の例](https://docs.stripe.com/billing/subscriptions/import-subscriptions-toolkit.md#within-Stripe-accounts)をご覧ください。

## CSV ファイルをアップロードする

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

Stripe は、ファイルを検証して、アップロードされたサブスクリプションが必須の CSV 形式に従っていることを確認します。ファイルのサイズによっては、このプロセスに最大で数時間かかる場合があります。ファイルが有効な場合は、移行の次のステップに進むことができます。検証エラーが発生した場合は、[エラーを解決](https://docs.stripe.com/billing/subscriptions/import-subscriptions-toolkit.md#resolve-validation-errors)して続行する必要があります。

## アップロードしたサブスクリプションを確認する

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

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

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

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

   エラーが表示された場合は、**移行をキャンセルする**をクリックし、[CSV ファイルのダウンロード](https://docs.stripe.com/billing/subscriptions/import-subscriptions-toolkit.md#download-csv)から移行を再開します。

## 移行の進捗を追跡する

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

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

  Billing 移行ツールキットで[サブスクリプションのスケジュール](https://docs.stripe.com/api/subscription_schedules.md)を使用して、サブスクリプションを移行することもできます。サブスクリプションを 24 時間スケジュールされた状態のままにして、そのまま本番環境に移行させることが可能です。サンドボックスではバッファ時間が 1 時間に短縮されるため、評価とテストをすばやく完了できます。                                                                                                                                                                                                                                                                                                     |
| 予定が設定されたサブスクリプション   | 移行後、サブスクリプションは、本番環境に移行する前に 24 時間、予定が設定された状態に保持されます。10 時間の期間の間は、ツールキットを使用して[スケジュールが設定されたサブスクリプションをキャンセルする](https://docs.stripe.com/billing/subscriptions/import-subscriptions-toolkit.md#cancel-migration)ことができます。

  移行ツールキットを使用して、スケジュールが設定されたサブスクリプションを更新することはできません。スケジュール済みのサブスクリプションを更新する場合は、[更新](https://docs.stripe.com/api/subscription_schedules/update.md)エンドポイントを呼び出すか、ダッシュボードの[サブスクリプション](https://dashboard.stripe.com/subscriptions)ページで各サブスクリプションを個別に更新します。

  顧客は、カスタマーポータルから予定が設定されたサブスクリプションをキャンセルできません。本番環境のサブスクリプションのみをキャンセルできます。                                                                                                        |
| サブスクリプションを本番環境に移行する | 24 時間後に、予定が設定されたサブスクリプションは本番環境に移行し、該当する開始日に顧客に請求します。本番環境のすべてのサブスクリプションは、ダッシュボードの[サブスクリプション](https://dashboard.stripe.com/subscriptions)ページで確認できます。

  移行が本番環境で開始されたら、最初の支払いからサブスクリプションを監視することをお勧めします。移行したサブスクリプションの支払い日と金額が、指定した [start_date](https://docs.stripe.com/api/subscription_schedules/create.md#create_subscription_schedule-start_date) と一致していることを確認します。

  顧客は、カスタマーポータルから本番環境のサブスクリプションをキャンセルできます。                                                                                                                                                                                                                                           |
| サブスクリプションを監視する      | 本番環境に移行したら、サブスクリプションで決済方法に問題がないか監視します。たとえば、`incorrect_number` のようなカード発行会社の回復不能な [decline codes](https://docs.stripe.com/declines/codes.md) が指定されている取引を確認し、請求書払いを[確実に受けられる対策を講じます](https://docs.stripe.com/get-started/data-migrations/pan-import.md#remap-customer-ids)。決済方法が無効になっている顧客に対しては、テキストメッセージやアプリ内通知など、メール以外の方法で通知することを検討してください。

  自動回収を適用する場合、[未払いまたは期日超過の請求書](https://docs.stripe.com/billing/collection-method.md#failed-incomplete-subscriptions)がないかを確認し、顧客が[デフォルトの支払い方法](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-payment_settings-save_default_payment_method)を設定し忘れていないか確認します。これを怠った場合、請求を回収できない可能性があります。 |

## すべての移行を表示

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

1. [**移行**](https://dashboard.stripe.com/billing/migrations)で、確認する移行を選択します。

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

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

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

## Optional: 移行をキャンセルする

スケジュール済みのサブスクリプションに問題がある場合は、移行をロールバックして、スケジュール済みのサブスクリプションを元に戻すことができます。ダッシュボードには、ツールキットを使用して移行をキャンセルできるかどうかを示すタイムスタンプが表示されます。サブスクリプションのスケジュールを設定してから 10 時間以内にキャンセルする必要があります。10 時間後、ツールキットのキャンセルオプションが無効になります。10 時間後に移行をキャンセルするには、[キャンセル](https://docs.stripe.com/api/subscription_schedules/cancel.md)エンドポイントを呼び出すか、ダッシュボードの[サブスクリプション](https://dashboard.stripe.com/subscriptions)ページで各サブスクリプションを個別にキャンセルします。

1. キャンセルする移行を[移行](https://dashboard.stripe.com/billing/migrations)で探します。
1. ドロップダウンメニューで、**移行をキャンセルする**をクリックします。

## Optional: 複数の移行を実行する

任意の数のサブスクリプションの移行を一度に実行できます。大規模な移行の場合は、サブスクリプションをバッチに分割して、小規模なバッチから開始します。これにより、検証の問題をすばやく特定し、検証にかかる時間を短縮できます。

新しい移行を開始するには、以下の手順を実行します。

1. **新しい移行を開始する**をクリックします。
1. [CSV ファイルのダウンロード](https://docs.stripe.com/billing/subscriptions/import-subscriptions-toolkit.md#download-csv)から移行処理を再開します。

また、一般的な移行[ユースケース](https://docs.stripe.com/billing/subscriptions/import-subscriptions-toolkit.md#migration-use-cases)用の CSV ファイルの例もご覧いただけます。

## Optional: 検証エラーを解決する

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

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

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

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

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

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

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

## 移行のユースケース

該当する場合は、このセクションの移行のユースケースをお客様独自の移行に適用できます。これらの例のタイムスタンプは Unix EPOCH 形式です。例には、サンドボックスで使用できるテスト用の顧客 ID と価格 ID も含まれています。

Stripe が提供する任意の CSV テンプレート ([基本](https://docs.stripe.com/billing/subscriptions/import-subscriptions-toolkit.md#basic)、[複数価格項目](https://docs.stripe.com/billing/subscriptions/import-subscriptions-toolkit.md#multi-price)、[単発価格](https://docs.stripe.com/billing/subscriptions/import-subscriptions-toolkit.md#ad-hoc)) を必要に応じてこれらの例と組み合わせることができます。

### さまざまな料金体系モデルのサブスクリプションを移行する

月額 100 USD の基本プランや、月額 200 USD の高度なプランなどの定額の料金体系のサブスクリプションを移行できます。これらのサブスクリプションには、1 つ以上のラインアイテムを設定できます。

**例 1 (基本)**: 1 月 1 日から開始される、数量 2 の基本的な 100 USD の月次サブスクリプションを移行します。サブスクリプションは、デフォルトの支払い方法を使用して自動的に請求されます。

|  |
|  |
| **属性`**   | customer (必須) | start_date (必須) | price (必須) | 数量 | metadata.third_party_sub_id | automatic_tax | billing_cycle_anchor | クーポン | trial_end | proration_behavior | collection_method    | default_tax_rate | backdate_start_date | days_until_due | cancel_at_period_end | add_invoice_items.0.amount | add_invoice_items.0.product | add_invoice_items.0.currency |
| **フィールド** | cus_xxxx1     | 1704067200      | price_xxx1 | 2  | subscription_1              |               |                      |      |           | なし                 | charge_automatically |                  |                     |                |                      |                            |                             |                              |

**例 2 (複数価格項目)**: 1 月 1 日に開始される以下のサブスクリプションを移行し、デフォルトの支払い方法を使用して自動的に請求されるようにします。

- 数量 2 の基本的な 100 USD の月次サブスクリプション
- 数量 1 の高度な 200 USD の月次サブスクリプション

|  |
|  |
| **属性`**   | customer (必須) | start_date (必須) | items.0.price (必須) | items.0.quantity | items.1.price | items.1.quantity | metadata.third_party_sub_id | automatic_tax | billing_cycle_anchor | クーポン | trial_end | proration_behavior | collection_method    | default_tax_rate | backdate_start_date | days_until_due | cancel_at_period_end | add_invoice_items.0.amount | add_invoice_items.0.product | add_invoice_items.0.currency |
| **フィールド** | cus_xxxx1     | 1704067200      | price_xxx1         | 1                | price_xxx2    | subscription_1   |                             |               |                      |      |           | なし                 | charge_automatically |                  |                     |                |                      |                            |                             |                              |  |

**例 3 (基本)**: 1 月 1 日に開始される以下のサブスクリプションを移行し、デフォルトの支払い方法を使用して自動的に請求されるようにします。

- 数量 2 の基本的な 100 USD の月次サブスクリプション
- 20 USD の単発の請求書の追加手数料

|  |
|  |
| **属性`**   | customer (必須) | start_date (必須) | price (必須) | 数量 | metadata.third_party_sub_id | automatic_tax | billing_cycle_anchor | クーポン | trial_end | proration_behavior | collection_method    | default_tax_rate | backdate_start_date | days_until_due | cancel_at_period_end | add_invoice_items.0.amount | add_invoice_items.0.product | add_invoice_items.0.currency |
| **フィールド** | cus_xxxx1     | 1704067200      | price_xxx1 | 2  | subscription_1              |               |                      |      |           | なし                 | charge_automatically |                  |                     |                |                      | 50                         | prod_xxx1                   | USD                          |

固定価格の金額がない場合には、単発の価格を使用してサブスクリプションを移行することもできます。

**例 4 (単発価格)**: 1 月 1 日に開始される以下のサブスクリプションを移行し、デフォルトの支払い方法を使用して自動的に請求されるようにします。

- 数量 1 の 153 USD の単発の月次サブスクリプション

|  |
|  |
| **属性`**   | customer (必須) | start_date (必須) | adhoc_items.0.amount (必須) | adhoc_items.0.product | adhoc_items.0.interval | adhoc_items.0.currency | adhoc_items.0.quantity | metadata.third_party_sub_id | automatic_tax | billing_cycle_anchor | クーポン | trial_end | proration_behavior   | collection_method | default_tax_rate | backdate_start_date | days_until_due | cancel_at_period_end | add_invoice_items.0.amount | add_invoice_items.0.product | add_invoice_items.0.currency |
| **フィールド** | cus_xxxx1     | 1704067200      | price_xxx1                | prod_xxx1             | 1                      | subscription_1         |                        |                             |               |                      |      | なし        | charge_automatically |                   |                  |                     |                |                      |                            |                             |                              |

### さまざまなタイプの決済回収方法でサブスクリプションを移行する

移行したサブスクリプションの支払いは、保存されているデフォルトの支払い方法を使用して自動的に回収するか、顧客が期日までに支払うことができる請求書を送信して回収できます。

**例 1 (基本)**: デフォルトの支払い方法を使用して自動的に請求される、1 月 1 日から開始される、数量 1 の年間 500 USD のサブスクリプションを移行します。

|  |
|  |
| **属性`**   | customer (必須) | start_date (必須) | price (必須) | 数量 | metadata.third_party_sub_id | automatic_tax | billing_cycle_anchor | クーポン | trial_end | proration_behavior | collection_method    | default_tax_rate | backdate_start_date | days_until_due | cancel_at_period_end | add_invoice_items.0.amount | add_invoice_items.0.product | add_invoice_items.0.currency |
| **フィールド** | cus_xxxx1     | 1704067200      | price_xxx1 | 1  | subscription_1              |               |                      |      |           | なし                 | charge_automatically |                  |                     |                |                      |                            |                             |                              |

**例 2 (基本)**: 1 月 1 日から開始する、数量 1 の年間 500 USD のサブスクリプションを移行します。このサブスクリプションは、顧客に送信される請求書を使用して請求され、期日は 30 日です。

|  |
|  |
| **属性`**   | customer (必須) | start_date (必須) | price (必須) | 数量 | metadata.third_party_sub_id | automatic_tax | billing_cycle_anchor | クーポン | trial_end | proration_behavior | collection_method | default_tax_rate | backdate_start_date | days_until_due | cancel_at_period_end | add_invoice_items.0.amount | add_invoice_items.0.product | add_invoice_items.0.currency |
| **フィールド** | cus_xxxx1     | 1704067200      | price_xxx1 | 1  | subscription_1              |               |                      |      |           | なし                 | send_invoice      |                  |                     | 30             |                      |                            |                             |                              |

### サブスクリプションサービス期間のさまざまな段階でサブスクリプションを移行する

**例 1 (基本): 更新が必要なサブスクリプションを移行する**。たとえば、更新日が 1 月 1 日の 100 USD の月次サブスクリプションを移行します。サブスクリプションは毎月 1 日に更新されます。

- `start_date` を現在の更新日に設定することで、サブスクリプションが直ちに請求されるようになります。
- `billing_cycle_anchor` を次回の更新サイクル日に設定します。
- `proration_behavior` を `none` に設定します。

|  |
|  |
| **属性`**   | customer (必須) | start_date (必須) | price (必須) | 数量 | metadata.third_party_sub_id | automatic_tax | billing_cycle_anchor | クーポン | trial_end | proration_behavior | collection_method    | default_tax_rate | backdate_start_date | days_until_due | cancel_at_period_end | add_invoice_items.0.amount | add_invoice_items.0.product | add_invoice_items.0.currency |
| **フィールド** | cus_xxxx1     | 1704067200      | price_xxx1 |    | subscription_1              |               | 1706745600           |      |           | なし                 | charge_automatically |                  |                     |                |                      |                            |                             |                              |

**例 2 (基本): 請求期間の途中の有料のサブスクリプションを移行します**。たとえば、元の開始日が 12 月 25 日の 100 USD の月次サブスクリプションを移行します。移行日は 1 月 1 日で、このサブスクリプションは毎月 25 日に更新されます。

- `backdate_start_date` をサブスクリプションの元の開始日に設定します。
- `billing_cycle_anchor` を次回の更新日に設定します。
- `start_date` に移行日を設定します。
- `proration_behavior` を `none` に設定すると、顧客に再度請求することを避け、次回の請求期間までサブスクリプションをスケジュール済みの状態に保つことができます。

|  |
|  |
| **属性`**   | customer (必須) | start_date (必須) | price (必須) | 数量 | metadata.third_party_sub_id | automatic_tax | billing_cycle_anchor | クーポン | trial_end | proration_behavior | collection_method    | default_tax_rate | backdate_start_date | days_until_due | cancel_at_period_end | add_invoice_items.0.amount | add_invoice_items.0.product | add_invoice_items.0.currency |
| **フィールド** | cus_xxxx1     | 1704067200      | price_xxx1 |    | subscription_1              |               | 1706140800           |      |           | なし                 | charge_automatically |                  | 1703462400          |                |                      |                            |                             |                              |

**例 3 (基本): トライアルがあるサブスクリプションを移行する**。たとえば、1 月 1 日に開始される基本的な 100 USD の月次サブスクリプションを移行します。このサブスクリプションは 1 月 31 日までトライアル中です。トライアルが終了すると、デフォルトの支払い方法を使用して、サブスクリプションに自動的に請求されます。

|  |
|  |
| **属性`**   | customer (必須) | start_date (必須) | price (必須) | 数量 | metadata.third_party_sub_id | automatic_tax | billing_cycle_anchor | クーポン | trial_end  | proration_behavior | collection_method    | default_tax_rate | backdate_start_date | days_until_due | cancel_at_period_end | add_invoice_items.0.amount | add_invoice_items.0.product | add_invoice_items.0.currency |
| **フィールド** | cus_xxxx1     | 1704067200      | price_xxx1 | 1  | subscription_1              |               |                      |      | 1706659200 | なし                 | charge_automatically |                  | 1703462400          |                |                      |                            |                             |                              |

**例 4 (基本): 期日を過ぎたサブスクリプションを移行します**。たとえば、最終サイクル開始日が 12 月 25 日で、まだ支払われていない 100 USD の月次サブスクリプションを移行します。1 月 1 日に開始されるサイクルの途中でこれを移行し、更新日を毎月 25 日にします。これにより、1 月 1 日から 1 月 25 日までの比例配分を適用した請求書が作成され、Stripe が支払いの回収を試行できます。

有効なサイクル内にあり、以前のシステムでまだ支払われていないサブスクリプションを移行するには、`proration_behavior` を `create_prorations` に設定し、すぐに請求書を作成して支払いを回収します。これにより、支払いがまだ未払いの場合、サブスクリプションは Stripe の督促フローにも組み込まれます。

|  |
|  |
| **属性`**   | customer (必須) | start_date (必須) | price (必須) | 数量 | metadata.third_party_sub_id | automatic_tax | billing_cycle_anchor | クーポン | trial_end | proration_behavior | collection_method    | default_tax_rate | backdate_start_date | days_until_due | cancel_at_period_end | add_invoice_items.0.amount | add_invoice_items.0.product | add_invoice_items.0.currency |
| **フィールド** | cus_xxxx1     | 1704067200      | price_xxx1 | 1  | subscription_1              |               | 1706140800           |      |           | create_prorations  | charge_automatically |                  | 1703462400          |                |                      |                            |                             |                              |

**例 5: サイクルの終了時にキャンセルする必要があるサブスクリプションを移行します**。移行後、移行のタイミング (サイクルの途中または更新時) に基づいて、これらのサブスクリプションに請求するかどうかを選択できます。

これらはその期間の終了時にキャンセルされます。たとえば、1 月 1 日に開始される基本的な 100 USD の月次サブスクリプションを移行します。このサブスクリプションは 1 月 31 日に自動的にキャンセルされます。

|  |
|  |
| **属性`**   | customer (必須) | start_date (必須) | price (必須) | 数量 | metadata.third_party_sub_id | automatic_tax | billing_cycle_anchor | クーポン | trial_end | proration_behavior | collection_method    | default_tax_rate | backdate_start_date | days_until_due | cancel_at_period_end | add_invoice_items.0.amount | add_invoice_items.0.product | add_invoice_items.0.currency |
| **フィールド** | cus_xxxx1     | 1704067200      | price_xxx1 | 1  | subscription_1              |               | 1706140800           |      |           | なし                 | charge_automatically |                  | 1703462400          |                |                      | TRUE                       |                             |                              |

### 税金が発生するサブスクリプションを移行する

**例 1 (基本)**: Stripe Tax を有効にして、サブスクリプションを移行して税金を自動計算します。たとえば、1 月 1 日に開始される 100 USD の月次サブスクリプションを移行し、Stripe Tax を有効にして税金を自動計算します。

移行ツールキットは、事前に Stripe Tax を有効にしたかどうか、および税金を自動計算するために必要なフィールドを顧客が入力したかどうかを検証します。移行の前に、顧客が必要な情報を提供していることを確認します。

|  |
|  |
| **属性`**   | customer (必須) | start_date (必須) | price (必須) | 数量 | metadata.third_party_sub_id | automatic_tax | billing_cycle_anchor | クーポン | trial_end | proration_behavior | collection_method    | default_tax_rate | backdate_start_date | days_until_due | cancel_at_period_end | add_invoice_items.0.amount | add_invoice_items.0.product | add_invoice_items.0.currency |
| **フィールド** | cus_xxxx1     | 1704067200      | price_xxx1 | 1  | subscription_1              | TRUE          |                      |      |           | なし                 | charge_automatically |                  |                     |                |                      |                            |                             |                              |

**例 2 (基本)**: [手動税率](https://dashboard.stripe.com/test/tax-rates)を使用して、サブスクリプションを移行し、税金を計算します。たとえば、1 月 1 日に開始される基本的な 100 USD の月次サブスクリプションを移行し、手動税率を使用して 10% の税金を適用します。

- [ダッシュボード](https://dashboard.stripe.com/test/tax-rates) (**商品カタログ** > **クーポン**) で 10% の手動税率を作成します。
- 移行の CSV テンプレートで税率 ID を使用します。

|  |
|  |
| **属性`**   | customer (必須) | start_date (必須) | price (必須) | 数量 | metadata.third_party_sub_id | automatic_tax | billing_cycle_anchor | クーポン | trial_end | proration_behavior | collection_method    | default_tax_rate | backdate_start_date | days_until_due | cancel_at_period_end | add_invoice_items.0.amount | add_invoice_items.0.product | add_invoice_items.0.currency |
| **フィールド** | cus_xxx1      | 1704067200      | price_xxx1 | 1  | subscription_1              | FALSE         | 1706140800           |      |           | なし                 | charge_automatically | txr_xxx1         |                     |                |                      |                            |                             |                              |

**例 3 (基本)**: Avalara や Verex などの外部の税金プロバイダを使用する場合:

税金がすでに計算されている移行済みのサブスクリプションでは、CSV で `automatic_tax` と `default_tax_rate` の両方を空白のままにします。

サブスクリプションが移行されて本番環境になると、Billing の実装で新しいサブスクリプションに設定した税金の実装ワークフローが自動的に適用されます。

### 割引があるサブスクリプションを移行する

移行ツールキットは、1 つのサブスクリプションにつき 1 つのクーポンのみをサポートします。

移行後に適用される割引付きのサブスクリプションを移行できます。たとえば、1 月 1 日から開始される 100 USD の月次サブスクリプションを移行するには、10% の永久割引が適用されます。

- [ダッシュボード](https://dashboard.stripe.com/test/tax-rates)で 10% のクーポンを作成します **商品カタログ** > **クーポン**)。
- 移行の CSV ファイルでクーポン名を使用します。

|  |
|  |
| **属性`**   | customer (必須) | start_date (必須) | price (必須) | 数量 | metadata.third_party_sub_id | automatic_tax | billing_cycle_anchor | クーポン          | trial_end | proration_behavior | collection_method    | default_tax_rate | backdate_start_date | days_until_due | cancel_at_period_end | add_invoice_items.0.amount | add_invoice_items.0.product | add_invoice_items.0.currency |
| **フィールド** | cus_xxxx1     | 1704067200      | price_xxx1 | 1  | subscription_1              |               |                      | sample_coupon |           | なし                 | charge_automatically |                  |                     |                |                      |                            |                             |                              |

### Stripe アカウント内でサブスクリプションを移行する

サブスクリプションを特定の Stripe アカウントから別のアカウントに移行する手順は、サードパーティーシステムから移行する手順と同じです。Billing 移行ツールキットを使用して、以前の Stripe アカウントから CSV ファイルのサブスクリプションデータをエクスポートします。

Stripe から Stripe への移行のための移行 CSV を作成するには、以下の手順に従います。

1. ダッシュボードを使用して以前の Stripe アカウントからサブスクリプションをエクスポートします。
1. 新旧の Stripe アカウント間のフィールドのマッピングには、以下の CSV の例を参考にしてください。

|  |
|  |
| **属性`**   | customer (必須)                             | start_date (必須)                                 | price (必須)          | 数量                                     | metadata.old_Stripe_sub_id             | automatic_tax                                     | billing_cycle_anchor | クーポン                      | trial_end               | proration_behavior                                 | collection_method                         | default_tax_rate    | backdate_start_date                         | days_until_due                    | cancel_at_period_end                 |
| **フィールド** | エクスポートフィールド: 顧客 ID (以前のアカウントのエクスポートからのもの) | エクスポートフィールド: 現在の期間終了 UTC (以前のアカウントのエクスポートからのもの) | 新しいアカウントのそれぞれの価格 ID | エクスポートフィールド: 数量 (以前のアカウントのエクスポートからのもの) | エクスポートフィールド: id (以前のアカウントのエクスポートからのもの) | 新しいアカウントで Stripe Tax を使用する場合は TRUE、それ以外の場合は FALSE | 新しいアカウントでの将来の請求日     | 新しいアカウントのそれぞれのクーポン (ある場合) | 新しいアカウントでの各トライアル (ある場合) | 比例配分された請求書の場合は `create_prorations`、それ以外の場合は `none` | `charge_automatically` または `send_invoice` | 新しいアカウントの各税率 (ある場合) | エクスポートフィールド: 開始日 UTC (以前のアカウントのエクスポートからのもの) | 回収方法として `send_invoice` を使用する場合に指定 | サブスクリプションが期間の終了時にキャンセル予定であるかどうかを指定する |

### 複数のフェーズがあるサブスクリプションを移行する

移行ツールキットは、サブスクリプションに複数のフェーズを直接追加することをサポートしていません。以下のアプローチをお勧めします。

1. 移行ツールキットを使用して、サブスクリプションの初期フェーズを移行します。
1. 移行後に、移行後のサブスクリプションスケジュールにその他のフェーズを追加します。これを行うには、[更新](https://docs.stripe.com/api/subscription_schedules/update.md)エンドポイントを呼び出すか、Stripe の[サブスクリプション](https://dashboard.stripe.com/test/subscriptions)ダッシュボードを使用します。
1. 移行の `start_date` を調整して、予定を設定済みのステータス変更から本番環境のステータス変更までに十分な時間を確保します。これにより、サブスクリプションを本番環境に移行する前にフェーズを更新できます。

## CSV リファレンス

移行ツールキットに、正しいフィールドに特定の情報を含む CSV をアップロードする必要があります。

### CSV の前提条件

CSV ファイルを作成またはダウンロードする前に、次の情報にアクセスできることを確認してください。

|  |
|  |
| **Customer オブジェクト**                                                                                            | すべての顧客は、デフォルトの[支払い方法を登録](https://docs.stripe.com/api/payment_methods/attach.md)しておく必要があります。デフォルトの支払い方法がない場合、今後のサブスクリプションの支払いに失敗します。データの移行後にデフォルトの支払い方法が顧客に設定されていない場合、以下の 2 つのオプションを利用できます。
  - ユーザーごとにデフォルトの支払い方法を確定するために、ユーザーの同意を得るか、ユーザーの過去の支払いパターンを活用します。
  - この[提供されたスクリプト](https://gist.github.com/bsears90/c3f36bfe379dfd13cae749824c5b45ae)を使用して、最新の支払い方法を顧客に関連付け、デフォルトの支払い方法にします。                                                                                                                      |
| **税金の自動計算**                                                                                                    | Stripe Tax を使用する場合 (税金の自動計算を true に設定している場合)、国別の[住所または郵便番号](https://docs.stripe.com/tax/customer-locations.md) (またはその両方) がすべての顧客に関連付けられている必要があります。Stripe では、指定されたサブスクリプションの税金の計算にこの情報が必要となります。                                                                                                                                                                                                                                                                                                                 |
| [collection_method](https://docs.stripe.com/api/subscriptions/create.md#create_subscription-collection_method) | サブスクリプションに `send_invoice` の支払い方法を使用する場合、以下を実行してください。
  - 必要な顧客にメールアドレスを追加します。
  - [days_until_due](https://docs.stripe.com/api/subscriptions/create.md#create_subscription-days_until_due) パラメーターを移行用 CSV ファイルに追加して、各顧客の*請求書* (Invoices are statements of amounts owed by a customer. They track the status of payments from draft through paid or otherwise finalized. Subscriptions automatically generate invoices, or you can manually create a one-off invoice)に有効期限を表示させます。                              |
| **日付**                                                                                                         | - 正確なタイミングを確保するには、移行用 CSV ファイルのエポックの日付時刻の形式を作成する際に、タイムゾーンに特に注意してください。
  - ツールキットの場合、CSV のアップロード時刻から 24 時間以上前の日付で [start_date](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-start_date) を設定します。この予備期間を確保して正確性を確認できるように、Stripe は[サブスクリプションスケジュール](https://docs.stripe.com/billing/subscriptions/subscription-schedules.md)を作成します。開始日が始まると、サブスクリプションは開始予定日から本番環境のステータスに変わります。                                                                                                          |
| **クーポン**                                                                                                       | - サブスクリプションスケジュールまたはサブスクリプションの[請求サイクルの起点](https://docs.stripe.com/billing/subscriptions/billing-cycle.md)が将来であり、`proration_behavior` が `none` に[設定されている](https://docs.stripe.com/billing/subscriptions/prorations.md#disable-prorations)場合、これらのオブジェクトを更新すると、クーポンの設定が解除されます。サブスクリプションスケジュールまたはサブスクリプションを更新した場合、クーポンを再適用します。
  - `discount_behavior` が継続しているサブスクリプションを移行するには、以下のようにします。
    - 有効期限が切れるのを待つのではなく、適切な日付でクーポンを削除する、将来のフェーズを設定します。
    - 正しく有効期限が切れるように、サブスクリプションごとにクーポンを作成します。期間はサブスクリプションごとに異なります。 |
| **Stripe 内での移行**                                                                                               | ユーザーは、Stripe のアカウント内でサブスクリプションを移行できます。顧客 ID と価格 ID (およびクーポン ID と税金 ID を使用している場合はその両方) を、移行元ではなく、移行先の Stripe アカウントに関連付けられたテンプレートに入力する必要があります。移行元のアカウントに関連付けられた ID を入力すると、移行ツールでエラーが発生します。                                                                                                                                                                                                                                                                                                                       |

### CSV 仕様 の詳細

| 属性                                | タイプ                                       | 説明                                                                                                                                                                                                                                                                                                       |
| --------------------------------- | ----------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `customer` **(必須)**               | Stripe 顧客 ID                              | サブスクリプションを作成する顧客の ID。                                                                                                                                                                                                                                                                                    |
| `start_date` **(必須)**             | エポックの Unix 形式のタイムスタンプ                     | サブスクリプションの作成日を指定します。このとき、24 時間 (またはそれ以上) 先の値を指定する必要があります。サンドボックスでは、1 時間後に設定することが可能です。                                                                                                                                                                                                                    |
| `price` **(必須)**                  | Stripe 価格 ID                              | 継続価格にする必要があります。複数のアイテムを移行する場合は、代わりに `items.x.{price, quantity}` 形式を使用します。`adhoc_items.x.{amount, interval, product, currency}` を使用すると、単発の価格にも対応できます。                                                                                                                                                     |
| `quantity`                        | 番号                                        | サブスクリプションの数量を決定します。デフォルトでは、各サブスクリプションは 1 つの商品に対するものですが、Stripe では 1 つのアイテムの複数の数量に対するサブスクリプションに顧客を登録できます。                                                                                                                                                                                                  |
| `items.x.price` **(必須)**          | Stripe 価格 ID                              | Price オブジェクトの ID。継続価格にする必要があります。                                                                                                                                                                                                                                                                         |
| `items.x.quantity`                | 番号                                        | サブスクリプションの数量を決定します。デフォルトでは、各サブスクリプションは 1 つの商品に対するものですが、Stripe では 1 つのアイテムの複数の数量に対するサブスクリプションに顧客を登録できます。                                                                                                                                                                                                  |
| `adhoc_items.x.amount` **(必須)**   | 番号                                        | 正の数。小数を含む完全な単位を使用します (例:21.50)。                                                                                                                                                                                                                                                                          |
| `adhoc_items.x.product` **(必須)**  | Stripe 製品 ID                              | 単発の価格に属する商品の ID。                                                                                                                                                                                                                                                                                         |
| `adhoc_items.x.interval` **(必須)** | `day`、`week`、`month`、または `year`           | 請求の頻度。                                                                                                                                                                                                                                                                                                   |
| `adhoc_items.x.currency` **(必須)** | 文字列                                       | [サポートされている通貨](https://docs.stripe.com/currencies.md)の小文字 3 文字の ISO 通貨コード。                                                                                                                                                                                                                                |
| `adhoc_items.x.quantity`          | 番号                                        | サブスクリプションの数量を決定します。デフォルトでは、各サブスクリプションは 1 つの商品に対するものですが、Stripe では 1 つのアイテムの複数の数量に対するサブスクリプションに顧客を登録できます。                                                                                                                                                                                                  |
| `metadata_source`                 | 文字列                                       | Stripe 内での移行を行う場合は、`internal:Stripe` と入力します。                                                                                                                                                                                                                                                             |
| `metadata_*`                      | 文字列                                       | 以下のキーと値のペアをオブジェクトに関連付けます。これは、オブジェクトに関する追加情報を構造化された形式で格納するのに便利です。                                                                                                                                                                                                                                         |
| `automatic_tax`                   | ブール値                                      | Stripe Tax による税金の自動計算設定を使用するには、`true` を指定します。                                                                                                                                                                                                                                                            |
| `coupon`                          | Stripe クーポン ID                            | このサブスクリプションに適用するクーポンの ID。                                                                                                                                                                                                                                                                                |
| `currency`                        | 文字列                                       | 小文字の 3 文字の [ISO 通貨コード](https://www.iso.org/iso-4217-currency-codes.html)。 [対応している通貨](https://docs.stripe.com/currencies.md)を指定してください。多通貨の価格で通貨を選択する際に使用されます。                                                                                                                                             |
| `trial_end`                       | Timestamp                                 | フェーズを開始日から `trial_end` 日付までトライアルに設定します。サイクル/フェーズの終了日より前の値を指定する必要があり、トライアルと組み合わせることはできません。                                                                                                                                                                                                                |
| `proration_behavior`              | `create_prorations` または `none`            | 移行後にサブスクリプションが比例配分を作成するかどうかを決定します。デフォルト値は `create_prorations` です。                                                                                                                                                                                                                                        |
| `collection_method`               | `charge_automatically` または `send_invoice` | 自動的に請求する場合、Stripe は各請求期間の終了時に、顧客に関連付けられたデフォルトのソースを使用して、基になるサブスクリプションの決済を試みます。デフォルト値は `charge_automatically` です。請求書を送信する場合、Stripe は顧客に決済手順を記載した請求書をメールで送信し、サブスクリプションを有効としてマークします。`send_invoice` を使用している場合は、`days_until_due` を設定する必要があります。                                                                 |
| `default_tax_rate`                | Stripe Tax の ID                           | サブスクリプションの `default_tax_rates` を設定します。これにより、このフェーズ中にサブスクリプションによって発行された請求書の `default_tax_rates` も決定されます。この値は、`automatic_tax` と互換性がありません。                                                                                                                                                                  |
| `backdate_start_date`             | エポックの Unix 形式のタイムスタンプ                     | 作成されたサブスクリプションの `start_date` を決定します。これは過去の日付でなければなりません。設定されている場合、`proration_behavior` には `none` を指定する必要があります。これにより、`backdate_start_date` から実際の `start_date` までの比例配分を適用した請求書が作成されなくなります。詳細については、[請求を行わずに遡及適用する](https://docs.stripe.com/billing/subscriptions/backdating.md#backdating-no-charge)をご覧ください。 |
| `billing_cycle_anchor`            | Timestamp                                 | 顧客にサブスクリプションを請求する将来の日付を決定します。                                                                                                                                                                                                                                                                            |
| `days_until_due`                  | 整数                                        | 請求書の作成日から期日までの日数。これは必須であり、`collection_method` が `send_invoice` に設定された請求書にのみ有効です。                                                                                                                                                                                                                         |
| `cancel_at_period_end`            | ブール値                                      | 期間の終了時にサブスクリプションをキャンセルするには、`true` を指定します。                                                                                                                                                                                                                                                                |

## See also

- [Stripe APIs でサブスクリプションを管理する](https://docs.stripe.com/billing/subscriptions/import-subscriptions.md)