Translation disclaimer

Documentation is written in English and subsequently translated. This page, therefore, might not have the most up-to-date content. If any questions arise relating to the accuracy of the translated content, please refer to the English version of the page.

Menu

开始使用账户更新器

注释:让自己熟悉我们的API 原则最佳实践,以确保有弹性的集成。

工作流程

我们建议您在您想向客户收费日期前至少提前 6 天开始账户更新器流程,因为完成该流程可能需要几天时间。步骤包括:

  1. 向 Worldpay 提交请求,其中包含您需要验证的客户账户信息。
  2. 我们利用包含以下信息的确认消息来进行回应:
    • Approved - 表示数据有效
    • Invalid Credit Card Number - 表示卡数据无效
    • Invalid Expiration Date - 表示日期无效
  3. 更正并重新提交任何无效数据。
  4. 我们将所有已批准的数据转发给网络。
  5. 在收集数据 4-5 天之后,我们会创建一个包含更新后账户信息的完成响应文件。登录您的 FTP 账户可找到响应文件。
  6. 审阅完成响应文件,然后使用该数据来更新您的客户数据。

有关更多详情,请参见以下示意图:

账户更新器工作流程

account_updater_activity_flow_worldpay

要求

卡网络要求

为了使用账户更新器,我们会完成并提交您的以下会员申请:

  • Mastercard 自动开单更新器
  • Visa 账户更新器

获得 Visa 和 Mastercard 的批准需要 10-15 个工作日。请咨询您的实施经理以确保完成注册。

Worldpay 获得的 Discover 商户不需要会员资格。

注释:Visa 不允许拥有以下 MCC 号码的商户参与其服务:5962、5966 或 5967。

技术要求

使用账户更新器的技术要求如下:

  • 数据格式:XML(Worldpay cnpAPI 格式)
  • 数据处理:批次处理
  • 通讯协议:
    • 使用 PGP 或 GPG 密钥加密的 FTP (建议)
    • sFTP

如果您使用的标准 FTP 方法,则必须使用 Pretty Good Privacy (PGP) 或开源 GNU Privacy Guard (GPG) 加密。替代方法 Secure FTP (sFTP) 会使用 Secure Shell (SSH) 来保障传输。

最佳实践

在使用 Worldpay 账户更新器功能时,我们建议遵循以下最佳实践:

  • 在重复性交易提交授权/存款的正常截止日期之前至少提前 6 天发送账户更新器请求
  • 在 UTC 时间晚上 10:00 前发送账户更新器提交,否则 Worldpay 将在下一个工作日予以处理

推荐的会话文件大小

批次:单个商户的一组数据

会话:可包含多个批次的单个 cnpRequest

注释:在会话(cnpAPI 批次)中,父元素或根元素是 cnpRequest 元素。

您通常以单个文件发送,其中每个商户一个批次。当更改的总数较少时,这种方法很有效,但您在每个会话或批次中提交的更改数量可能会有所不同。记住以下建议:

  • 一个批次不应超过 20,000 项更改。如果单个商户的更改数量超过 20,000,则您应该为同一商户创建多个批次。
  • 批次不应该只包含一个交易,除非您的组织当天只有一次交易。
  • 会话文件不得包含超过 9999 个批次。
  • 会话文件在所有批次中不得包含超过 1,000,000 个更改。
  • 务必在提交时间和会话处理的交割时间之间留出足够的时间。较大的文件需要更长时间来处理。

后续步骤

测试账户更新器