注意事项
更新时间：2024.11.18字段变更
上传version字段是为了支持单品营销功能，普通支付订单可不上传version字段。
字段名 | 变量名 | 变更接口名 | 变更类型 | 说明 |
|---|---|---|---|---|
代金券使用数量 | coupon_count | 统一下单、查询订单 | 删除 | 上传参数version后，不再返回coupon_count，接口参数promotion_detail会返回每张券的具体信息，商户可以通过解析promotion_detail参数来确认使用了几张代金券。 |
总代金券金额 | coupon_fee | 付款码支付、统一下单、查询订单 | 删除 | 上传参数version后，不再返回coupon_fee，新增接口参数promotion_detail会返回每张券的金额（amount），商户可以通过累加得出总代金券金额。 |
单个代金券支付金额 | coupon_fee_$n | 统一下单、查询订单 | 删除 | 上传参数version后，不再返回coupon_fee_$n，新增接口参数promotion_detail会返回每张券的金额（amount） |
代金券类型 | coupon_type | 统一下单、查询订单 | 删除 | 上传参数version后，不再返回coupon_type，新增接口参数promotion_detail会返回代金券类型（type），COUPON表示普通代金券，DISCOUNT表示免充值券 |
代金券id | coupon_id | 统一下单、查询订单 | 删除 | 上传参数version后，不再返回coupon_id，新增接口参数promotion_detail会返回代金券id（promotion_id） |
应结订单金额 | settlement_total_fee | 付款码支付、统一下单、查询订单 | 删除 | 上传参数version后，不再返回settlement_total_fee，商户可以通过新增接口参数promotion_detail返回的内容计算出应结订单金额 |
版本号 | version | 付款码支付、统一下单、查询订单、支付结果通知 | 新增 | 1.付款码支付、统一下单、查询订单，请求参数上传version后，将新增返回参数promotion_detail 2.统一下单API，请求参数上传version后，支付结果通知将新增返回参数promotion_detail |
营销详情 | promotion_detail | 付款码支付、统一下单、查询订单、支付结果通知 | 新增 | 1.付款码支付、统一下单、查询订单，请求参数上传version后，将新增返回参数promotion_detail 2.统一下单API，请求参数上传version后，支付结果通知将新增返回参数promotion_detail |
退款
享受了单品优惠的订单将不能使用原退款接口进行部分退款，只能整单退款，或者通过单品优惠退款接口进行部分退款。
对账单
订单无法享受优惠情况
只有下单时订单使用了优惠，回调通知才会返回券信息。
下列情况可能导致订单不可以享受优惠：可能情况
【单品相关】
1、统一下单接口使用了单品优惠（传入了version字段）也不会返回coupon_type，coupon_id，但是新增字段promotion_detail里面会有代金券类型与代金券ID进行代替。
2、单品优惠格式问题导致，需要严格按照文档中detail字段值举例 的格式进行传值。
3、统一下单接口使用单品优惠没有传version字段。
4、订单金额不满足券批次的规则(例如满9元减1元，而订单是8元)。
5、单品中price为负。
6、单品price带有小数。
7、商户在传递goods_detail时，同时传递了正常的单品信息，也传了异常的信息。
8、商户传递正常单品信息时，也传了goods_id为空的信息。
9、商户没有传单品信息。
【支付方式相关】
1、该笔订单没有使用优惠。
2、规则中限制了支付模式。
3、规则中限制了支付方式。
【goodstag相关】
1、传了goodtags，但是goodtags对应的券批次过期。
2、goodtags不符合。
3、批次中设置了goodtags，但是订单中没有使用。
【goodstag相关】
1、该批次开启了自然人防刷，用户其他账号当天已经用过优惠。
2、订单支付时间不在批次可用时间内，是否设置了有效期内指定时间段可用。
3、订单交易的商户号不在批次的可用商户号里。
4、设置了超预算发券，发券总金额可以超出总预算，预算不足时，用户无法使用代金券。
5、批次设置单天预算发放上限，超出上限时用户无法使用代金券。
6、订单传的商品编码不匹配批次规则可用的商品编码。
7、支付成功时间不符合。
