サブスクリプション：サブスクリプション契約移行ガイド

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

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

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

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

移行前の準備

SHOPLINE 定期購入アプリの設定

移行を開始する前に、SHOPLINEの定期購入アプリをインストールし、購入プランを設定してください。現在のプラットフォームからインポートされたサブスクリプションは、対応するプラングループにリンクされます。

また、以下も忘れずに行ってください：

• SHOPLINE Subscriptionアプリでサブスクリプション移行のポップアップメッセージを設定する。
• アプリ設定で、顧客が以下を更新できるように有効にする：
  • 配送情報
  • サブスク頻度
  • 支払い方法

詳細な設定手順については、記事定期購入：継続購入の設定をご参照ください。

基本的なストアデータ移行の完了

契約を移行する前に、SHOPLINEストアで基本データの移行が完了していることを確認してください。これにより、正確な契約のマッピングと表示が保証されます。構造化されたストアデータの転送には、Multi-platform Store Migrationアプリを使用してください。以下を含みます：

• 商品データ：すべての商品データは、元のプラットフォームからSHOPLINEへ移行する必要があります。
• 顧客データ：すべての顧客データは、元のプラットフォームからSHOPLINEへ移行する必要があります。

APIによる契約データのインポート

現在、APIインポートは元のプラットフォームがShopifyで、Recharge、Appstle、Loop、またはSealを定期購入サービスとして使用しているマーチャントのみをサポートしています。APIインポートを開始する前に、元のプラットフォームでAPIキーを設定し、それをSHOPLINE定期購入アプリに提供する必要があります。

Shopifyハンドルの確認方法

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

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

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

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

1. アプリの作成と開発

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

     

   • Dev Dashboardで＜strong＞アプリを作成＜/strong＞をクリックします。

     

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

     

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

     • read_all_orders

     • read_app_proxy

     • write_app_proxy

     • read_customers

     • read_customer_merge

     • read_orders

     • read_product_feeds

     • read_product_listings

     • read_products

     

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

     

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トークンをコピーします。

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

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トークンの生成の記事を参照してください。

SHOPLINE管理画面でのAPIキー設定

1. SHOPLINE定期購入アプリ管理画面にログインします。

2. 定期購入に移動し、定期購入のインポートをクリックして、元のプラットフォーム（例：Recharge）を選択します。

   

3. ポップアップにShopifyハンドル、クライアントID、シークレット、および対応する定期購入プラットフォームのAPIキーを入力します。自動定期購入マッチングも有効にできます。その後、今すぐインポートをクリックしてAPIキーを検証します。

   

4. 検証後、SHOPLINEはRecharge、Appstle、Loop、Sealなどの以前の定期購入プラットフォームからすべての定期購入契約データをインポートおよび同期します。

CSVによる契約データのインポート

APIインポートが不可能な場合や、支払い方法付きの契約をインポートしたい場合は、CSVファイルを使用して契約データを手動でインポートできます。

公式テンプレートのダウンロード

1. SHOPLINE定期購入アプリの管理画面にログインします。

2. 「定期購入契約」に移動し、「移行開始」をクリックしてから、「CSVによる一括インポート」を選択します。

3. 「ダウンロード」をクリックして最新のsubscription-contracts-template.csvファイルを取得します。

   

元のプラットフォームからデータをエクスポートする

1. 元の定期購入プラットフォーム（例：Recharge、Appstle、Loop、Seal）にログインします。

2. プラットフォームの指示に従って、すべての定期購入契約データをエクスポートします。

データを整形し、テンプレートに入力する

1. エクスポートした契約データをダウンロードしたテンプレートに、行ごとに入力します。

2. すべての必須フィールドが入力されていること、日付などのデータ形式がテンプレートの要件に合っていることを確認してください。以下の主要フィールドの説明を参照してください：

支払いチャネル別の契約分割

SHOPLINEは、3つのチャネルを通じた定期購入支払いをサポートしています：

• SHOPLINE Payment

• Stripe

• PayPal

契約がこれらのいずれかのチャネルに紐づいている場合は、別々のCSVファイルに分割してください。インポート時に正しい支払いチャネルを選択すると、契約が紐づけられ、移行が即時に完了します。

CSVファイルのアップロード

1. SHOPLINE定期購入アプリの管理画面にアクセスします。

2. インポートウィンドウで、次へをクリックします。

3. 完成したCSVファイルをドラッグするか、アップロードエリアをクリックしてアップロードします。

4. これらの契約に適した支払いチャネルを選択します。

5. 今すぐインポートをクリックし、処理が完了するまでお待ちください。

   

インポートタスクのステータスと結果の照会

CSVインポートを使用する場合でもAPI同期を使用する場合でも、インポート／同期結果の表示と管理方法を知る必要があります。

タスクの進行状況とステータスの表示

今すぐインポートをクリックすると、システムのバックエンドでインポートプロセスが開始されます。

• インポートのポップアップを閉じてもインポートタスクは停止せず、バックグラウンドで継続されます。

• 注：バックグラウンドで実行できるインポートタスクは1つだけです。現在のタスクが完了する前に新しいインポートタスクを開始することはできません。

インポートタスクが完了すると、以下の3つのステータスのいずれかになります：

• インポート完了：サポートされているサブスクリプションプラットフォームのAPI経由で取得した、またはCSVでアップロードしたすべての契約が正常にインポートされました。

• インポート一部完了：一部の契約がデータ不一致やフォーマット非準拠などの理由で正常にインポートされませんでした。結果ファイルをダウンロードしてインポート失敗の原因を確認できます。

• インポート失敗：契約が一件も正常にインポートされませんでした。結果ファイルをダウンロードしてインポート失敗の原因を確認できます。

結果ファイルのダウンロード

• インポートタスクが完了した後、タスク結果がインポート部分成功またはインポート失敗の場合、ダウンロードボタンをクリックしてインポート結果ファイルをダウンロードできます。

• 結果ファイル（CSV形式）には契約IDと「失敗理由」が含まれており、各契約データのrowごとにインポート失敗の詳細な理由が明確に示されています。

• 失敗理由に基づいて元のCSVファイルのデータを修正し、再アップロードすることで残りの契約のインポートを完了できます。

移行契約管理

このセクションでは、移行契約がSHOPLINE管理画面にどのように表示され管理されるかを説明し、異なる移行ステージを明確にします。

移行契約リストとステージ

SHOPLINE定期購入アプリ管理画面にログインし、定期購入ページに移動して、移行済み定期購入を表示をクリックすると、移行契約ページにアクセスできます。

移行済み定期購入レポート

移行契約ページには、主に3つの指標が表示されます：

• 移行済み定期購入合計：移行リストにある契約の数。

• 移行成功：「移行ステータス」が「移行成功」の契約。

• 支払い方法更新待ち：「移行ステータス」が「支払い方法更新待ち」で、「有効」または「一時停止」の契約。

移行契約リスト

このリストは、インポートまたは同期されたすべての移行契約を表示します。契約移行に関連する主要なフィールドが含まれています。

フィルター機能

ページ上部のフィルターを使用して、契約を素早く検索できます。フィルターオプションには以下が含まれます：

• 移行ステータス：支払い待ちの支払い方法更新、移行成功。

• 元のプラットフォーム契約ステータス：有効、一時停止、キャンセル、期限切れ。

• 移行方法：対応しているサブスクリプションプラットフォームのAPI、CSV。

• 移行完了時間：日付範囲を選択してください。

顧客リコール操作

顧客にできるだけ早く支払い方法を更新してもらい、「支払い待ちの支払い方法更新」契約を「移行成功」に変換するために、自動メール機能を利用できます：

1. 契約リストのフィルター：契約リストのフィルター機能を使って、以下の条件の契約を絞り込みます：

   • 移行ステータスが「支払い待ち」の場合。

   • プラットフォーム契約ステータスが「有効」または「一時停止」の場合。

     

2. リコール方法の選択：ポップアップで2つのリコール方法が提示されます：

   • リコールメールを自動送信：システムがフィルターされた契約に対応する顧客に事前設定されたリコールメールを送信します。テンプレートの内容は修正可能です。メールテンプレートを更新した後は、変更が反映されるまで48時間お待ちください。リコールのCTAは顧客の契約管理管理画面に直接リンクします（支払い方法更新リンクには直接リンクしません）。

   • 契約およびユーザーリストをメールにエクスポート：現在選択されている契約リストを指定のメールアドレスにエクスポートし、カスタムマーケティングキャンペーンや手動フォローアップを行うことができます。

     

顧客の支払い方法更新プロセス

このセクションでは、顧客が支払い方法を更新して契約を「支払い方法更新待ち」から「移行成功」に変更する方法について説明します。

契約移行通知設定

移行中は、顧客は定期購入契約を修正できません。「更新通知バナーを表示」を有効にして、顧客に支払い方法の更新を促してください。移行後は修正が再開されます。

設定は定期購入アプリ > ストアフロント表示 > 移行通知で行います。

顧客の手順

契約を修正または更新するには、顧客はまず契約のアップグレードを完了する必要があります：

1. ログイン：顧客はログインしてマイサブスクリプションに移動します。

   
   

2. 再バインドのプロンプト：「支払い待ちの支払い方法更新」契約を修正しようとすると、支払い方法の更新を促すポップアップが表示されます。

3. 契約アップグレードウィザード：今すぐ更新をクリックすると、以下の内容を確認・修正するウィザードが開きます：

   • 次回請求日

   • 発送元住所

4. 支払い方法の更新：顧客は新しい支払い方法をバインドし、支払いを更新をクリックします。

   

5. 確認：バインド後、更新が完了したかどうかを尋ねるメッセージが表示されます。

6. 顧客が確認をクリックします。システムは更新をチェックします。

   • 成功した場合、契約のステータスは「移行成功」に更新され、通常の管理が可能になります。

   • 失敗した場合は、再試行を促すプロンプトが表示されます。

マーチャントへの通知

顧客が支払い方法を正常に更新すると、メール通知が届きます。

データのメンテナンスと更新

システムが契約データの正確性を維持するためにどのように更新するかを学びましょう。

API自動更新

API同期が有効になっている場合、対応するサブスクリプションプラットフォーム（契約更新やステータス更新など）からの契約変更は、Webhookを通じてほぼリアルタイムでSHOPLINEの移行契約リストに自動的に同期されます。「支払い方法更新待ち」の契約を更新するための手動操作は不要です。

CSV手動更新

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

手順：

1. 元のプラットフォームから最新の契約データをエクスポートします。
2. 更新する「未管理」契約のみを含むCSVを準備します。external_contract_idは変更せず、必要に応じて他の項目を更新してください。
3. CSVインポート準備に記載の通りCSVを再アップロードします。システムはexternal_contract_idに基づいて契約スナップショットを更新します。

よくある質問（FAQ）

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

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

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

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

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

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

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

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

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