Start Strong
Sell Smart
Manage with Ease
Market to Success

定期購入アプリ：定期購入契約移行ガイド

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

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

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

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

 

 

移行前の準備

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

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

  • 商品データ：すべての商品データを元のプラットフォームからSHOPLINEに移行してください。
  • 顧客データ：すべての顧客データを元のプラットフォームからSHOPLINEに移行してください。

 

 

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

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

重要：APIキーは安全に保管し、他人に開示しないでください。

Shopifyのハンドルを見つける

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

Shopify APIキーの取得（新しいワークフロー）

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

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

  1. アプリの作成と開発

    • ＜strong＞設定＜/strong＞ > ＜strong＞アプリ＜/strong＞に移動し、＜strong＞開発ダッシュボードでアプリを作成＜/strong＞をクリックします。
      Group 3558256 (1).png

    • 開発ダッシュボードで、＜strong＞アプリを作成＜/strong＞をクリックします。
      Group 3558255 (1).png

    • ＜strong＞開発ダッシュボードから開始＜/strong＞セクションで、名前を入力し、＜strong＞作成＜/strong＞をクリックします。
      Group 3558257 (1).png

    • ＜strong＞スコープを選択＜/strong＞をクリックし、権限（＜strong＞アプリ＜/strong＞、＜strong＞注文＜/strong＞、＜strong＞顧客＜/strong＞、＜strong＞商品＜/strong＞など）を選択してから、＜strong＞リリース＜/strong＞をクリックします。
      Group 3558261 (1).png

    • ポップアップウィンドウで、確認のためにもう一度＜strong＞リリース＜/strong＞をクリックします。
      Group 3558305 (1).png

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

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

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

    • アプリのホームページに移動し、インストールをクリックします。
      Group 3558264 (1).png

    • Shopify管理画面のアプリをインストールページで、もう一度インストールをクリックして、Shopifyストアへのカスタムアプリのインストールを完了します。
      Group 3558265 (1).png

Shopify APIキーの取得（旧ワークフロー）

  1. アプリの開発と作成
    • 設定 > アプリと販売チャネル > アプリを開発する に移動します。
      Group 3558267 (1).png
    • カスタムアプリを作成をクリックし、アプリ名（例：「SHOPLINE移行アプリ」）を入力して、アプリを作成をクリックします。
      Group 3558306 (1).pngGroup 3558307 (1).pngGroup 3558272 (1).png
      Group 3558326.png
  2. 管理APIスコープの設定
    • すべてのAPI権限を選択し、保存をクリックします。
      Group 3558275 (1).pngGroup 3558277 (1).png
  3. アプリのインストールとAPIキーのコピー
    • API認証情報に移動し、アプリをインストールをクリックして、API認証情報セクションからAPIトークンをコピーします。
重要: トークンは一度だけ表示されます。安全に保存してください。

Group 3558279 (1).png
Group 3558329.png

Recharge APIキーの取得

  1. 管理者トークンの作成
    • ツールとアプリ >APIトークンに移動し、管理者トークンカードの今すぐ作成をクリックします。
      Group 3558285 (1).png
  2. 管理者APIスコープの設定
    • トークンを作成した後、APIトークンの作成ページに入り、トークンに名前を付けます。
    • すべてのAPI権限を選択し、保存をクリックします。
      Group 3558313.png
  3. APIキーのコピー
    • APIトークンセクションに移動し、APIキーをコピーします。
      Group 3558314.png

Appstle APIキーの取得

  1. に移動します Appstle定期購入 > その他 > APIアクセス。
    Group 3558293 (1).png

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

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

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

Note: APIアクセスは有料の追加購入です。有効にするにはAppstleサポートにお問い合わせください。費用は月額100ドルです。

SHOPLINE管理画面でAPIキーを設定する

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

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

  3. ポップアップにShopifyのハンドル、クライアントID、シークレット、RechargeのAPIキーを入力します。自動定期購入マッチングも有効にできます。その後、「今すぐインポート」をクリックしてAPIキーを検証します。
    Group 3558300 (1).png

  4. 検証後、SHOPLINEはRechargeからすべての定期購入契約データを自動的にインポートおよび同期します。

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

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

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

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

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

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

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

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

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

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

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

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

フィールド名 説明 必須 例
storeHandle SHOPLINEストアハンドル 必須 stgyangcheng2
id_processed サードパーティ契約番号 必須 1111111
status 契約ステータス：ACTIVE、CANCELLED、FAILED、EXPIRED（Pausedは含まれていません） 必須 ACTIVE
interval 定期購入の時間間隔（DAY、MONTH、WEEK、YEAR） 必須 DAY
interval_count 間隔の数量。例：「3週間ごとに購入」の場合、ここは3。 必須 2
max_cycles 最大実行サイクル数。値がない場合は無期限契約がデフォルト。   12
min_cycles 最小実行サイクル数 必須 2
periods 完了した注文数。値がない場合は0がデフォルト。   4
processed_at サードパーティ契約作成日時   2024-12-02T12:00:00
next_billing_date 次回契約実行日時 ［移行後の初回実行日時］ 必須 2025-01-28T12:00:00
currency_code 通貨情報 必須 MYR
line_items_amount 商品割引前の販売価格 必須 100
line_items_variant_id SHOPLINE商品固有のSKU ID 必須 18066984575317893633362795
line_items_product_source 商品SKUの出所    
line_items_quantity 商品数量。0より大きく、最大99999まで 必須 2
line_items_adjustment_type 割引タイプ。例：PERCENTAGE、FIXED_AMOUNT   FIXED_AMOUNT
line_items_adjustment_value 割引値   20
customer_id 定期購入顧客のSHOPLINE顧客ID 必須 4603168091
email 定期購入顧客のメール   xuweihang@shopline.com
delivery_first_name 名   bing
delivery_last_name 姓   tang
delivery_name ニックネーム    
delivery_phone 連絡先電話番号   13123334444
delivery_country 国または地域名   アメリカ合衆国
delivery_country_code 国または地域コード、2桁の略称（ISO-3166-1）、SHOPLINEによる変換 必須 US
delivery_province 州または県名   オハイオ州
delivery_province_code 州または県コード、入力標準コード（ISO-3166-2）、SHOPLINEによる変換 必須 WA
delivery_city 市区町村名   クリーブランド
delivery_city_code 市区町村コード    
delivery_company 会社名   FireXuan-USD
delivery_district 行政区名    
delivery_district_code 行政区コード   94101
delivery_address1 詳細住所情報1、補足情報用   University Hospital Drive
delivery_address2 詳細住所情報2、補足情報用   RR 2 Box 260
delivery_zip 配送先郵便番号   44106
delivery_id SHOPLINE配送プラン名   マルチ配送テストプラン
delivery_amount 送料   50
selling_plan_id SHOPLINE定期購入アプリからの定期購入プランID 必須 14066622198340539053032795
channel_customer_id 決済チャネルからの顧客ID。*契約の決済チャネルがStripeまたはSLPの場合は必須    
payment_method_id 決済チャネルからの支払い方法ID。*契約の決済チャネルがStripeまたはSLPの場合は必須    
account_name PayPalからの顧客アカウント名。*契約の決済チャネルがPayPalの場合は必須    
billing_agreement_id PayPalからの顧客請求契約ID。*契約の決済チャネルがPayPalの場合は必須    

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

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

  • SHOPLINE Payment

  • Stripe

  • PayPal

これらのチャネルのいずれかにリンクされた契約がある場合は、別々のCSVファイルに分割してください。インポート時に正しい支払いチャネルを選択すると、契約が紐付けられ、移行が即座に完了します。
Group 3558309 (1).png

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

  1. SHOPLINE Subscription アプリの管理画面にアクセスします。

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

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

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

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

 


インポートタスクの状況と結果の確認

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

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

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

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

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

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

  • インポート成功：Recharge API経由で取得した、またはCSVでアップロードしたすべての契約が正常にインポートされました。

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

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

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

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

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

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

 

 

移行契約管理

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

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

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

移行契約データレポート

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

  • 移行契約の合計数：移行リストにある契約の数。

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

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

移行契約リスト

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

フィールド名 フィールド定義 フィールド値の列挙 フィールド値の定義
移行方法 現在の契約インポート方法 CSVインポート 契約はCSV経由でインポートされました
Recharge API 契約はRecharge APIを通じて自動的に同期されました
Loop API 契約はLoop APIを通じて自動的に同期されました
Seal API 契約はSeal APIを通じて自動的に同期されました
移行完了時間 契約ステータスが「移行成功」に更新された時間 特定の時間点 契約ステータスが「移行成功」に更新された時間
移行ステータス 現在の契約がSHOPLINEに引き継がれ、支払い方法の更新が完了しているかどうか 支払い方法更新保留中 顧客はまだ現在の契約の更新操作を完了していません。契約は元のプラットフォームで継続中です。
移行成功 顧客は現在の契約を更新しました。契約はSHOPLINEに引き継がれており、元のプラットフォームでのキャンセルが必要です。
移行不要 元のプラットフォームでの契約ステータスが「キャンセル済み」、「失敗」、「完了」の場合、契約は移行不要とみなされます。

フィルター機能

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

  • 移行ステータス： 支払い方法更新保留中、移行成功。

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

  • 移行方法： Recharge API、CSV。

  • 移行完了時間： 日付範囲を選択。

顧客リコール操作

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

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

    • 移行ステータスが「支払い方法更新保留中」である。

    • プラットフォーム契約ステータスが「アクティブ」または「一時停止中」である。
      Group 3558310 (1).png

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

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

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

注意：顧客に明確な情報を提供するために、顧客に連絡する前に契約移行通知を設定してください。設定の詳細については、契約移行通知設定をご覧ください。

 

 

顧客アクティベーションプロセスの概要

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

契約移行通知設定

移行中は、顧客は定期購入契約を編集できません。「更新通知バナーを促す」を有効にして、顧客に支払い方法の更新を促してください。移行後は編集が再び可能になります。

これは、定期購入アプリ > ストアフロント表示 > 移行通知で設定します。
image 43 (1).png

顧客の手順

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

  1. ログイン：顧客はログインしてマイ定期購入に移動します。
    Group 3558302 (1).png
    Group 3558303 (1).png

  2. 再バインドの促し：「支払い方法更新保留中」の契約を編集しようとすると、支払い方法の更新を促すポップアップが表示されます。

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

    • 次回請求日

    • 配送先住所

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

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

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

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

    • 失敗した場合は、再試行を促すメッセージが表示されます。

マーチャントへの通知

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

 

 

データの保守と更新

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

API自動更新

API同期が有効になっている場合、Rechargeからの契約変更（契約更新やステータス更新など）は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で契約が「移行成功」とマークされたら、二重請求を避けるために元のプラットフォームで古い契約を必ず手動でキャンセルしてください。Recharge APIインポートの場合は、SHOPLINEがAPIを通じて自動的に古い契約をキャンセルします。

Q4: API同期後にRechargeの注文データはSHOPLINEに同期されますか？

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

 

この記事はAIを使用して翻訳されており、不正確な部分が含まれる可能性があります。最も正確な情報については、元の英語版をご参照ください。