Search...
Menu

自动结算问题排查

背景知识:什么是自动结算 (Auto Batch)?

自动结算,或者称为自动批处理,是指POS系统或支付终端在预设的特定时间,自动将当天所有已授权但尚未结算(captured)的交易进行结算。结算完成后,这些交易的资金才会最终转入商户的银行账户。如果自动结算不工作,交易将保持未结算状态,商户将无法收到这些资金。手动批处理是一种替代方法,可以在需要时手动触发结算过程。

需要注意的是,批处理通常是按支付终端进行的。这意味着如果一个商户使用多个支付终端,可能需要分别对每个终端进行批处理。然而,也有讨论提到希望实现一个中心化的批量处理功能,这个将在后面的版本支持。

另一个重要的背景是,在使用我们的系统时,推荐在POS系统中配置自动结算,而不是直接在PAX终端的BroadPOS应用中设置。如果在PAX终端设置了自动批处理,它可能会在我们系统的批处理尝试之前就完成结算,导致POS系统在尝试捕获/结算时找不到交易,从而显示错误并认为批量失败,尽管资金可能已经被PAX结算了。这会造成POS系统的报告与实际结算情况不符。

自动结算不生效的常见原因:

根据资料和对话,自动结算不生效的原因可能包括:

  • 设备或应用未运行: 在预设的结算时间,POS设备或PAX支付终端没有开机,或者POS应用和PAX支付应用没有在运行状态(例如:应用被关闭或崩溃,或者PAX应用没有在前台运行)。我们曾发现商户将POS应用停留在“开放订单”界面而不是锁屏界面,导致自动结算失败。
  • 连接问题: POS设备与PAX终端之间的网络连接不稳定或断开。
  • 配置错误: 自动批处理被错误地配置在了PAX终端上,而不是在我们系统的POS应用中。
  • 版本过旧: 使用的POS应用或PAX应用版本不是最新的,可能存在已知问题。
  • 交易状态问题: 例如,由于PAX终端先于POS系统完成批处理,导致POS系统尝试捕获时找不到交易 ("transaction not found")。
  • 网关或处理器问题: 支付网关拒绝批量处理 ("Decline" 错误),或者与特定网关的集成存在问题(例如:TSYS的stage capture vs hosted capture)。
  • 其他未知错误或系统问题: 对话中提到,有时即使满足所有条件,自动结算仍然无法触发,或者出现一些未知的错误导致失败。系统可能正在进行服务器迁移或其他更新,这有时会影响稳定性。
  • 交易过旧: 放置时间过长的交易可能无法成功批处理。

自动结算不生效的排查步骤:

当遇到自动结算不工作时,可以按照以下步骤进行排查:

  1. 检查配置:
    • 确认自动结算是否已开启
    • 确认自动结算的预设时间是否正确。时间通常使用24小时制。
    • 确认自动结算配置仅在POS应用中进行。如果PAX终端也设置了自动批处理,务必将其关闭。可以在PAX终端的Broadpos应用中(依次点击屏幕四角,输入密码DDMMYYYY,进入Host Setting > Batching)检查并设置为Manual Batch。也可以通过经销商后台关闭PAX终端的自动批处理参数。
  2. 检查设备和应用状态:
    • 确保在预设的结算时间,POS设备和PAX终端都已开机并连接电源
    • 确保POS应用在预设时间处于运行状态,并已登录(停留在PIN码输入界面或锁屏界面即可)
    • 确保PAX终端上的支付应用在预设时间运行在前台
  3. 检查连接:
    • 确认POS设备和PAX终端之间的网络连接正常稳定
    • 尝试重启POS应用或PAX支付应用 (强制关闭并重新打开)。有时需要重启设备。
  4. 查看错误信息和日志:
    • 检查POS系统和PAX终端是否有显示错误通知或消息。
    • 查看POS系统的批处理历史记录或结算日志。如果日志中没有记录,可能表示自动批处理过程根本没有开始。如果日志显示失败,查看失败原因(例如 "transaction not found" 或 "Decline")。
    • 如需更详细的日志,可以在BroadPOS应用中上传日志供技术团队分析 (Settings > About BroadPOS > Log Upload)。
  5. 尝试手动批处理:
    • 在POS应用中找到手动批处理或日结功能,尝试手动完成结算。如果手动批处理成功,说明问题可能出在自动触发的机制或满足自动结算的条件上。
  6. 处理“未结算”状态的交易:
    • 如果交易已经在PAX终端上完成批处理(例如由于PAX自动批处理开启),但在POS系统中仍然显示为“未结算”,这是一个已知问题。可以尝试在交易结算页面点击左上角20次来清除这些状态显示(此功能可能需要V4版本)。请注意,这个操作可能会清除所有未结算的交易,包括未成功批量出去的,操作前请谨慎。如果20次点击无效,需要联系技术团队在后台进行清除。
  7. 联系技术支持:
    • 如果以上步骤无法解决问题,请联系技术支持团队。准备好提供店铺ID,应用版本,设备信息(如Sunmi D3 Pro,PAX A920 Pro, A80等),并提供远程访问权限(如Sunmi账号、Anydesk、Teamviewer)以便团队进行调试。
  8. 联系网关或处理器:
    • 如果日志或错误信息显示是网关或处理器层面的问题(如交易被拒绝),可能需要联系支付网关(如TSYS, Fiserv, EPX)进行确认和解决。对于过旧或无法通过软件批处理的交易,有时需要请处理器手动重新输入并批处理。

希望这些信息和步骤能帮助您更好地理解和解决自动结算不生效的问题。

Previous
Problems related to printers
Last modified: 2025-06-11