如何迁移到 WooCommerce Subscriptions 并保持自动续费正常
Migrate to WooCommerce Subscriptions without breaking billing
WooCommerce 官方指南提出手动录入、CSV 批量导入和自定义脚本 3 种订阅迁移方式，分别适合少于 100 个订阅、大量订阅及复杂计费场景。支付方式迁移需要处理网关专属数据与支付令牌，现有 PayPal Standard 订阅无法直接导入，可能需手动重新绑定或让客户更新付款信息。
成功的订阅平台迁移应当做到续订、履约和账单处理从不中断，而且你的客户甚至不会察觉发生过任何变化。
只要规划得当，平稳过渡完全可以实现。对于 WooCommerce Subscriptions，关键在于选择合适的迁移方式，并在正式上线前核查各项细节。
将订阅者迁移至 WooCommerce Subscriptions 主要有 3 种方式：
- 手动录入订阅者。
- 使用 CSV 文件导入订阅者数据。
- 构建自定义迁移流程。
订阅者数量固然重要，但更重要的是你现有的订阅数据能否顺利适配新系统。
| 路径 | 适用情形 | 操作方式 |
| 手动迁移订阅者 | 适用于订阅者少于 100 人的运营场景。这种方式需要投入更多人工操作，但在订阅者规模较小时，可能比准备并验证导入文件更简单。 | Add each of your subscriptions manually via the Add Subscriptions screen in your dashboard. 你可以将每位订阅者关联到正确的客户、产品、账单周期和支付方式。 |
| 批量 CSV 导入 | 适用于拥有数百或 数千份订阅的场景。当源数据格式一致，并且可以迁移所需的支付网关信息时，这种方式效果最佳。 | Via the WooCommerce importer extension (which is currently in public beta). You can learn more, download, and test the extension via the Subscriptions CSV Importer GitHub Repository. 使用导入工具的测试模式（Test Mode）在创建订阅前验证每一行数据，以便先修正映射错误和警告。 |
| 自定义迁移脚本 | 如果迁移订阅者需要特殊的数据或账单处理方式，就应使用自定义脚本。 当标准导入工具因迁移过程复杂而无法妥善处理时，自定义代码是最佳选择，例如需要迁移特定记录，或使用非标准支付网关时。 | The Subscriptions developer API gives custom migration script functions for creating those subscriptions and setting the renewal data for each one. Instead of forcing unusual source data into a CSV template, the script translates each record into the right WooCommerce subscription as the tool imports it. WooCommerce 会将每份订阅存储为一个 WC_Subscription 对象。它是标准 WooCommerce 订单对象的扩展，额外包含账单周期、下次付款日期等信息。 |
迁移订阅和迁移其已保存的支付方式是两个不同的问题。你可以顺利导入客户、产品、账单周期和下次续订日期，但仍需做一些额外工作来设置订阅续订。
这是因为支付处理商不会把客户的卡号交给 WooCommerce。它们会安全地存储银行卡，并提供指向已存卡片的支付令牌。WooCommerce Subscriptions 需要正确的支付令牌，以及其他特定于网关的支付数据，才能告知支付处理商应从哪个已保存的支付方式中扣款。
更换支付网关后，这些数据引用点不会自动跟随订阅迁移至新的支付设置。在某些情况下，你需要手动更新支付令牌，或请订阅者更新其支付方式。这在很大程度上取决于你所使用的支付网关。
不同支付网关的迁移路径示例
Stripe 是一个清晰映射支付网关的良好示例。WooCommerce Subscriptions 使用 Stripe Customer ID 和 Payment Method ID，将订阅关联到 Stripe 已存储的银行卡。
如果你的旧系统已经以兼容格式存储这些 ID，可以将它们关联到迁移后的订阅。如果存储格式不同，则需要转换这些数据，或请客户更新其支付信息。
PayPal 需要多做一些工作。你无法将现有的 PayPal Standard 订阅导入 WooCommerce Subscriptions。PayPal Standard 依赖于与原站点绑定的支付通知，而 PayPal 并不会可靠地让这种关联随订阅一起迁移。
这意味着，你要么需要预留时间手动将每项订阅重新关联到其付款方式，要么提示订阅者自行从 我的账户 → 订阅更新付款方式。
成功导入并不代表你已经可以让续订功能上线。在正式上线前，你需要先回答几个重要问题：
- 旧系统是否已停止向客户扣款？
- 导入的订阅是否指向正确的产品？
- 下一次付款是否安排在正确的日期？
确保只有一个系统能够收取下一笔续订款
将订阅迁移到 WooCommerce Subscriptions，并不一定会让你的旧平台停止扣款——你肯定不希望客户被重复收费。如何关闭续订取决于所使用的系统，因此请核实相关流程，并将其加入检查清单。
确认订阅已关联到正确的产品
在 CSV 导入器中，每项订阅的行项目都必须指向新商店中实际存在的产品。如果旧系统中的产品 ID 未匹配到 WooCommerce 中的正确产品，它们就毫无用处。
导入前先映射产品数据，导入后再抽查。一个虽然按时续订、却交付了错误产品的订阅会让客户感到沮丧。
检查下一付款日期
WooCommerce Subscriptions 需要知道客户付款的频率（每周、每月、每年），以及每位客户下一次付款的时间。CSV 导入器接受明确的 next_payment_date。
如果未提供该日期，WooCommerce 可以根据订阅的开始日期或试用日期以及计费周期计算日期。对于已有订阅群体，请将导入后的下一付款日期与源系统进行比较，确保客户继续按照他们原本预期的计划付款。
确认你的正式商店正在收款
WooCommerce Subscriptions 提供了一种 Staging Mode（暂存模式），可在重复站点中禁用自动付款。
上线前，请检查 WooCommerce → 状态，确认生产商店处于 Live Mode（正式模式），并且任何测试副本都处于 Staging Mode（暂存模式）。
不要仅凭 URL 中出现的“staging”一词来判断。WooCommerce Subscriptions 会根据多种因素确定 URL，因此务必再次核对。
抽查迁移结果
最后一步是选择产品、计费周期、状态和付款方式各不相同的订阅，将导入后的记录与源记录进行比较。
目标不只是确认 2,000 行数据变成了 2,000 项订阅。抽查足够多的订阅，以核实产品 ID、付款方式、状态和下一续订日期等详细信息。
付款信息在迁移过程中能够完整保留的订阅者无需采取任何行动。你的沟通重点应放在需要采取行动的客户身上。
例如，如果 PayPal Standard 等已保存的付款方式无法迁移过来，请在这些订阅者的下一笔续订款到期前，另行给他们发送一封电子邮件。
借助 Import Export Suite 之类的工具，你可以将订阅导出为 .CSV 文件，按付款方式进行筛选，然后将文件上传到你的电子邮件营销工具中，以批量发送邮件。
说明发生了哪些变化、客户需要做什么，以及需要在什么时候完成。
下面是一封电子邮件模板，你可以根据实际情况进行调整：
Subject: Please update the payment method for your [Brand] subscription
We’ve moved to a new subscription management system to better serve our customers.
Your subscription is still active, but we weren’t able to carry over the saved payment method used for automatic renewals.
Please update your payment method before your next renewal on [date] to continue receiving expected orders:
[Button/link: Update payment method]
Your products, pricing, and renewal schedule haven’t changed.
Questions? Reply to this email and we’ll help.迁移上线后，观察第一批到达续订日期的订阅，确认没有向客户重复收费。
确保每位订阅者都由正确的系统在正确的日期收取一次费用。你还可以确认每次续订都会生成预期的订单，并使订阅保持正确状态。
续订失败并不一定意味着迁移失败。银行卡会过期，银行每天也会拒绝付款。但如果失败集中在已迁移的订阅者或某一种付款方式周围，这就是需要深入排查的信号。
如果发现异常，请从一份受影响的订阅开始，检查相关订单备注。然后查看 WooCommerce → Status → Scheduled Actions，寻找失败或卡住的续订操作。
WooCommerce 还会在 WooCommerce → Status → Logs 下保存网关和计划操作日志，这有助于确定问题发生在扣款之前、支付网关处还是之后。
迁移成功最明显的标志，就是没有客户抱怨。迁移得当，就能避免有关重复扣款的支持工单、沮丧的邮件，以及向客户解释其续订出了什么问题的手忙脚乱。
迁移完成后，WooCommerce Subscriptions 会接管日常工作。它会自动续订，内置付款失败自动重试系统，支持通过 25+ 个兼容网关进行循环付款，并允许客户自助更新付款信息。
迁移需要谨慎处理和悉心关注，但回报是一套更易于管理的订阅运营，以及更少关注到背后运行机制的客户。
第一步是什么？确定最适合你的订阅用户群、支付网关和数据结构的迁移路径。
关于
shanibanerjee
Shani 是 WooCommerce 的开发者倡导者。你可以在 WooCommerce Community Slack 和 Woo Developer Blog 上找到她，了解 WooCommerce 的最新动态！
来源：WooCommerce 官方博客 · https://woocommerce.com/posts/migrating-to-woocommerce-subscriptions/
部分链接为推广/关联链接。