跳到主内容
版本: 1.x

PAYMENT999: 支付意外错误

这意味着什么

支付处理遇到了意外问题。

请在重试之前确认付款是否已完成。如果无法确定,请导出诊断信息并联系支持团队。

该怎么做

请先查看下面的详细信息再重试。WCPOS 不会自行重试——请在您准备好时重试。

您的数据

无法确认结果——请在重试之前先核实。如果问题持续存在,请导出诊断信息并联系 WCPOS 支持团队。

故障排查

  1. 重试之前先确认付款是否已完成:查看终端屏幕、服务商后台以及 WP Admin 中的订单。
  2. 展开日志条目查看事件代码和上下文——此通用代码表示该原因尚无专属代码。
  3. 如果结果仍不明确,或该代码反复出现,请导出调试信息并联系支持团队。

在哪里查看

当 WCPOS 能够保存此错误时,它会被记录在触发该错误的设备上。打开 商店健康 → 日志(导航抽屉底部的心跳图标),找到标有此代码的条目并展开:展开后的行会显示通俗易懂的原因,以及故障发生时捕获的上下文。对于商店请求,该上下文可能包含服务器自身的错误代码(serverCode)、HTTP statusendpoint;具体显示哪些字段取决于故障发生的位置。上报问题时,请使用日志页面顶部的 复制调试信息(在手机和平板上为 分享调试信息),而不要使用截图:它会打包应用版本、连接状态和最近的错误。日志最多保留 30 天,因此请趁问题还新鲜时收集。此外,也请复制在 POS 能够写入自身日志条目之前出现的任何浏览器控制台错误。

除应用内日志外,此故障还可能在以下位置留下线索:

  • 支付服务商后台:终端服务商自己的记录(例如 Stripe Dashboard → Payments,或 Square Dashboard)才是判断扣款是否成功的权威依据——在重试任何付款之前请先查看。
  • 网络检查器(网页版和桌面版):打开开发者工具——在浏览器中按 F12,或在桌面应用的菜单中选择 高级 → 切换开发者工具——然后选择 网络 选项卡。请先遵循本页的重试指引;只有当这些步骤说明可以安全操作时,才重现该操作。失败的请求会显示 HTTP 状态码和原始响应正文,其中包括那些从未传到 POS 日志的错误页面。

详细信息

  • 代码: PAYMENT999PAYMENT_UNEXPECTED
  • 严重程度: 错误
  • 引入版本: WCPOS 1.10.0