关于Clover POS Payments API缺失字段及数据异常的技术问询

1. 解决{MID}/Payments API无additionalCharges字段的问题 #

• 放弃直接从Payments接口获取该字段，改用{MID}/Orders API，请求时添加expand=additionalCharges参数展开关联数据。因为Clover的附加费用是绑定在订单层级而非支付记录上的。
• 建议添加过滤条件status=COMPLETED，只拉取已完成的订单数据，避免未结算订单的干扰。示例请求：

  GET {MID}/Orders?expand=additionalCharges&filter=status=COMPLETED
  

2. 修复退款API返回0金额员工数据的问题 #

• 调用{MID}/Refunds API时，添加过滤条件filter=amount>0，直接排除金额为0的无效退款记录。示例请求：

  GET {MID}/Refunds?filter=amount>0
  

• 若退款记录的employee字段为空，需要通过expand=order参数关联到对应订单，从订单的employee字段获取实际处理退款的员工信息，这样就能和仪表盘报表的员工数据匹配，修正netSales计算。

3. 获取giftCardActivations字段数据 #

• 使用{MID}/GiftCards API，筛选激活状态的礼品卡并关联交易数据：

  GET {MID}/GiftCards?filter=status=ACTIVE&expand=transaction&filter=transaction.type=ACTIVATION
  

• 从返回的交易记录中提取amount字段，即为礼品卡激活金额，用于修正netSales的计算逻辑。

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