Alipay, China's leading third-party online payment solutionAlipay, China's leading third-party online payment solution

资产信息迁移指南

为了保障您的资产信息数据安全，APO 提供以下服务：

  • PAN 数据导入：您可以从其​他收单机构获取现有的资产信息，并将其导入到您的 APO 账户中。我们会与您当前的收单机构展开合作，以便安全迁移您的资产信息数据。此时您可以继续向用户收费，不会发生中断服务或者要求用户再次提供支付详细信息的情况。
  • PAN 数据导出：APO 可以将您的资产信息安全迁移到新的收单机构。此时会导出一份包含您的用户卡详情信息、APO token 等数据的加密 CSV 文件，新收单机构使用此文件将数据导入到系统中进行安全传输。您可以联系 Antom 技术支持并提供新收单机构的名称来开始数据迁出流程。

数据导入流程

将资产信息迁入到 APO 通常涉及以下步骤：

  1. 事前准备
  2. 导出申请
  3. 加密资产文件
  4. 传输资产文件

事前准备

  • 初始化 GnuPG，或者选择其它可以进行 Pretty Good Privacy (PGP) 加密或解密的工具。
  • 使用 PGP 公钥来加密敏感数据（如信用卡信息），以进行符合 PCI 的迁移。请参阅 GnuPG 文档了解更多信息，如果您有任何疑问，请联系 Antom 技术支持。

导出申请

向您当前所在的收单机构申请将资产信息导出，以便 APO 进行资产数据导入。

加密资产文件

为确保以安全的方式接收资产信息，需要现有的收单机构（资产数据导出方）通过指定的 PGP 公钥加密资产文件。您可以通过下载以下公钥文件对资产文件进行加密。

📎pop_migrate_security_key_public.asc

也可以复制下面的公钥代码进行加密。

copy
-----BEGIN PGP PUBLIC KEY BLOCK-----

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
/SgS5px0qFtVlpFM8vKatIgTCLHwZhW0qi73Tw==
=nlgQ
-----END PGP PUBLIC KEY BLOCK-----

通过下列命令将公钥导入到您的 Keychain 中。

copy
gpg --import <path>/pop_migrate_security_key_public.asc

【注意】<path> 为文件路径。

公钥信息如下：

  • 名称: APO Migrate Security Key
  • 创建时间: 2024-05-23
  • 到期时间: 2029-05-22
  • 密钥 ID: 7CBC0ACA531C1183
  • 卡指纹: C543 6A3C 5CCD 8D8F 5D32 9113 7CBC 0ACA 531C 1183
  • 密钥长度: 4096 bits
  • 算法: RSA

导入公钥后，运行下面的命令对文件进行加密。

copy
gpg --encrypt --recipient 7CBC0ACA531C1183 <FILENAME>

【注意】<FILENAME> 为资产文件名，执行命令后会生成加密后的 <FILENAME>.gpg 文件。

传输资产文件

建议通过 SFTP（安全文件传输协议）传输资产文件。资产数据导出方将文件上传到指定的服务器后，APO 会对上传的资产文件进行解密并将资产信息上传到 APO 产品中。

数据导出准备

当导出资产信息时，APO 需要您提供以下信息：

  • 提供一份正式邮件，邮件中需要包含以下内容：
    • 将资产信息迁出的原因。
    • 您的公司名称、公司 Logo、落款签名以及日期。
  • 新的收单机构名称，以及该收单机构的有效 PCI 合规证明。
  • 提供 PGP 公钥以进行资产文件加密，该公钥必须由通过拥有 PCI 合规证明的新收单机构的网站上展示提供。

数据格式

解密后的CSV文件格式如下：

字段名

描述

paymentMethodId

APO 卡令牌（格式为“ALIPAYXXXXX”）

cardNo

PAN 或者信用卡号

expiryMonth

卡到期的月份

expiryYear

卡到期的年份

cardholderName

持卡人姓名

billingAddress.region

与持卡人的卡帐户关联的国家或地区

billingAddress.state

与持卡人的卡帐户关联的州或省份

billingAddress.city

与持卡人的卡帐户关联的城市

billingAddress.address1

与持卡人的卡帐户关联的地址行1

billingAddress.address2

与持卡人的卡帐户关联的地址行2

billingAddress.zipCode

与持卡人的卡帐户关联的邮政编码

代码示例如下：

copy
paymentMethodId,cardNo,expiryMonth,expiryYear,cardholderName,billingAddress.region,billingAddress.state,billingAddress.city,billingAddress.address1,billingAddress.address2,billingAddress.zipCode,,,
ALIPAY/testToken1,428743ABC2318615,05,25,Tom,US,CA,Houston,anyAddress1,anyAddress2,90210,,,
ALIPAY/testToken2,428743ABC2318616,05,25,Tom,US,CA,Houston,anyAddress1,anyAddress2,90211,,,
ALIPAY/testToken3,428743ABC2318617,05,25,Tom,US,CA,Houston,anyAddress1,anyAddress2,90211,,,
ALIPAY/testToken4,428743ABC2318618,05,25,Tom,US,CA,Houston,anyAddress1,anyAddress2,90212,,,