请求导入支付数据

安全地导入敏感的支付数据。

Stripe 支持您在迁移到 Stripe 时保留现有的客户和支付数据。我们将根据需要与您的团队及当前支付服务商协作，以安全完成数据迁移。

此过程允许您在 Stripe 上接受新客户并向其扣款，并继续使用您当前的处理商向现有客户扣款，直到迁移完成。您的客户不会发生宕机。迁移过程完成后，您可以在 Stripe 上处理所有付款。

如果您是非企业级业务（例如初创公司或小型企业），本指南将指导您如何从其他支付处理商或定制支付解决方案迁移到 Stripe。您还将构建可在上线前测试的 Stripe 集成。如果您对迁移流程或与 Stripe 集成有任何疑问，请参阅支持。如果尚未了解，请先查看 Stripe 的定价。

开始前

企业级业务必须在迁移前请求 Stripe 数据迁移团队的支持。
如果您需要迁移敏感的支付信息，则必须在迁移前填写数据迁移请求。我们可以帮助您以安全且 PCI 合规的方式完成此操作。

查看 Stripe 集成功能

Stripe 简化了您的安全要求，以便您的客户无需离开您的网站即可完成付款。这是通过客户端和服务端的组合步骤完成的：

从客户浏览器上打开的您的网站，Stripe 会安全地收集客户的支付信息。
Stripe 会返回一个代表令牌作为响应。
浏览器会将令牌连同其他所有表单数据一起提交到您的服务器。
您的服务器端代码在 API 请求中使用该令牌（例如，创建收费时）。

这种方法可以简化您的网站的结账流程，同时敏感的支付信息永远不会接触到您的服务器。这使您可以按照 PCI 合规法规进行操作，从而节省时间并带来经济效益。

Stripe 的支付流程

与其他支付处理商相比，Stripe 集成在以下方面可能有所不同：

您的客户无需离开您的网站。
创建令牌时不绑定具体产品或金额。
无需按需创建客户端密钥。相反，您使用一组可发布的 API 密钥。

创建 Stripe 账户

在与 Stripe 集成之前，您必须创建 Stripe 账户。

创建账户，需要输入您的电子邮件地址、全名、国家/地区，并设置密码。
填写您的商家资料。
在管理平台中，点击验证您的电子邮箱。Stripe 会向您的电子邮箱地址发送一封验证邮件。
验证您的电子邮箱地址。

构建 Stripe 集成

对于所有新的客户令牌（未导入），请执行以下操作：

使用客户对象保存银行卡信息。
使用我们推荐的支付集成之一收集并令牌化客户的银行卡信息。在要求您的支付处理商将数据传输到 Stripe 之前，先构建您的 Stripe 集成。对于大多数初创公司，我们建议构建嵌入式 Checkout 集成，这是一种可嵌入您网站的支付表单。
要设置此集成，请参阅嵌入式 Checkout 快速入门，并接受一次性付款和订阅付款（如适用）。
为这些新客户创建收费。

使用这种方法，您可以在 Stripe 上接受新客户的付款，而无需在迁移过程中影响现有处理商中的现有客户。

集成注意事项

在让您的支付处理商向 Stripe 传输数据之前设计您的集成是处理导入数据的最有效方式。在请求导入之前，您可以采取的一些操作包括：

重新映射客户记录
保护迁移过程中已保存支付方式的更新。
启用所有优化，如 Adaptive Acceptance、银行卡账户更新器 (CAU) 和网络令牌。

可选将客户映射到 Stripe ID

如您需要，也可将集成配置为将旧记录中的支付方式数据导入到现有 Stripe 客户对象。这样做可避免在迁移过程中，针对我们从您之前的支付处理商接收到的文件中的每个唯一客户 ID，都在您的 Stripe 账户中创建一个新的（可能重复的）客户。

迁移后，在以下情况下，您可能仍需要更新一些记录以与新的 Stripe Customer 标识符对应：

迁移前，您已预先创建了 Stripe 客户。随后我们导入付款信息，用以更新该客户记录。
我们已将付款信息导入为新的客户记录。

例如，客户 jenny.rosen@example.com 数据库中的 ID 可能为 42，在您先前处理商的系统中对应于 ID 1893，但在您的 Stripe 账户中为 cus_12345。在这种情况下，您现在必须将您的 ID 42 映射到数据库中的 Stripe ID cus_12345。Stripe 提供了一个导入后映射文件来帮助您识别所需的重新映射。

可选保护已保存支付方式的更新

如果客户在传输数据和完成导入之间的时间窗口内使用您先前的处理商更新其支付信息，这些更改将丢失。

更新您网站处理已保存支付更新的流程，以防止客户出现错误或计费问题。这包括为任何未存储 Stripe 客户 ID 的客户进行自助迁移的准备工作：

在 Stripe 中为您的客户创建新的 Customer 对象。
将支付方式附加到客户对象。
如有必要，可以迁移订阅。

迁移完成后，Stripe 会自动处理银行卡触发的更新，例如失效日期更改。

测试您的 Stripe 集成

测试您的嵌入式支付表单集成：

创建嵌入式 Checkout Session，并在您的页面上挂载支付表单。
使用下表中的方法填写付款详情。
- 输入任意未来日期作为银行卡到期日。
- 输入任意 3 位数字作为 CVC。
- 输入任意计费邮政编码。
点击支付。您将被重定向到您的 return_url。
转到管理平台，并在交易页面查找支付信息。如果您的支付成功，您将在列表中看到它。
点击您的支付以查看更多详情，例如带有账单信息和购买物品清单的 Checkout 摘要。您可以使用此信息完成订单。

了解有关测试您的集成的更多信息。

卡号	场景	如何测试
	该卡付款成功，不需要验证。	使用信用卡号以及有效期和 CVC 和邮编填写我们的信用卡表单。
	该卡付款时需要验证。	使用信用卡号以及有效期和 CVC 和邮编填写我们的信用卡表单。
	该卡被拒绝，显示拒付代码，例如 `insufficient_funds`。	使用信用卡号以及有效期和 CVC 和邮编填写我们的信用卡表单。
	银联卡的长度为 13-19 位。	使用信用卡号以及有效期和 CVC 和邮编填写我们的信用卡表单。

有关测试您的集成的更多信息，请参阅测试部分。

请求并确认迁移详细信息

在您完成集成并准备好在 Stripe 上处理付款后，向您之前的处理商请求您的支付数据。许多处理商要求账户所有者请求数据转移。
登录您的 Stripe 账户，提交迁移请求表单以请求导入迁移。
通过我们在收到您的迁移请求后创建的经过身份验证的电子邮件线索与 Stripe 联系。

警告

切勿将敏感的信用卡详细信息或客户信息直接发送给 Stripe。如果您有这些数据，请在您的迁移申请表中告诉我们，以便我们帮助您安全地转移您的数据。

Stripe 可以导入您的客户计费地址信息和付款详情。您还可以：

迁移特定支付类型
迁移订阅或通过计费迁移工具包导入。

您先前的处理商可能需要几天到几周的时间才能将最终数据传输到 Stripe。请在您的迁移计划中预留这段过渡时间。在您先前的处理商传输数据后，Stripe 会审核数据并识别导入中的任何问题。我们将与您及您之前的处理商合作纠正任何问题。然后，我们会向您提供一份导入摘要，供您最终审核和批准。

在您批准后，Stripe 会将数据导入您的账户。我们为转移数据文件中的每个唯一客户创建一个 Customer，并以 Card 或 Payment Method 对象创建并绑定客户的银行卡。如果转移的数据指定了客户的默认银行卡，则我们将此卡设置为客户的默认支付方式，用于收款和订阅付款。

如果在迁移时，您的 Stripe 账户已累积了大量客户记录，建议将导入数据映射到现有的 Stripe 客户对象，而非新建客户对象。

Stripe 通常会在收到您之前的服务商发来的正确数据后的 10 个工作日内导入数据，以及您想与我们的团队分享的任何补充数据文件。

更新您的集成

完成导入后，Stripe 会向您发送一个 CSV 或 JSON 文件，显示当前服务商的 ID 与导入的 Stripe 对象 ID 之间的映射关系。解析此映射文件并相应地更新您的数据库。确保您的集成处理了过渡期间发生的任何银行卡更新。

导入后映射文件

用此映射文件更新您的集成后，即可开始在 Stripe 上对您的所有客户收款。

{
  "1893": {
    "cards": {
      "2600": {
        "id": "card_2222222222",
        "fingerprint": "x9yW1WE4nLvl6zjg",
        "last4": "4242",
        "exp_month": 1,
        "exp_year": 2020,
        "brand": "Visa"
      },
      "3520": {
        "id": "card_3333333333",
        "fingerprint": "nZnMWbJBurX3VHIN",
        "last4": "0341",
        "exp_month": 6,
        "exp_year": 2021,
        "brand": "Mastercard"
      }
    },
    "id": "cus_abc123def456"
  }
}

上面的示例 JSON 映射显示：

客户 ID 1893 已作为新的 Stripe 客户导入，对应 ID 为 cus_abc123def456。
客户卡 ID 2600 已作为新的 Stripe 卡导入，对应 ID 为 card_2222222222。
客户银行卡 ID 3520 已作为新的 Stripe 卡导入，对应 ID 为 card_3333333333。

若您在迁移请求中指定，Stripe 也可将卡数据导入为 PaymentMethods 而非卡对象。以下示例展示了不同类型付款信息导入所需的映射文件。

old_customer_id,customer_id,old_card_id,card_id,card_fingerprint,card_last4,card_exp_month,card_exp_year,card_brand
old_cus_100,cus_abc123def456,old_src_100,card_2222222222,x9yW1WE4nLvl6zjg,424242,09,2024,Visa

监控您导入的支付

在迁移后，监控您的支付表现，确保导入的支付数据的接受率符合您的预期。

付款接受率（或发卡行授权率）是发卡行成功授权的交易占提交付款的所有交易的百分比。该指标排除了被阻止的交易（例如由于 Radar 规则造成的交易），因为这些交易从未提交授权。

在使用一般方法和迁移后，请使支付授权优化目标与业务目标保持一致。例如，单位成本较低的数字商品业务可以将其风险级别设置为阻止较少的付款。考虑可能的影响：

由于阻力更小，转化率更高。
由于付款风险较高，欺诈风险会增加。
由于发卡行阻止欺诈模型，原始发卡行授权率较低。

确保您提供准确的数据（例如持卡人姓名、计费地址和电子邮箱）。反映持卡人的意图可最大程度地提高授权成功率。

识别存档的银行卡

支付数据迁移涉及 file_（为同一客户的未来商家发起或会话外付款而保存的银行卡）上的 _cards。请务必存储导入的支付数据，并用正确的 off_session 参数标记这些存档的卡付款。如果您错误地识别存档的银行卡：

如果发卡行无法确认持卡人是否同意未来付款或经常性付款，可能会拒绝。
支付数据可能不符合某些 Stripe 优化产品的条件，例如银行卡账户更新器 (CAU) 和卡组织令牌 (NT)。

监控优化机会的拒绝原因

在迁移后，您的发卡行拒绝原因可以帮助您确定迁移后的支付数据是否正常交易。某些类型的拒付激增可能受益于以下优化产品：

银行卡账户更新：Stripe 与银行卡网络保持合作，能够实时或在后台自动获取过期银行卡或已更换银行卡的更新信息。
自动重试（催款）：请谨慎操作，因为多次重试（例如在迁移后）对发卡行来说可能是可疑行为。如果您使用 Stripe 的 Smart Retries 功能，我们的 AI 模型会分析拒付代码、支付方式更新和银行风险阈值活动，以更具战略性地重试经常性收入付款。
卡组织令牌：用来自卡组织的安全令牌替换特定支付账号 (PAN)，以确保 PAN 更新（如更新或更换）自动反映在令牌中。
自适应接受率：Stripe 使用 AI 实时评估对授权请求进行细微调整（如格式化）的效果，然后优化付款重试，最后将原始拒付结果返回给客户。
客户拓展：要求您的客户登录并重新输入或重新验证其支付信息，通常可以重新建立您在客户和支付提供商心目中的信任关系。考虑通过电子邮件以外的渠道通知客户，例如短信或应用内通知。

下表显示了哪些优化产品针对各种拒付原因提供的改进。

拒付代码可能包括	迁移效果	允许的操作	不允许的操作
`incorrect_number` `invalid_number` `expired_card`	在自然迁移滞后期间更新银行卡数据可能会导致保存的银行卡数据过期。	银行卡账户更新器卡组织令牌自适应接受率联系客户	重试
`generic_decline` `do_not_honor`	更改您的对账单描述符或其他标识标记可能会触发发卡行的风险模型，或使您的客户感到困惑。	重试卡组织令牌自适应接受率联系客户	银行卡账户更新器
`transaction_not_allowed` `try_again_later` `authentication_required` `incorrect_cvc`	某些迁移的支付数据可能缺少初始银行卡验证信息，如卡组织令牌或原始交易 ID。	银行卡账户更新器重试自适应接受率联系客户	卡组织令牌
`lost_card` `stolen_card` `invalid_account` `pickup_card` `card_not_supported`	在迁移滞后期间，客户可能会报告卡丢失或被盗。请留意与这些拒付相关的特殊 CONTAC 事件。	卡组织令牌联系客户	CAU 重试¹ 自适应接受率

¹ 发卡行可能会对重试丢失或被盗的支付数据感到可疑。

可选迁移订阅

涉及订阅的迁移通常包括以下阶段：

设置您的 Billing 集成。
迁移您的客户和支付处理商信息。
将您的订阅导入到 Stripe Billing。
您可以使用 Subscriptions API 或管理平台中的计费迁移工具包导入现有订阅。
离开您的支付服务商后，确认他们取消了您客户的所有自动账单。

迁移 PGP 密钥

如果您不熟悉 PGP，请参阅 GPG 并从导入公钥开始。熟悉 PGP 基础知识后，使用以下 PGP 密钥加密敏感数据（如信用卡信息）以进行符合 PCI 的迁移。

PGP 迁移密钥

这将创建包含以下信息的 FILENAME.gpg：

Key ID: 9C78B7620C1E99AD
Key type: RSA
Key size: 4096 bits
Fingerprint: AEBF 7C48 38C4 4D2F DC99 A3F9 9C78 B762 0C1E 99AD
User ID: Stripe Import Key (PCI) <support-migrations@stripe.com>

导入我们的密钥后，可以通过在命令行提示符下运行以下命令来加密要发送的文件：

gpg --encrypt --recipient 9C78B7620C1E99AD FILENAME

有关向 Stripe 提供加密数据的更多详细信息，请参阅上传补充数据。