定期購入：移行ガイド

このガイドは、現在のプラットフォーム（例：Recharge や Appstle）からSHOPLINEの定期購入アプリへ定期購入契約を安全に移行する方法を説明します。これにより、以下が可能になります：

• 顧客の解約を最小限に抑える：移行中も元のプラットフォームで契約を有効に保ち、支払いの問題を防ぎ、顧客を維持します。

• 移行を簡素化：スムーズで信頼性の高いプロセスを使用してビジネスをSHOPLINEに移行し、強化された定期購入管理の恩恵を受けます。

このガイドでは、準備、契約のインポートと同期、結果の確認、契約管理、顧客の有効化について説明し、スムーズな開始をサポートします。

移行の概要

移行を開始する前に

1. SHOPLINE 定期購入のセットアップ

移行を行う前に、SHOPLINE 定期購入をインストールして設定してください。

以下のことを行っていることを確認してください：

• SHOPLINE定期購入アプリをインストールしました。
• 必要な購入プランを作成しました。移行される契約はこれらのプランにリンクされます。
• ストア表示設定で契約移行通知を設定しました。
• 設定で顧客が更新可能な情報を有効にしました。これには以下が含まれます：
  • 発送元情報
  • サブスク頻度
  • 支払い方法

購入プランとストア表示設定の詳細については、記事「定期購入：継続購入の設定」をご覧ください。

2. まず基本的なストアデータを移行する

契約を移行する前に、基本的なストアデータがすでにSHOPLINEに移行されていることを確認してください。これは契約データが正しくマッピングおよび表示されるために必要です。ストア移行ツールアプリを使用して、以下のような構造化データの移行を支援できます：

• 商品データ：元のプラットフォームからSHOPLINEへすべての商品データが移行されていることを確認してください。
• 顧客データ：元のプラットフォームからSHOPLINEへすべての顧客データが移行されていることを確認してください。

ステージ1：契約移行

ここでの目標は、契約のステータス、請求サイクル、商品、顧客、発送元住所、発送元情報を含む定期購入契約自体をSHOPLINEにインポートすることです。

契約を移行する方法は2つあります：

• API同期：元のストアがShopifyで、定期購入サービスがRecharge、Appstle、Loop、またはSealのマーチャント向け。注：API同期は移行中に元のストアと定期購入アプリを有効に保つ必要があり、追加費用が発生する場合がありますので、計画を立ててください。
• CSVインポート：API同期の要件を満たさないマーチャント、またはファイルを準備して一括でインポートしたいマーチャント向け。

API同期による契約移行

適用される場合：

API同期は現在、以下の場合に機能します：

• 元のストアプラットフォームはShopifyです。
• 元の定期購入プロバイダーはRecharge、Appstle、Loop、またはSealです。
• Shopifyの認証情報と定期購入プラットフォームのAPI認証情報の両方を取得できます。

ステップ1：Shopifyストアの認証情報を取得する

1. Shopify管理画面で、設定 > ドメインに移動し、ストアのドメイン（例：handle.myshopify.com）を確認します。
2. ドメインの「handle」部分をメモします。

Shopify APIキーの取得（2026年新ワークフロー）

2026年1月以降、一部のShopifyストアはDevダッシュボードで管理されます。Devダッシュボードを使用しているストアは、レガシーカスタムアプリを通じてAPIキーを取得できなくなります。この更新は既存のAPIキーには影響しません。既存のAPIキーはSHOPLINEで通常通り機能し続けます。

ストアがDevダッシュボードを使用している場合、デュアルシステム移行のためにクライアントIDとシークレットを取得するには、以下の手順に従ってください：

1. アプリの作成と開発

   • 設定 > アプリ に移動し、Dev Dashboardでアプリを作成をクリックします。

     

   • Dev Dashboardで、アプリを作成をクリックします。

     

   • Dev Dashboardから開始セクションで、名前を入力し、作成をクリックします。

     

   • 権限を選択をクリックし、権限（アプリ、注文、顧客、商品を含む）を選択してから、リリースをクリックします。以下のすべての権限がチェックされていることを確認してください：

     • read_all_orders

     • read_app_proxy

     • write_app_proxy

     • read_customers

     • read_customer_merge

     • read_orders

     • read_product_feeds

     • read_product_listings

     • read_products

     

   • ポップアップウィンドウで、再度リリースをクリックして確認します。

     

2. ＜strong＞クライアントID＜/strong＞と＜strong＞シークレット＜/strong＞を保存する

   • アプリを作成した後、＜strong＞設定＜/strong＞に移動し、SHOPLINE移行のために＜strong＞クライアントID＜/strong＞と＜strong＞シークレット＜/strong＞をコピーして安全に保存してください。

     

3. アプリをインストールする

   • アプリの＜strong＞ホーム＜/strong＞ページに移動し、＜strong＞インストール＜/strong＞をクリックします。

     

   • Shopify管理画面の＜strong＞アプリのインストール＜/strong＞ページで、もう一度＜strong＞インストール＜/strong＞をクリックして、Shopifyストアへのカスタムアプリのインストールを完了します。

     

Shopify APIキーの取得（2025年以前のレガシーワークフロー）

1. アプリの開発と作成

   • 設定 > アプリと販売チャネル > アプリを開発する に移動します。

     

   • カスタムアプリを作成をクリックし、アプリ名（例：「SHOPLINE移行アプリ」）を入力して、アプリを作成をクリックします。

     
     

2. 管理APIスコープの設定

   • すべてのAPI権限を選択し、保存をクリックします。

     

3. アプリをインストールしてAPIキーをコピーする

   • API認証情報に移動し、アプリをインストールをクリックして、API認証情報セクションからAPIトークンをコピーします。

   重要: トークンは一度だけ表示されます。安全に保存してください。

ステップ2：現在ご利用中のサブスクリプションプラットフォームからAPI認証情報を取得する

現在使用しているプラットフォームのみで行い、すべてのプラットフォームを設定する必要はありません。

Recharge APIキーの取得

1. 管理者トークンを作成

   • ツールとアプリ > APIトークンに移動し、管理者トークンカードの今すぐ作成をクリックします。

     

2. 管理者APIスコープを設定
   • トークンを作成した後、APIトークンを作成ページに入り、トークンに名前を付けます。

   • すべてのAPI権限を選択し、保存をクリックします。

     

3. APIキーをコピー

   • APIトークンセクションに移動し、APIキーをコピーします。

     

Appstle APIキーを取得

1. に移動します Appstle サブスクリプション > その他 > APIアクセス。

   

2. API キーセクションを見つけて、キーを生成をクリックします。

   

3. ポップアップウィンドウでAPIキーの名前を入力し、読み取り＆書き込み — すべてのAPIエンドポイントへのフルアクセスを選択してから、キーを作成をクリックします。

   

4. 生成されたAPIキーを後で使用するためにコピーします。

   

Seal APIキーを取得

Loop APIキーの取得

LoopのサブスクリプションAPIキーを取得するには、LoopヘルプセンターのLoop APIトークンの生成の記事をご参照ください。

ステップ3：SHOPLINEで契約の同期を開始する

1. SHOPLINEのSubscriptionsアプリ管理画面にログインします。
2. 移行センターに移動し、移行を開始をクリックします。
3. 元のサブスクリプションプラットフォームを選択します。
4. Shopifyのハンドル、クライアントID、シークレット、および現在のサブスクリプションプラットフォームのAPI認証情報を入力します。
5. もしサブスクリプションプランの自動マッチオプションがあれば、ニーズに合う場合は選択してください。
6. 今すぐインポートをクリックします。

システムはまず認証情報が有効かどうかを確認します。認証が完了すると、元のプラットフォームから定期購入契約データを取得し同期します。

CSVファイルによる契約の移行

ステップ1：契約移行用テンプレートのダウンロード

1. SHOPLINE Subscriptionsアプリ管理画面にログインします。
2. 移行センターに移動し、移行を開始をクリックします。
3. CSVインポートを選択します。
4. 最新の契約インポートテンプレートをダウンロードします。

管理画面から常に最新のテンプレートを使用してください。

ステップ2：元のプラットフォームから契約データをエクスポート

元のサブスクリプションプラットフォームにログインし、移行したい契約データをエクスポートします。

データを整理する前に、以下を確認してください：

• 商品とバリエーションがすでにSHOPLINEに存在していること。
• 顧客がすでにSHOPLINEに存在していること。
• 各契約に元のプラットフォームからの一意で安定したIDがあること。
• 請求を継続する契約には次回請求日が含まれていること。

ステップ3：契約インポートテンプレートの記入

契約テンプレートは契約データを移行するためのもので、アップロード前にご自身でデータをこの構造に整理する必要があります。

基本契約情報

許可されているステータスの値: ACTIVE, PAUSED, CANCELLED, FAILED, EXPIRED

請求サイクル情報

許可されている間隔の値: DAY, WEEK, MONTH, YEAR

日付と通貨情報

購入プランと商品情報

許可されているラインアイテム割引タイプの値: PERCENTAGE, FIXED_AMOUNT

配送先住所情報

配送情報

ステップ4：契約CSVファイルのアップロード

1. CSV一括インポートページに戻ります。
2. 次へをクリックします。
3. 完成した契約CSVファイルをアップロードします。
4. 指示に従い、各契約の支払いチャネルを選択します。
5. インポートをクリックし、完了するまで待ちます。

ステージ2：支払い移行

契約が移行されたら、SHOPLINEで元の支払い方法を引き続き使用したい場合は、支払いトークンを別途アップロードする必要があります。

支払い移行は契約移行の代わりにはなりません。まず契約が正常にインポートされたことを確認し、その後対応する支払いトークンをアップロードしてください。

開始前に準備するもの：

• 正常にインポートされた契約の元のサブスクリプションID。
• 顧客のメールアドレス。
• 契約で実際に使用されている現在の支払いチャネルとトークン情報。

元の支払い方法を引き続き使用する必要がある契約のみ支払いトークンをアップロードしてください。支払い移行が不要な契約についてはトークンファイルの記入は不要です。

支払いトークンファイルのフィールド

各契約の行には、実際に使用されている支払いチャネルのフィールドのみ記入し、他のチャネルのフィールドは空欄にしてください。

支払いトークンのアップロード方法

1. 契約がすでに移行されていることを確認します。
2. 支払いトークンのインポートテンプレートをダウンロードして記入します。
3. 契約IDがインポートした契約と完全に一致しているか再確認します。
4. SHOPLINEサブスクリプションの支払いトークンアップロードページに移動します。
5. ファイルをアップロードし、結果を待ちます。
6. 結果ファイルが提供された場合はダウンロードし、失敗した履歴を修正します。

支払いトークンが移行できない場合、契約は「移行中」ステータスのままにできます。顧客は後でカスタマーセンターで支払い方法を更新できます。

移行済み契約の管理

移行が完了すると、移行センターからすべての移行済み契約を表示および管理できます。

移行済み契約リスト

移行センター > 移行済み契約に移動すると、インポートまたは同期されたすべての契約が表示されます。リストには通常以下が含まれます：

移行ステータスの意味

利用可能な操作

「支払い更新待ち」または「移行不要」とマークされた契約については、管理者のサポート内容に応じて以下の操作が可能です：

• 割引コードを追加。
• 契約および顧客リストのフィルタリングとエクスポート。
• 対象顧客への再獲得メールの送信。

顧客に移行を完了してもらう方法

支払い移行や支払い方法の更新が完了していない契約については、契約が「移行成功」になる前に、顧客がカスタマーセンターで支払い方法を更新する必要があります。

契約移行通知の設定

サブスクリプション > 移行センター > 契約移行通知で、更新リマインダーバナーをオンにします。

顧客が支払い方法を更新する前に、直接契約を修正させるのではなく、移行中の混乱を避けるために支払い方法の更新が必要であることをまず説明するのが望ましいです。

顧客の操作

1. ストアのカスタマーセンターにログインします。
2. マイサブスクリプションに移動します。
3. 「支払い待ち更新」ステータスの契約（例：請求スケジュールや発送元住所の変更）を修正しようとすると、システムが支払い方法の更新を促します。
4. 今すぐ更新をクリックして契約更新ウィザードに入ります。
5. 次回請求日や発送元住所などの情報を確認または更新します。
6. 新しい支払い方法を追加します。
7. 支払い方法が更新されると、SHOPLINEが引き継ぎを完了し、契約ステータスが「移行成功」に変わります。

顧客が引き継ぎを完了すると、マーチャントに通知が届きます。二重請求を避けるために、元のプラットフォームで該当する古い契約を速やかに処理してください。

データの最新状態の維持

APIによる自動更新

API自動同期を有効にしている場合、Recharge、Appstle、Loop、Sealからの契約データの変更（契約更新やステータス変更など）は、Webhookを通じてほぼリアルタイムでSHOPLINEの移行契約リストに同期されます。「支払い待ち更新」契約のスナップショット情報を手動で更新する必要はありません。

CSVによる手動更新

CSVインポートを使用している場合、元のプラットフォームで契約データが「支払い待ち更新」中に変更された場合、SHOPLINEでスナップショット情報を手動で更新できます。

元のプラットフォームで契約を継続している場合は、そちらでも更新を同期してください。

よくある質問（FAQ）

二重システム移行ソリューションの利用に関するよくある質問への回答をご覧ください。

Q1: インポートした契約が「支払い方法更新待ち」と表示されるのはなぜですか？

これは通常、元の支払い方法（例：Shopify Payment）がSHOPLINEでサポートされていないか、支払い方法の移行が完了していない場合に発生します。

Q2: 契約を「移行成功」に変更するにはどうすればよいですか？

「支払い方法更新待ち」ステータスの契約については、顧客がストアで支払い方法を更新する必要があります。

Q3: 元のプラットフォームで契約を手動でキャンセルする必要がありますか？

CSVインポートの場合、SHOPLINEで契約が「移行成功」とマークされたら、二重請求を避けるために元のプラットフォームで古い契約を必ず手動でキャンセルしてください。対応しているサブスクリプションプラットフォームのAPIインポートでは、SHOPLINEがAPIを通じて自動的に古い契約をキャンセルします。

Q4: ShopifyまたはLegacy E-Commerce Solutionの注文データはAPI同期後にSHOPLINEに同期されますか？

API同期は主に契約データを更新します。注文データは、 ストア移行ツール アプリを使用して手動で同期する必要があります。