Shopify Admin REST API待处理退款金额计算异常问题咨询

一、识别专属pending状态的特殊调整金额 #

你提到的kind="refund_discrepancy"确实是这类临时抵消调整的专属标识。这类调整是平台在退款pending阶段，为暂时平衡账务生成的虚拟调整，只有当退款完成（非pending）时才会被反向冲销。

验证方式很直接：对比pending和已完成状态下的退款调整记录——pending时会有一条refund_discrepancy类型的调整，金额和商品退款总额绝对值相等、符号相反；完成后这条调整会被一条同类型但金额反向的记录冲销。

计算预期退款净额时，只需过滤掉所有kind="refund_discrepancy"的调整项，剩下的调整（比如运费退款这类真实调整）加上商品退款金额就是正确的净额。

二、识别pending状态的退款直接忽略 #

如果不想处理调整项，也可以直接通过API返回的退款状态字段判断：

• 退款数据里的status字段会明确标记为pending（待处理），此时可以暂时跳过计算，等状态变更为completed（完成）或failed（失败）后再获取正确净额。
• 部分平台的API可能会用processing等同义状态，需对照官方文档确认，但核心都是判断是否处于“未完成账务清算”的状态。

补充建议 #

如果不确定refund_discrepancy的唯一性，可以拉取多笔不同状态的退款数据做对比：

1. 取3-5笔pending状态的退款，查看调整项里的kind值
2. 等这些退款完成后，再查看调整项的变化
3. 同时找包含真实调整（如运费退款）的退款记录，确认真实调整的kind不会是refund_discrepancy

这样就能彻底确认该标识的专属属性，避免误过滤真实调整。

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