SuperAPI AI 工具集

polar-migration

部署与运维

查看项目

更新于 10-19 23:42

技能介绍

Polar Migration Guide 是一份面向开发者的支付平台迁移指南,目标是在尽量减少对客户和收入影响的前提下,把业务迁移到 Polar。

用途与迁移范围 该技能用于规划和执行从 Stripe Billing、Paddle、Lemon Squeezy、Gumroad 等平台到 Polar 的迁移。资料明确了各类数据的迁移方式:客户邮箱/姓名可通过 API 导入;产品目录需要手动重建;活跃订阅需要创建新的订阅;支付方式必须由客户重新录入,因为支付方式令牌因 PCI 合规要求无法在处理商之间转移;历史订单不迁移,保留在旧系统;许可证密钥需要重新生成。

迁移策略 文档提供三种策略:1)硬切换:取消旧系统全部订阅,在 Polar 创建新订阅,适合客户基数小、产品简单的场景;2)渐进迁移:两套系统并行,客户在续费时迁移,适合客户基数大、希望降低风险的场景;3)仅新客户:老客户留在旧系统,新客户使用 Polar,适合全面投入前先测试 Polar。

使用方式 文档给出基于 @polar-sh/sdk 的示例流程:先在沙箱环境(https://sandbox.polar.sh)安装 SDK(npm install @polar-sh/sdk),创建与原目录对应的产品和订阅价格,创建许可证等权益并附到产品上;随后配置 Webhook,使用 validateEvent 对请求体与 webhook-id、webhook-timestamp、webhook-signature 进行验签,并处理 order.paid、subscription.canceled 等事件。针对不同平台,文档给出导出 Stripe 活跃订阅客户、导出 Paddle 订阅用户、导出 Lemon Squeezy 订阅的代码片段,并说明通过 externalId 关联旧平台客户 ID、创建 checkout 让客户重新录入支付方式,以及在迁移完成后将旧订阅设置为期末取消。

客户沟通与并行运行 文档提供迁移邮件模板,说明价格、功能与账单日期不变,并要求客户在截止日期前更新支付方式;提醒序列按截止前 14、7、3、1 天发送。并行阶段可用路由模式按客户是否已有 Polar 客户 ID 判断由哪套系统处理订阅状态,并统一归一化两套系统的 Webhook 事件。

迁移后与限制 迁移后需校验 Polar 订阅存在、旧订阅已取消,再取消旧系统剩余订阅并清理代码与归档数据。文档附有迁移前、中、后的检查清单和常见问题排查(邮件未收到、旧订阅未取消、重复扣费、客户不愿迁移等)。具体功能、收费、价格、平台覆盖与效果以实际产品为准,资料未提供部分暂未说明。