订阅式电商：订阅合同搬迁指南 – SHOPLINE 常见问题

本文将帮助您把原订阅平台（如 Recharge、Appstle 等）中的订阅合同搬迁至 SHOPLINE 订阅电商。此方案致力于：

降低客户流失：在合同迁移过程中，确保原有平台管理的合同能继续运行，避免支付中断导致客户流失。
降低搬迁难度：提供灵活、可靠的迁移路径，让您无忧地将业务转移到 SHOPLINE，享受更强大的订阅管理能力。

本指南将详细介绍搬迁前的各项准备工作、合同导入/同步的步骤、结果查询、合同管理以及客户端激活流程，助您轻松上手。

搬迁流程一览

阶段	步骤	说明
准备阶段	1. 配置 SHOPLINE 订阅电商	安装插件、创建订阅方案，并完成合同迁移通知等基础设置。
准备阶段	2. 完成店铺基础数据搬迁	先完成商品与客户数据搬迁，确保合同中的商品、客户和地址能够正确关联。
合同搬迁	3. 搬迁订阅合同	通过 API 同步或 CSV 文件，将合同基础信息、商品、客户、收货地址和物流信息导入 SHOPLINE。
合同搬迁	4. 查看合同导入结果	查看任务状态；若存在失败数据，下载结果文件、修正后重新导入。
支付搬迁	5. 上传支付 Token	在合同已导入后，按实际支付渠道上传对应的支付 Token 信息。
合同接管	6. 引导客户更新支付方式	对尚未完成接管的合同，通知客户进入客户中心更新支付方式。
合同接管	7. SHOPLINE 接管合同	客户完成支付方式更新后，合同状态变为【搬迁成功】。
收尾阶段	8. 处理原平台合同	合同由 SHOPLINE 接管后，按实际搬迁方式处理原平台中的旧合同，避免重复扣款。

搬迁前置准备

1. 配置 SHOPLINE 订阅电商

开始搬迁前，请先安装并完成 SHOPLINE 订阅电商的基础配置。

请确认已完成以下事项：

已安装 SHOPLINE 订阅电商插件。
已创建所需的订阅方案。搬迁的合同将关联至对应的订阅方案。
已在【店铺展示设置】中配置合同迁移通知。
已在【设置】中开启允许客户更新的信息，包括：
- 收货信息
- 订阅频率
- 付款方式

有关订阅方案和店铺展示设置的详细配置，请参考订阅式电商-定期购买文章。

2. 完成店铺基础数据搬迁

在开始合同迁移之前，请务必确保您的 SHOPLINE 店铺已完成基础数据的搬迁工作，这是合同数据能够正确映射和展示的前提。您可以使用多平台店铺一键搬迁插件帮助完成店铺结构化数据搬迁，包括如下数据：

商品数据：请确保所有的商品结构化数据都已从原平台搬迁至 SHOPLINE
客户数据：请确保所有的客户结构化数据都已从原平台搬迁至 SHOPLINE

注意：若商品或客户数据未完成搬迁，合同导入时可能无法正确关联商品或客户。

第一阶段：合同搬迁

合同搬迁的目标是先将订阅合同本身导入 SHOPLINE，包括合同状态、订阅周期、商品、客户、收货地址及物流信息。

合同搬迁支持两种方式：

API 同步：适用于原店铺为 Shopify，且订阅服务使用 Recharge、Appstle、Loop 或 Seal 的商家。请注意，API 同步依赖原店铺和原订阅插件在合同搬迁期间持续保持运行，会产生额外费用请酌情考量。
CSV 导入：适用于不满足 API 同步条件，或希望通过文件批量整理并一次性完成导入的商家。

通过 API 同步搬迁合同

适用场景

API 同步目前适用于：

原店铺平台为 Shopify。
原订阅服务商为 Recharge、Appstle、Loop 或 Seal。
商家可以获取 Shopify 凭证及对应订阅平台的 API 凭证。

重要： API 同步依赖原店铺和原订阅插件在合同搬迁期间持续保持运行，会产生额外费用，请酌情考量。

第一步：准备 Shopify 店铺凭证

获取 Shopify Handle

请前往 Shopify 后台，【设置】 > 【域名】，查看你的店铺域名（如 handle.myshopify.com）
记录 handle.myshopify.com 中的 handle

获取 Shopify Client ID 和 Secret 流程（2026 新版流程）

自 2026 年 1 月起，Shopify 按照灰度方式，将部分店铺切换至 Dev Dashboard 进行管理。切换至 Dev Dashboard 的店铺不再支持通过 Legacy custom apps 获取 API Key。Shopify 更新不会影响到旧版流程中已经应用的 API Key，若您之前在 SHOPLINE 已经添加过 API Key，之后仍可以继续使用。

若您被切换至 Dev Dashboard，请按照下列新版流程获取 Client ID 和 Secret，以用于双系统搬迁流程。

重要： Client ID 和 Secret 需要由商家自行在 Dev Dashboard 中创建应用后获取，无法通过协作者权限创建应用并获取。

新版流程如下：

开发并创建应用
- 进入设置，点击【应用】>【在 Dev Dashboard 开发应用】
- 进入 Dev Dashboard 后台，点击【Create app】，输入自定义的应用名称，并点击【Create】
- 点击【Select Scope】，选择权限（包括 App、Order、Customer、Product），然后点击【Release】。请确保以下所有权限都已勾选：
  - read_all_orders
  - read_app_proxy
  - write_app_proxy
  - read_customers
  - read_customer_merge
  - read_orders
  - read_product_feeds
  - read_product_listings
  - read_products
保存 Client ID 和 Secret
- 创建成功后，点击【Setting】，复制并保存 Client ID 和 Secret，后续将用于 SHOPLINE 双系统搬迁。
安装应用到 Shopify 店铺
- 点击【Install】，完成 Shopify 自定义应用的安装流程。

获取 Shopify API Key 流程（2025之前旧版流程）

开发并创建应用
- 进入设置，点击【应用和销售渠道】>【开发应用】
- 进入创建自定义应用界面，命名【应用名称】自用即可，并点击【创建应用】
配置后台 API 范围
- 创建成功后，下滑页面全选所有 API 权限，点击【保存】
安装应用，并复制 API key
- 前往 API 凭证界面，点击【安装应用】后，在【API 凭据】栏位即可获得 API token。
  注意：token 仅展示一次，可单独保存。

第二步：按当前订阅平台获取 API 凭证

您只需要选择当前正在使用的一个订阅平台，并按该平台的说明获取 API 凭证；无需同时完成所有平台的配置。

获取 Recharge API Key 获取流程

创建 Admin Token
- 进入 Tool & App，在 Admin Token 卡片内点击【现在创建】
配置后台 API 范围
- 创建成功后，进入创建 API Token 界面，按需填写 Token 名称
- 下滑页面全选所有 API 权限，点击【保存】
回到后台，并复制 API key
- 前往 API Token 界面，在【API key】栏位即可获得 API token

获取 Appstle API Key 流程

创建 API Key，进入【More】> 【API Access】
点击【Create key】
创建成功后，点击复制 API Key 用于后续搬迁流程

注意：Appstle 的API功能为附加功能，需要联系 Appstle 客服开通。附加费用为 $100/月

获取 Seal API Key 流程

前往【Settings】> 【API】，然后点击 Enable API 以获取 API Key 和 Secret。
image (12).png

获取 Loop API Key 流程

如需获取 Loop 订阅平台的 API Key，请参考 Loop 帮助中心中的 Generate Loop API Tokens 文章。

第三步：在 SHOPLINE 后台开始合同同步

登录 SHOPLINE 订阅电商插件后台。
进入【搬迁中心】页面，点击【开始搬迁】。
选择您的原订阅平台。
填写 Shopify Handle、Client ID、Secret，以及当前订阅平台对应的 API 凭证。
如后台提供【自动匹配订阅计划】选项，请按实际需求选择。
点击【立即导入】。

系统会先校验凭证有效性。校验通过后，系统将从原订阅平台读取并同步订阅合同数据。

通过 CSV 文件搬迁合同

第一步：下载合同搬迁模板

登录 SHOPLINE 订阅电商插件后台。
进入【搬迁中心】页面，点击【开始搬迁】。
选择【CSV 导入】。
下载最新的合同导入模板。

请始终使用后台最新下载的模板。

第二步：从原平台导出合同数据

登录原订阅平台，导出需要搬迁的订阅合同数据。

建议在整理前先确认：

商品及商品规格已在 SHOPLINE 中存在。
客户已在 SHOPLINE 中存在。
每条合同均有唯一且稳定的原平台合同 ID。
需要继续履约的合同已包含下一次扣款日期。

第三步：填写合同导入模板

合同模板用于搬迁合同数据，需要自行整理好结构化数据再上传。

合同基础信息

模板字段	说明	必填	填写参考
`Store Handle`	SHOPLINE 店铺 Handle。	是	`example-store`
`*Original Subscription ID`	原平台订阅合同 ID；用于识别和更新同一份合同，最长 32 个字符。	是	`EXT-CONTRACT-1111111`
`*Status`	合同状态。	是	`ACTIVE`
`*Customer ID`	SHOPLINE Customer ID。客户需已完成基础数据搬迁。	是	`4603168091`
`Email`	订阅客户邮箱。	否	`example@shopline.com`

Status 支持以下值：

值	含义
`ACTIVE`	生效中
`PAUSED`	已暂停
`CANCELLED`	已取消
`FAILED`	失败
`EXPIRED`	已到期

订阅周期与履约信息

模板字段	说明	必填	填写参考
`*Interval`	订阅周期单位。	是	`MONTH`
`*Interval count`	间隔数量。例如每 2 周履约一次，填写 `2`。	是	`2`
`*Min cycles`	最小履约周期数，最小值为 `1`。	是	`1`
`Max cycles`	最大履约周期数；留空表示不限制。	否	`12`
`Orders fulfilled`	已履约订单数；留空时按 `0` 处理。	否	`4`

Interval 支持以下值：

值	含义
`DAY`	天
`WEEK`	周
`MONTH`	月
`YEAR`	年

时间与币种信息

模板字段	说明	必填	填写参考
`Created at (original platform)`	合同在原平台的创建时间。应使用带时区偏移的 ISO 8601 格式。	否	`2024-12-02T12:00:00-05:00`
`*Next billing date`	合同搬迁后首次计划扣款/履约的时间。应使用带时区偏移的 ISO 8601 格式。	是	`2025-01-28T12:00:00-05:00`
`*Currency code (ISO 4217)`	合同币种，需使用 ISO 4217 三位币种代码，并与店铺币种一致。	是	`USD`

订阅计划与商品信息

模板字段	说明	必填	填写参考
`*Selling plan ID`	SHOPLINE 订阅计划 ID。	是	`14066622198340539053032795`
`*Line items amount`	商品行项目金额。	是	`100`
`*Line items variant ID`	SHOPLINE 商品规格 ID。商品规格需已存在于店铺中。	是	`18066984575317893633362795`
`*Line items quantity`	商品数量。	是	`2`
`Line items product source`	商品来源信息。	否	按模板或实际数据填写
`Line items adjustment type`	折扣类型。	否	`FIXED_AMOUNT`
`Line items adjustment value`	折扣值。	否	`20`

Line items adjustment type 可参考以下值：

值	含义
`PERCENTAGE`	百分比折扣
`FIXED_AMOUNT`	固定金额折扣

收货地址信息

模板字段	说明	必填	填写参考
`Delivery first name`	收货人名。	否	`Bing`
`Delivery last name`	收货人姓。	否	`Tang`
`Delivery phone`	收货人联系电话。	否	`12165550123`
`Delivery country`	国家或地区名称。	否	`United States`
`*Delivery country code (ISO 3166-1)`	国家或地区代码，使用 ISO 3166-1 两位代码。	是	`US`
`Delivery state/province`	州、省或地区名称。	否	`Ohio`
`*Delivery state/province code (ISO 3166-2)`	州、省或地区代码，使用 ISO 3166-2 标准代码。	是	`OH`
`Delivery city`	城市名称。	否	`Cleveland`
`Delivery city code (non-US markets)`	城市代码，适用于非美国市场。	否	按实际地区填写
`Delivery company`	公司名称。	否	`FireXuan-USD`
`Delivery district (non-US markets)`	区/行政区名称，适用于非美国市场。	否	按实际地区填写
`Delivery district code (non-US markets)`	区/行政区代码，适用于非美国市场。	否	按实际地区填写
`Delivery address`	详细地址。	否	`University Hospital Drive`
`Delivery address2`	地址补充信息。	否	`RR 2 Box 260`
`Delivery zip/postal code`	邮编。	否	`44106`

物流信息

模板字段	说明	必填	填写参考
`Shipping plan name`	SHOPLINE 物流计划名称。	否	`Multi Delivery Test Plan`
`Shipping amount`	运费金额；留空时将在实际扣款时实时计算。	否	`50`

第四步：上传合同 CSV 文件

返回【通过 CSV 批量导入】页面。
点击【下一步】。
上传已填写完成的合同 CSV 文件。
根据页面提示选择合同对应的支付渠道。
点击【导入】，等待合同导入完成。

第二阶段：支付搬迁

合同搬迁完成后，如需在 SHOPLINE 中继续使用原支付渠道的付款信息，您需要单独上传支付 Token。

支付搬迁并不替代合同搬迁。请先确保合同已成功导入，再上传与合同对应的支付 Token。

上传前准备

请准备以下信息：

已成功导入的合同对应的 Original Subscription ID。
客户邮箱。
当前合同实际使用的支付渠道及相应 Token 信息。
仅上传仍需使用原支付方式的合同；不需要支付搬迁的合同无需填写支付 Token 文件。

支付 Token 文件字段说明

支付 Token 文件用于按支付渠道补充付款信息。每一行合同只需填写其实际支付渠道对应的字段，其他渠道字段留空即可。

模板字段	说明	何时必填	填写参考
`*Orignal Subscription ID`	原平台订阅合同 ID，必须与合同搬迁文件中的 `Original Subscription ID` 保持一致，最长 32 个字符。	始终必填	`EXT-CONTRACT-1111111`
`Email`	客户邮箱，用于辅助识别客户。	建议填写	`example@shopline.com`
`Channel customer id (Stripe)`	Stripe 渠道客户 ID。	合同使用 Stripe 时必填	Stripe Customer ID
`Payment method ID (Stripe)`	Stripe 支付方式 ID。	合同使用 Stripe 时必填	Stripe Payment Method ID
`Account name (Paypal)`	PayPal 客户账户名称。	合同使用 PayPal 时必填	PayPal Account Name
`Billing agreement id (Paypal)`	PayPal 账单协议 ID。	合同使用 PayPal 时必填	PayPal Billing Agreement ID
`Channel customer id (SLP)`	SLP 支付渠道客户 ID。	合同使用 SLP 支付渠道时必填	渠道 Customer ID
`Payment method ID (SLP)`	SLP 支付渠道支付方式 ID。	合同使用 SLP 支付渠道时必填	渠道 Payment Method ID

重要：请勿在同一条合同记录中同时填写多个支付渠道的 Token 信息。

上传支付 Token

确认相关合同已完成合同搬迁。
下载并填写支付 Token 导入模板。
检查合同 ID 是否与已导入合同完全一致。
在 SHOPLINE 订阅电商后台进入支付 Token 上传入口。
上传文件并等待处理结果。
若系统提供结果文件，请下载并处理失败记录。

若支付 Token 无法搬迁，合同仍可保留在【搬迁中】状态，后续由客户在客户中心完成支付方式更新。

管理搬迁合同

完成合同搬迁后，您可以在搬迁中心页面查看和管理全部搬迁合同。

搬迁合同列表

进入【搬迁中心】页面，点击【搬迁合同】，即可查看已导入或已同步的合同。

列表中通常包括以下核心信息：

字段	说明
搬迁方式	合同来源，例如 CSV 导入、Recharge API、Appstle API、Loop API 或 Seal API。
搬迁完成时间	合同状态更新为【搬迁成功】的时间。
搬迁状态	表示合同是否已完成支付方式更新并由 SHOPLINE 接管。
原平台合同状态	原平台合同的状态快照，例如生效中、已暂停、已取消或已到期。

搬迁状态说明

状态	含义
搬迁中	合同已搬迁至 SHOPLINE，但客户尚未完成支付方式更新；合同仍可能由原平台继续运行。
搬迁成功	客户已完成支付方式更新，合同已由 SHOPLINE 接管。
无需搬迁	原平台合同已取消、失败或完成，无需继续接管。

可执行操作

对于【待更新支付方式】或【无需搬迁】的合同，您可根据后台能力进行以下操作：

添加折扣码。
筛选并导出合同及客户列表。
向符合条件的客户发送召回邮件。

引导客户完成合同接管

对于尚未完成支付搬迁或支付方式更新的合同，客户需要在客户中心完成支付方式更新，合同才会变为【搬迁成功】。

配置合同迁移通知

在订阅电商的【搬迁中心】 > 【合同迁移通知】中，开启【提示更新通知横幅】。

在客户完成支付方式更新前，建议不要引导客户直接编辑合同；应先说明需要完成支付方式更新，避免客户在搬迁期间产生困惑。

客户操作流程

客户登录店铺客户中心。
进入【我的订阅】。
当客户尝试编辑处于【待更新支付方式】状态的合同，例如修改履约计划或收货地址时，系统提示其更新支付方式。
客户点击【立即更新】，进入合同更新向导。
客户确认或更新下次履约日期、收货地址等信息。
客户绑定新的支付方式。
支付方式更新成功后，系统完成合同接管，合同状态更新为【搬迁成功】。

当客户完成合同接管后，商家会收到相关通知。为避免重复扣款，请及时处理原平台中的对应旧合同。

数据维护与更新

API 自动更新

若您已启用 API 自动化同步，则来自 Recharge, Appstle, Loop, 或 Seal 的合同数据变更（如合同续期、状态变更等）将通过 Webhook 机制准实时地自动同步到 SHOPLINE 的迁移合同列表中。
您无需进行任何手动操作来更新这些【待更新支付方式】合同的快照信息。

CSV 手动更新

若您采用 CSV 导入方案，且【待更新支付方式】合同在原平台发生数据变更，您可以手动更新 SHOPLINE 中的快照信息。
若您仍保留了原平台的合同运行，请及时在原平台同步完成更新。

常见问题 (FAQ)

Q1：为什么我导入的合同都是【待更新支付方式】状态？

这通常是因为合同的原支付方式（如Shopify Payment）目前不受 SHOPLINE 支持，或者合同的支付方式尚未完成迁移。

Q2：如何让【待更新支付方式】合同变为【迁移成功】？

对于所有【待更新支付方式】合同，客户端可主动更新支付方式。

Q3：我需要手动在原平台取消合同吗？

如果您通过 CSV 导入合同，当合同被 SHOPLINE 标记为【迁移成功】后，为避免重复扣款，您必须手动登录原订阅平台，取消对应的旧合同。如果您通过 Recharge, Appstle, Loop, 或 Seal API 导入合同，当合同被 SHOPLINE 标记为【迁移成功】后，会自动调用 Recharge, Appstle, Loop, 或 Seal API 将原平台的旧合同取消。

Q4：在通过 API 同步后，Shopify 或 Legacy 电商系统的订单数据会同步到 SHOPLINE 吗？

目前，API 同步主要更新合同数据。订单数据需要通过多平台店铺一键搬迁插件手动同步。