> ## 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 的订阅
> 了解如何将您现有的订阅者和支付方式从当前支付处理器迁移到 Dodo Payments。
## 什么是订阅迁移？
订阅迁移将您现有的订阅者从旧的支付处理器转移到 Dodo Payments，为您提供所有客户数据的单一真实来源。如果不进行迁移，您迄今为止获得的客户将保留在旧系统中，只有新客户会在 Dodo Payments 中可见。
迁移过程确保您的客户获得无缝的账单体验——他们无需重新输入支付信息，也不会经历任何订阅中断。
目前我们仅支持**卡令牌**的迁移。由于这些提供商施加的令牌化限制，Apple Pay、Google Pay 及其他钱包支付方式无法在支付处理器之间转移。
## 迁移过程概述
订阅迁移过程由三个关键部分组成：
1. **支付方式转移** — 从您当前的处理器安全转移敏感卡数据
2. **订阅者数据转移** — 导出客户详细信息、订阅计划和账单时间表
3. **导入和验证** — 在 Dodo Payments 中统一支付方式和订阅者数据
要开始订阅迁移，请联系我们的 [支持团队](mailto:support@dodopayments.com)。他们会将您与专属解决方案工程师对接，指导您完成整个流程。
## 要求
在启动迁移之前，请确保您满足以下要求：
Dodo Payments 符合 PCI DSS 第 1 级标准。为满足合规要求，我们只能从另一家符合 PCI DSS 第 1 级标准的支付处理器接收卡数据。
您当前的处理器必须提供：
* 他们当前的 PCI 合规性证明（AOC），或他们在 Visa 全球服务提供商注册表上的列表
* 确认他们支持安全的卡数据导出
查看我们与当前处理器共享的[合规确认书（AOC）](https://pub-2a89184e4c954b599464449d23f506bb.r2.dev/dodo-payments-pci-dss-aoc.pdf)。
在开始迁移之前，请完成 Dodo Payments 的集成，并确保所有新客户都前往 Dodo Payments 结账。这可以防止过渡期间出现数据不一致。
确保您具备向当前处理器请求数据导出的必要授权。通常需要：
* 验证账户所有者身份
* 获得针对敏感数据访问的书面授权
* 完成处理器的安全验证步骤
## 逐步迁移指南
联系您当前支付处理器的支持团队并提交正式请求，要求完整导出客户卡令牌。
您需要：
* 提供身份和授权的验证
* 请求他们使用 Dodo Payments 的 PGP 公钥加密导出（如下所示）
* 请他们将加密文件直接传输到我们的安全 SFTP 服务器
安全传输通过 SFTP 直接由服务器到服务器进行。您的方案工程师会提供 SFTP 凭据，供您与当前处理器共享。
平均而言，该过程大约需要 **2 周**，尽管具体时间取决于当前处理器的政策和响应速度。
在支付方式转移进行期间，请从旧系统导出您的订阅者数据。方案工程师会提供 CSV 模板并指导您填写所需字段。
### 所需的订阅者数据
| 字段 | 描述 |
| ------------------- | ----------------------------- |
| `customer_id` | 您的内部客户标识符 |
| `email` | 客户的电子邮箱地址 |
| `name` | 客户全名 |
| `country` | 两位字母的国家代码（ISO 3166-1 alpha-2） |
| `currency` | 三位字母货币代码（ISO 4217） |
| `payment_amount` | 订阅金额，单位为最小货币单位 |
| `payment_interval` | 账单频率（月度、年度等） |
| `next_billing_date` | 下一个计划账单日期（ISO 8601） |
| `card_token` | 来自您当前处理器的唯一令牌 |
`card_token` 字段至关重要——它用于在导入期间将订阅者记录与其支付方式匹配。请确保其内容与支付方式导出中的令牌完全一致。
### 示例数据格式
```json theme={null}
{
"customers": [
{
"customer_id": "cus_abc123",
"email": "jane.doe@example.com",
"name": "Jane Doe",
"country": "US",
"currency": "USD",
"payment_amount": 2999,
"payment_interval": "monthly",
"next_billing_date": "2025-01-15T00:00:00Z",
"card_token": "tok_xyz789",
"metadata": {
"plan": "pro",
"signup_source": "website"
}
}
]
}
```
在导入日期到来之前，我们的团队将：
* 验证支付方式数据的文件完整性和加密
* 验证您的订阅者 CSV 格式是否正确
* 在我们的沙盒环境中进行测试导入
* 识别并解决任何数据映射问题
您将收到一份验证报告，确认一切已准备就绪，可进行生产导入。
在约定的导入日期，我们的工程团队将：
1. 将支付方式数据导入我们的 PCI 合规卡库
2. 导入您的订阅者数据
3. 使用卡片令牌将订阅者与其支付方式匹配
4. 激活所有迁移的订阅
对于标准迁移，典型处理时间为 **2-3 个工作日**，具体取决于订阅者数量。
导入完成后，您将收到：
* 一份全面的迁移报告
* 一份将您旧的订阅 ID 映射到新的 Dodo Payments ID 的 CSV
* 在您的 Dodo Payments 仪表板中访问所有迁移的客户
我们建议：
* 在仪表板中验证部分迁移的订阅
* 在沙箱模式中测试几个订阅续订
* 使用新 ID 更新内部数据库引用
* 在第一个计费周期期间并行监控
## 可迁移的数据
在订阅迁移过程中可以转移以下数据：
| 数据类型 | 支持 | 备注 |
| ------------- | -- | --------- |
| 信用/借记卡号 | ✅ | 通过 PGP 加密 |
| 卡片到期日期 | ✅ | |
| 持卡人姓名 | ✅ | |
| 账单地址 | ✅ | |
| 客户电子邮件地址 | ✅ | |
| 客户元数据 | ✅ | 自定义键值对 |
| 订阅详细信息 | ✅ | 计划、金额、间隔 |
| Apple Pay 令牌 | ❌ | 无法转移 |
| Google Pay 令牌 | ❌ | 无法转移 |
| 其他钱包令牌 | ❌ | 无法转移 |
| 支付历史 | ❌ | 从您当前处理器导出 |
付款历史和交易记录无法迁移。我们建议在完成迁移之前，先从当前处理器导出这些数据以备存档。
## PGP 加密
为了在传输敏感卡数据时最大限度地提高安全性，所有文件 **必须** 使用我们的 PGP 公钥进行加密。这提供了超越传输级加密的额外保护层。
与您当前的支付处理器共享此密钥以加密卡数据导出：
```
-----BEGIN PGP PUBLIC KEY BLOCK-----
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
1OSDhXaPYtJnVApUzaCrC5PJCXU=
=nHcw
-----END PGP PUBLIC KEY BLOCK-----
```
## 时间预期
| 阶段 | 持续时间 |
| ------- | --------- |
| 初始设置和规划 | 1-2 天 |
| 支付方式转移 | \~2 周 |
| 订阅者数据准备 | 3-5 天（并行） |
| 验证和测试 | 2-3 天 |
| 生产导入 | 2-3 个工作日 |
| 迁移后验证 | 1-2 天 |
整个迁移通常从开始到完成需要 **3-4 周**。在支付方式转移进行期间开始准备订阅者数据，有助于缩短整体时间线。
## 开始
准备将您的订阅迁移到 Dodo Payments 吗？请联系团队以开始该过程：
联系以便启动迁移并与方案工程师建立联系。
探索我们的 API，以了解 Dodo Payments 中的订阅如何运作。