# 从 Shoprocket v2 迁移

> 我们会把你的 Shoprocket v2 店铺复制到新的 Shoprocket，准备好后点击“切换到 v3”，由你自己完成迁移。你的商品、订单、客户、团队、支付连接和套餐都会一并迁移，网站上的代码继续可用，30 天内还可以切回去。下面介绍迁移哪些内容、有哪些变化，以及需要检查什么。

帮助中心 / 快速入门 - 更新于 2026年11月9日

如果你在上一版 Shoprocket（v2）上销售，我们会把你的店铺复制到新的 Shoprocket，什么时候迁移由你点一下按钮决定。你不需要重建任何东西，也不需要修改网站上的代码。店铺迁移完成后，你和团队中的每个人都会收到一封标题为 **Your store has moved to the new Shoprocket** 的邮件。

想了解 v3 新增了什么，以及你在 v2 用过的每个页面现在在哪里，请阅读[v2 卖家的新功能](https://shoprocket.io/zh/new-shoprocket.md)。

## 登录

为了你的安全，v2 密码不会迁移过来。请先用通知你店铺已迁移的邮件中的链接 (或登录页上的 **忘记密码？**) 设置新密码，然后用你在 v2 上使用的**同一个邮箱**登录。 如果你在设置密码之前尝试登录，我们会立即通过邮件把链接发给你。

从店铺迁移当天起，请在新后台中进行更改。此后收到的订单都会显示在那里。

## 店铺迁移之前

在店铺迁移之前，你可能就能在新后台看到它。在此之前，你的店铺继续在 Shoprocket v2 上运行，每个页面顶部的横条会显示**你的店铺仍在 Shoprocket v2 上运行**。

你的商品、订单、客户、折扣、配送、税费和团队每 15 分钟从 v2 复制一次。你可以在新后台查看它们，但目前仍需在 v2 后台中修改。这些页面会显示**仅查看**，添加或修改的按钮是灰色的。把鼠标移到按钮上，会提示你到 v2 中进行修改，同时告诉你，如果想在这里修改，可以切换到 v3。

![店铺仍在 v2 上运行时的商品页面，顶部有横条，创建商品按钮是灰色的](https://shoprocket.io/img/help/move-from-shoprocket-v2/linked-products.webp)

Shoprocket 中所有新功能你都可以立即设置，例如店铺外观、页面、嵌入、应用和语言。从 v2 复制的过程不会更改这些内容。你的新店铺也会保持在测试模式，所以在顾客仍通过 v2 店铺购物期间，它无法收取真实付款。

### 迁移到 v3

在后台的 **概览** 页面，你会看到一张名为 **迁移到 v3** 的卡片。它分四步带你完成迁移：

1. **在 v3 上预览你的店铺。** 点击你网站上的任意一个页面，它会在新标签页中打开，页面上就是你的新 Shoprocket 店铺。只有你能看到这个预览，里面的任何付款都是测试付款。如果你的店铺有托管店铺，点击 **你的店铺页面** 也可以打开它。如果我们还没有在你的网站上找到你的店铺，卡片会告诉你，你可以在 **嵌入** 中把店铺添加到某个页面。
2. **四处看看。** 你的商品、订单和客户已经在新后台里了。切换之前，请继续在 v2 中修改它们。主题、嵌入和应用可以马上在新后台中设置。
3. **试一笔测试订单。** 点击 **下测试订单**，用测试卡在你的新店铺里买点东西。不会扣真钱，测试订单也不会出现在你的报表里。
4. **切换到 v3。** 满意之后，点击 **切换到 v3**。接下来会发生什么，下一节有说明。

只要你的店铺还在 v2 上运行，你就不会看到 **上线** 按钮。真正让你的店铺在新 Shoprocket 上线的，是点击 **切换到 v3**，支付设置与你在 v2 上的一致。在那之前，你的套餐仍由 v2 计费，所以这里不会出现更换套餐的提示。

## 切换到 v3

准备好后，点击后台顶部横条上的 **切换到 v3**，或者点击 **概览** 中 **迁移到 v3** 卡片里的 **切换到 v3**。这两个按钮作用相同。只有店铺所有者，或可以修改设置的团队成员，才能进行切换。团队里的其他人会在卡片中看到 **请店铺所有者进行切换。**

![点击“切换到 v3”后出现的确认提示，说明接下来会发生什么](https://shoprocket.io/img/help/move-from-shoprocket-v2/switch-confirm.webp)

确认之后，横条会随着进度显示每一个步骤。期间你可以继续工作，整个过程需要几分钟。具体步骤如下：

1. 我们最后一次从 v2 复制你最新的商品、订单和客户。
2. 网站上的 Shoprocket 代码开始显示你的新店铺，你的托管店铺也迁移到新的 Shoprocket，地址保持不变。
3. 你的店铺会带着在 v2 上的支付设置上线。如果你的 v2 店铺原本处于暂停状态，它会继续保持暂停。
4. 你和团队会收到 **Your store has moved to the new Shoprocket** 邮件。

从那时起，你的所有修改都在新后台中进行。v2 中还没来得及迁移过来的订单，会在切换后的一小时、一天和一周再复制一次。

如果某一步无法完成，一切保持原样，你的店铺仍在 v2 上。横条会告诉你发生了什么，通常几分钟后点击 **重试** 就可以。如果横条提示你的店铺页面暂时无法迁移，说明我们的团队已经收到通知，并会联系你。

## 切回 v2

如果你改变主意，切换后的 30 天内可以回到 v2。这段时间里，后台**概览**页面的横条会显示 **切回 v2**，并注明可切回的截止日期。点击并确认后，几分钟内你的网站和托管店铺就会重新在 v2 上运行。

切回之前，请留意两点：

- **商品方面的修改会留在新后台。** 切换之后你在这里对商品所做的修改，不会复制回 v2。商品会像切换之前一样，重新每 15 分钟从 v2 复制一次。
- **在新后台收到的订单会留在新后台。** 你在新后台发货和退款，而且切回之后，“订单”仍是唯一可以继续编辑的页面。

你的店铺外观、页面、嵌入，以及 Shoprocket 中其他新增的内容都会保持原样，等你下次切换时继续使用。

## 随店铺一起迁移的内容

- **你的商品目录**：商品、变体和选项、图片、分类、商品标签页、属性、数字文件和许可证密钥。
- **你的订单和客户**，以及每位客户的订单历史。
- **你的团队**：v2 团队中的每个人都保留访问权限，权限与之前对应。v2 上的管理员可以执行所有操作，编辑者可以执行除团队、账单、支付、API 密钥和域名之外的所有操作，只读成员可以查看。
- **你的支付连接**：你的 Stripe 账户保持连接，PayPal 账户迁移过来时也已关联。两者在 **设置 > 支付** 中都显示 **已可以收款**，无需重新连接。银行转账等手动支付方式也会一起迁移。
- **Authorize.net**：如果你在 v2 上通过 Authorize.net 收取银行卡付款，它迁移过来时处于关闭状态，密钥已清除。请在你的 Authorize.net 账户中创建新密钥，并粘贴到 **设置 > 支付** 中。参见[用 API 密钥连接支付网关](https://shoprocket.io/zh/help/connect-with-api-keys.md)。
- **你的设置**：配送区域和运费、税费、折扣码、自动折扣和促销、货币、相关商品以及 Google 商品 Feed。
- **你的套餐和价格**：你保留正在付费的套餐，价格不变，原有的折扣也保留。

## 你的网站继续工作

每个 v2 网站都通过同一行代码加载 Shoprocket。店铺迁移后，这行代码会开始显示你新的 Shoprocket 店铺，所以你网站上的商品网格、购买按钮和购物车会继续工作，无需你做任何更改。你的 v2 托管店铺也会迁移，地址不变。

你网站上的每段 v2 代码都会成为后台中的一个嵌入。在 **嵌入** 中，它们会显示所在的页面和一个 **旧代码** 标签。它们通过你网站上已有的代码运行，你在后台保存的更改会立即显示在那里。

![嵌入列表，其中一个嵌入标记为旧代码，表示它通过你网站上已有的代码片段运行](https://shoprocket.io/img/help/move-from-shoprocket-v2/old-code-embed.webp)

旧代码自己设置的少数内容，例如它在页面上的框的大小，仍由那段代码决定。嵌入的编辑器会说明是哪些。用 **获取代码** 中的新代码替换旧代码是可选的。请见[在任何网站上嵌入 Shoprocket](https://shoprocket.io/zh/help/embed-on-any-website.md)。

你旧托管店铺的地址也继续有效：它们会重定向到对应的新页面，并在 **设置 > 重定向** 中显示为 **来自你的旧店铺**。请见[将旧链接重定向到新页面](https://shoprocket.io/zh/help/redirects.md)。

## 会变化的地方

- **语言**：你的店铺以其主要语言迁移过来。在新的 Shoprocket 上，开启一种语言会为客户翻译你的整个商品目录，可用的语言数量取决于你的套餐。在 **设置 > 语言** 中开启你需要的语言。请见[翻译你的店铺](https://shoprocket.io/zh/help/translate-your-shop.md)。
- **套餐限额**：如果你的店铺内容超出套餐所含的数量，例如团队成员或币种更多，一切都会继续工作并保持在售。只是在升级之前，你无法再添加更多。请见[套餐限额以及达到限额时会发生什么](https://shoprocket.io/zh/help/plan-limits.md)。
- **v2 上收到的订单的退款**：迁移前收取的付款，需要在支付服务商自己的后台（例如 Stripe 或 PayPal）中退款。当你在 Shoprocket 中为这类订单退款时，退款抽屉会显示 **你需要自己把这笔钱转出**。请从服务商的后台转出，然后点击 **我已转出，记录这笔退款**。请见[为订单退款](https://shoprocket.io/zh/help/refund-an-order.md)。
- **税费**:新版 Shoprocket 只在您有税务登记的地区收税。如果您在 v2 上收过税但从未添加过税号,店铺迁移时我们会为您所在的国家添加一条登记,因此您会继续对该国的订单收税。在美国和加拿大,登记针对您所在的州或省。如果我们无法根据您的 v2 地址判断是哪一个,就不会添加登记,所以切换前请检查 **设置 > 税费**。点击 **切换到 v3** 时,确认窗口会列出 v2 在过去 12 个月里对订单收过税的其他地区。在您于 **设置 > 税费** 中为每个地区添加登记之前,新版 Shoprocket 不会在这些地区收税。请参阅 [设置税费](https://shoprocket.io/zh/help/set-up-tax.md)。
- **后台**：所有东西都换了位置。在任意页面按 **Cmd+K**（Windows 上为 **Ctrl+K**），或点击顶部的 **搜索…**，即可直接跳转到订单、商品、客户或设置页面。请见[搜索后台](https://shoprocket.io/zh/help/search-the-dashboard.md)。

## 面向开发者

如果你或你的开发者针对 Shoprocket v2 编写过脚本，例如页面上的 `window.Shoprocket` 调用、v2 REST API 或 Webhook，请阅读开发者文档中的 [Moving from v2](https://shoprocket.io/docs/moving-from-v2.md)。简而言之：在仍带有旧代码的页面上，v2 的页面函数继续工作；v2 API 密钥仍可读取但不能写入；Webhook 端点会以关闭状态复制过来，并带有新的签名密钥，直到你逐个开启。

## 迁移后需要检查的内容

1. 登录并查看 **商品**、**订单** 和 **客户**。
2. 在 **设置 > 支付** 中，确认你的网关显示 **已可以收款** 且已开启。
3. 访问你网站上显示 Shoprocket 的页面，并使用 **设置 > 支付** 中的 **下测试订单** 下一个测试订单。请见[下测试订单](https://shoprocket.io/zh/help/take-a-test-order.md)。
4. 在 **设置 > 语言** 中开启你需要的其他语言。
5. 如果你在 Google 购物中展示商品，无需在 Google Merchant Center 中做任何更改。你在 v2 上提供给 Google 的数据源地址，现在会发送新 Shoprocket 中的商品、价格和库存。只需确认 **设置 > 数据源** 中的 **启用 Google 数据源** 已开启。如果你也把这个地址添加到了 Meta 目录，它在那里同样继续有效。参见 [Google 购物和商品数据源](https://shoprocket.io/zh/help/google-shopping-and-product-feeds.md)。

## 相关文章

- [设置你的店铺](https://shoprocket.io/zh/help/set-up-your-store.md)
- [在任何网站上嵌入 Shoprocket](https://shoprocket.io/zh/help/embed-on-any-website.md)
- [连接你的 PayPal 账户](https://shoprocket.io/zh/help/connect-paypal.md)
- [套餐限额以及达到限额时会发生什么](https://shoprocket.io/zh/help/plan-limits.md)
- [将旧链接重定向到新页面](https://shoprocket.io/zh/help/redirects.md)

[在后台打开“嵌入”](https://app.shoprocket.io/go/embeds)

---

- HTML version: https://shoprocket.io/zh/help/move-from-shoprocket-v2
- Language: 中文 (zh)
- Also in: [العربية](https://shoprocket.io/ar/help/move-from-shoprocket-v2.md), [Deutsch](https://shoprocket.io/de/hilfe/von-shoprocket-v2-umziehen.md), [Ελληνικά](https://shoprocket.io/el/help/move-from-shoprocket-v2.md), [English](https://shoprocket.io/help/move-from-shoprocket-v2.md), [Español](https://shoprocket.io/es/ayuda/pasar-de-shoprocket-v2.md), [Français](https://shoprocket.io/fr/aide/passer-de-shoprocket-v2.md), [עברית](https://shoprocket.io/he/help/move-from-shoprocket-v2.md), [हिन्दी](https://shoprocket.io/hi/help/move-from-shoprocket-v2.md), [Bahasa Indonesia](https://shoprocket.io/id/bantuan/pindah-dari-shoprocket-v2.md), [Italiano](https://shoprocket.io/it/aiuto/passare-da-shoprocket-v2.md), [日本語](https://shoprocket.io/ja/help/move-from-shoprocket-v2.md), [Lietuvių](https://shoprocket.io/lt/pagalba/perejimas-is-shoprocket-v2.md), [Norsk](https://shoprocket.io/nb/hjelp/flytte-fra-shoprocket-v2.md), [Nederlands](https://shoprocket.io/nl/hulp/overstappen-van-shoprocket-v2.md), [Polski](https://shoprocket.io/pl/pomoc/przenosiny-z-shoprocket-v2.md), [Português](https://shoprocket.io/pt/ajuda/migrar-do-shoprocket-v2.md), [Română](https://shoprocket.io/ro/ajutor/mutarea-de-pe-shoprocket-v2.md), [Русский](https://shoprocket.io/ru/help/move-from-shoprocket-v2.md), [ไทย](https://shoprocket.io/th/help/move-from-shoprocket-v2.md), [Türkçe](https://shoprocket.io/tr/yardim/shoprocket-v2den-tasinma.md)
