注意事项

字段变更

上传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

退款

享受了单品优惠的订单将不能进行部分退款,只能整单退款。

对账单

对接单品优惠对账单格式不变,使用了免充值券会改变对账单格式,普通对账单详见“对账单API”,免充值券详见“免充值券对接”