使用 Hyperswitch 对账模块快速入门指南

本指南将详细介绍如何使用 Hyperswitch 对账模块，包括功能概览和操作步骤，帮助你轻松完成高效的自动化对账流程。

✅ 使用对账模块的 5 个步骤

  1. 上传与准备文件
  2. 运行对账引擎
  3. 查看对账报告
  4. 对账数据分析
  5. 对账后的处理

1️⃣ 上传与准备文件

在 Hyperswitch 对账流程中，文件管理是数据集成的核心。整个文件准备阶段通常在 30 秒内完成。它分为 3 个步骤：

上传 → 验证 → 转换

📤 1.1 上传文件

首先，将数据文件上传到对账模块。Hyperswitch 提供两种上传方式：

✅ 手动上传

  • 直接在对账仪表盘中手动上传文件。
  • 文件命名格式：PGName_yyyymmdd/ MERCHANTNAME_yyyymmdd/ BANK_NAME_yyyymmdd。

✅ 自动上传

  • 配置自动上传功能后，系统会定期自动导入 PSP 和银行报表，无需手动干预。
  • 支持以下两种自动上传方式：
    • 通过 API 上传：如果 PSP 和银行支持 API，Hyperswitch 可通过 API 拉取报告。需要在激活阶段配置 API 端点、密钥和调度时间。
    • 通过商户 SFTP 上传：Hyperswitch 通过 SFTP 定期拉取文件。商户需提供：
      • SFTP 用户 ID
      • SFTP 密码
      • SFTP 路径和拉取调度时间

✅ 常见错误

  • 文件命名错误：文件命名不符合规范。
  • 文件格式无效：仅支持 CSV、Excel 和 XML 格式。

🔎 1.2 文件验证

上传后，系统会对数据文件进行验证，以确保数据的完整性和准确性：

  • ✅ 字段验证：检查文件中是否包含所有必需字段。
  • ✅ 数据类型校验：确保数据类型符合预期格式。
  • ✅ 重复值检测：自动识别并移除重复记录。
  • ✅ 日期格式验证：确保日期格式一致且正确。
  • ✅ 自定义校验规则：根据商户需求增加自定义验证条件。

🔴 验证失败：

  • 不符合格式规范的记录将被标记并排除，防止影响对账准确性。
  • 例如，报告中缺少配置时的必填字段或日期格式错误。

🔧 1.3 文件转换

在验证通过后，系统会对数据进行转换和计算：

  • ✅ 结算金额计算：根据交易金额和状态计算结算金额。
  • ✅ 手续费和税金计算：
    • 若 PSP 报告未包含手续费和税金，商户可在配置阶段设置默认值。
    • 系统将根据配置自动计算结算金额。

🟡 状态指示：

  • 🟡 黄色：正在执行。
  • 🟢 绿色：成功执行。
  • 🔴 红色：存在错误。
  • 🟠 半红色：部分记录无效，被排除。

2️⃣ 运行对账引擎

在文件上传和准备完成后，启动对账引擎。对于自动化对账，此步骤会自动进行。

✅ 对账引擎包括以下 4 个部分：

  1. 日期选择：选择需要对账的日期范围。
  2. 文件选择：选择参与对账的文件（自动对账无需此步骤）。
  3. 对账状态：绿色表示对账成功，红色表示存在问题。
  4. 引擎能力：自动处理并生成对账结果。

✅ 常见问题

  • 如果在此阶段遇到错误，请联系 Hyperswitch 技术支持。

3️⃣ 查看对账报告

对账完成后，报告会在 Reports（报告） 模块中生成，主要包含以下 3 个部分：

📅 3.1 日期选择

  • 根据时间范围筛选对账结果。
  • 对账引擎支持回溯对账，可对过去 90 天内的数据进行核对（可按商户需求调整）。

📊 3.2 对账报告

报告模块提供以下类型：

  • ✅ 整体交易报告：显示所有交易的对账结果。
  • ✅ 商户交易报告：仅显示商户维度的对账情况。
  • ✅ PSP 结算报告：展示 PSP 的结算情况。
  • ✅ 银行结算报告：显示银行维度的结算结果。

🔍 3.3 对账输出表

对账表格提供详细信息，包括：

  • 网关信息
  • 状态与子状态
  • 差异详情

✅ 可自定义列视图：

  • 自定义列名和顺序（需 Hyperswitch 团队协助配置）。
  • 下载报告为 Excel 文件。

✅ 关键字段解释

  • Recon Status（对账状态）：
    • Matched：完全匹配。
    • Mismatch：存在差异，例如金额、税金或币种不一致。
    • Missing：至少有一方缺失交易记录。
  • Confidence Score（置信度）：
    • 对潜在匹配项赋予置信度分数，便于识别可能的匹配项。

4️⃣ 对账数据分析

对账仪表盘提供丰富的统计和图表分析功能：

✅ 4.1 用户自定义筛选

  • 按日期、PSP、结算币种筛选数据。

✅ 4.2 数据统计

  • Matched（匹配）：成功匹配的交易数量与金额。
  • Matched Buffer（缓冲匹配）：在缓冲范围内的匹配项。
  • Mismatched（不匹配）：存在数据差异的交易数量与金额。
  • Not Found（缺失）：至少在一个系统中缺失的交易数量与金额。

✅ 4.3 图表分析

  • 条形图展示日期范围内的交易数量。

✅ 4.4 数据汇总表

  • 显示上期结余、预期金额、实际收款和应收余额。

5️⃣ 对账后的处理

对账引擎运行后，部分记录可能存在 不匹配或缺失：

✅ 缺失交易处理

  • 不同系统的报告生成时间可能存在差异，导致缺失记录。
  • 引擎会自动回溯过去 90 天的数据，确保历史数据一致性。

✅ 人工干预

  • 无法自动匹配的记录需与 PSP、银行或 Hyperswitch 团队核对。
  • Hyperswitch 将引入问题跟踪功能，帮助商户在对账模块内处理未解决的问题。

🎯 小结

Hyperswitch 对账模块通过自动化流程，大幅提升对账效率和准确性：

✅ 自动化对账，效率提升 60%
✅ 99% 对账准确率，自动解决 80% 异常
✅ 回溯对账，确保历史数据一致性
✅ 图表分析与自定义报告，轻松掌握财务状况