DocuSign提示付款项与总额不符但总额正确的警告如何消除

问题描述 #

使用DocuSign处理付款流程时，系统弹出警告提示「付款项目与总额存在差异」，手动核对页面顶部展示的总额数值完全正确，警告界面如下：

需要找到可消除该警告的操作方法。

解决方案 #

该警告的校验逻辑并非针对页面顶部展示的汇总展示值，而是校验付款模块底层所有参与金额计算的字段累加值、支付网关要求的提交金额二者的一致性。顶部展示值经过前端四舍五入、隐藏字段计算后，可能和底层计算值存在隐式偏差，按以下步骤操作即可修复：

• 校准所有付款行项目的数值精度
  DocuSign对接支付网关时默认仅支持2位小数的金额格式，若单行金额设置了3位及以上小数（例如19.999），前端展示时会自动四舍五入为20.00，显示为你看到的正确总额，但底层传值仍保留原始精度，就会触发差值警告。将所有付款行的金额统一调整为最多2位小数即可。
• 清理隐藏的付款关联字段
  若你之前编辑模板/信封时删除过付款项、添加过折扣/税费/手续费类自动计算字段后又设置为隐藏，这类字段不会在前端页面展示，但仍会参与金额累加计算。打开付款配置面板的「高级字段设置」，删除所有不在前端展示的冗余付款关联字段，或重新校准这类字段的计算规则，确保所有参与计算的字段值累加后和应收总额完全相等。
• 触发金额重新同步
  编辑金额后若前端本地缓存和DocuSign支付网关同步异常也会触发误报：先把所有付款行的金额临时改为0并保存，退出编辑页面后重新进入，逐行输入正确金额，每输入完一行等待1-2秒待系统自动完成汇总计算，待页面提示金额同步完成后再保存配置。
• 修复模板缓存脏数据
  若你是通过已有模板创建的信封，旧模板可能残留历史金额配置的脏数据，直接复用就会触发警告。可以复制原有模板后，删除旧的付款模块组件，重新拖入新的付款组件并配置所有行项目金额，再用新模板发送信封即可。

注意：不要尝试通过浏览器调试工具强行修改顶部的只读汇总值消除警告，该操作会导致提交到支付网关的金额和实际应收金额不匹配，直接触发支付失败。

内容的提问来源于stack exchange，提问作者Helen Tang