> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 迁移到 Dodo Payments

> 使用我们的 CLI 工具轻松将您的数据从其他支付提供商迁移到 Dodo Payments

**从其他支付提供商切换到 Dodo Payments？** 我们的迁移工具可以轻松地移动您的**产品、客户、折扣代码和许可证密钥，而不会丢失任何数据。** 该过程安全且有指导，只需几分钟即可完成。

我们目前支持从 **Lemon Squeezy、Stripe、Polar.sh 和 Paddle** 进行迁移。

### 支持的迁移

<CardGroup cols={2}>
  <Card title="Products & Pricing" icon="box">
    迁移所有产品和定价详情。
  </Card>

  <Card title="Customer Data" icon="users">
    转移完整的客户数据库，包括联系信息。
  </Card>

  <Card title="Discount Codes & Promotions" icon="tag">
    无缝移动所有折扣代码和促销优惠。
  </Card>

  <Card title="License Keys" icon="key">
    导入带有客户和产品映射的许可证密钥。支持 Polar.sh 和 Lemon Squeezy。
  </Card>
</CardGroup>

## 开始使用

首先，安装迁移工具：

```bash theme={null}
npm install -g dodo-migrate
```

<Note>
  您需要在电脑上安装 Node.js ≥ 18。
</Note>

## 迁移您的数据

### 如果您来自 Lemon Squeezy：

```bash theme={null}
dodo-migrate lemonsqueezy
```

### 如果您来自 Stripe：

```bash theme={null}
dodo-migrate stripe
```

### 如果您来自 Polar.sh：

```bash theme={null}
dodo-migrate polar
```

### 如果您来自 Paddle：

```bash theme={null}
dodo-migrate paddle
```

该工具将逐步引导您完成所有操作。您需要：

* 您的提供商 API 密钥（Lemon Squeezy、Stripe、Polar.sh、Paddle 等）
* 您的 Dodo Payments API 密钥
* 您是想先进行测试（推荐）还是直接上线
* 要迁移到哪个 Dodo Payments 品牌
* 要迁移的数据（产品、客户、折扣、许可证密钥）

## 为什么使用我们的迁移工具？

* **无数据丢失** - 一切安全转移
* **先测试** - 在上线前先在测试模式下尝试
* **引导过程** - 我们将引导您完成每一步
* **如有需要可恢复** - 如果出现问题，您可以从中断的地方继续

## 高级用法

如果您希望在没有提示的情况下运行迁移，可以提前提供所有详细信息：

### Lemon Squeezy 迁移：

```bash theme={null}
dodo-migrate lemonsqueezy \
  --provider-api-key=lsq_XXXXXXXXXXXXXXXX \
  --dodo-api-key=dp_XXXXXXXXXXXXXXXX \
  --mode=test_mode \
  --dodo-brand-id=brand_XXXXXX
```

### Stripe 迁移：

```bash theme={null}
dodo-migrate stripe \
  --provider-api-key=sk_test_XXXXXXXXXXXXXXXX \
  --dodo-api-key=dp_XXXXXXXXXXXXXXXX \
  --mode=test_mode \
  --dodo-brand-id=brand_XXXXXX \
  --migrate-types=products,coupons
```

### Polar.sh 迁移：

```bash theme={null}
dodo-migrate polar \
  --provider-api-key=polar_org_XXXXXXXXXXXXXXXX \
  --dodo-api-key=dp_XXXXXXXXXXXXXXXX \
  --mode=test_mode \
  --dodo-brand-id=brand_XXXXXX \
  --migrate-types=products,discounts,customers,license_keys
```

### Paddle 迁移：

```bash theme={null}
dodo-migrate paddle \
  --provider-api-key=paddle_XXXXXXXXXXXXXXXX \
  --dodo-api-key=dp_XXXXXXXXXXXXXXXX \
  --mode=test_mode \
  --dodo-brand-id=brand_XXXXXX
```

## 许可证密钥迁移

许可证密钥迁移支持 **Polar.sh** 和 **Lemon Squeezy**。当您在交互提示中选择许可证密钥（或传递 `license_keys` 在 `--migrate-types` 中），该工具会将您现有的许可证密钥导入 Dodo Payments，并具有正确的客户和产品关联。

<Warning>
  许可证密钥迁移需要**产品和客户**在同一会话中迁移。工具在运行期间会生成提供商 ID 到 Dodo ID 的内存映射 — 如果缺少产品或客户，则无法正确链接许可证密钥。
</Warning>

### 迁移的内容

* 许可证密钥字符串
* 激活限制
* 到期日期
* 客户和产品关联

### 未迁移的内容

* **许可证密钥激活** — 客户在迁移后需要在其设备上重新激活
* **已撤销或禁用的密钥** — 仅迁移有效密钥
* 没有匹配产品或客户的密钥将跳过并发出警告

<Tip>
  重复的许可证密钥会得到妥善处理。如果您重新运行迁移，已导入的密钥会被检测并跳过，使得过程安全可重试。
</Tip>

## 需要帮助？

* **工具帮助**: `dodo-migrate --help`
* **Lemon Squeezy 帮助**: `dodo-migrate lemonsqueezy --help`
* **Stripe 帮助**: `dodo-migrate stripe --help`
* **Polar.sh 帮助**: `dodo-migrate polar --help`
* **Paddle 帮助**: `dodo-migrate paddle --help`
* **社区支持**: [Discord](https://discord.gg/bYqAp4ayYh)
* **报告问题**: [GitHub](https://github.com/dodopayments/dodo-migrate)

## 更新工具

```bash theme={null}
# Update to latest version
npm update -g dodo-migrate

# Remove the tool
npm uninstall -g dodo-migrate
```