注意事項
字段變更
上傳version字段是為了支持單品營銷功能,普通支付訂單可不上傳version字段。
字段名 | 變量名 | 變更接口名 | 變更類型 | 說明 |
---|---|---|---|---|
代金券使用數(shù)量 |
coupon_count |
統(tǒng)一下單、查詢訂單 |
刪除 | 上傳參數(shù)version后,不再返回coupon_count,接口參數(shù)promotion_detail會返回每張券的具體信息,商戶可以通過解析promotion_detail參數(shù)來確認使用了幾張代金券。 |
總代金券金額 |
coupon_fee |
付款碼支付、統(tǒng)一下單、查詢訂單 |
刪除 | 上傳參數(shù)version后,不再返回coupon_fee,新增接口參數(shù)promotion_detail會返回每張券的金額(amount),商戶可以通過累加得出總代金券金額。 |
單個代金券支付金額 |
coupon_fee_$n |
統(tǒng)一下單、查詢訂單 |
刪除 | 上傳參數(shù)version后,不再返回coupon_fee_$n,新增接口參數(shù)promotion_detail會返回每張券的金額(amount) |
代金券類型 |
coupon_type |
統(tǒng)一下單、查詢訂單 |
刪除 | 上傳參數(shù)version后,不再返回coupon_type,新增接口參數(shù)promotion_detail會返回代金券類型(type),COUPON表示普通代金券,DISCOUNT表示免充值券 |
代金券id |
coupon_id |
統(tǒng)一下單、查詢訂單 |
刪除 | 上傳參數(shù)version后,不再返回coupon_id,新增接口參數(shù)promotion_detail會返回代金券id(promotion_id) |
應結訂單金額 |
settlement_total_fee |
付款碼支付、統(tǒng)一下單、查詢訂單 |
刪除 | 上傳參數(shù)version后,不再返回settlement_total_fee,商戶可以通過新增接口參數(shù)promotion_detail返回的內(nèi)容計算出應結訂單金額 |
版本號 |
version |
付款碼支付、統(tǒng)一下單、查詢訂單、支付結果通知 |
新增 | 1.付款碼支付、統(tǒng)一下單、查詢訂單,請求參數(shù)上傳version后,將新增返回參數(shù)promotion_detail 2.統(tǒng)一下單API,請求參數(shù)上傳version后,支付結果通知將新增返回參數(shù)promotion_detail |
營銷詳情 |
promotion_detail |
付款碼支付、統(tǒng)一下單、查詢訂單、支付結果通知 |
新增 | 1.付款碼支付、統(tǒng)一下單、查詢訂單,請求參數(shù)上傳version后,將新增返回參數(shù)promotion_detail 2.統(tǒng)一下單API,請求參數(shù)上傳version后,支付結果通知將新增返回參數(shù)promotion_detail |
退款
享受了單品優(yōu)惠的訂單將不能使用原退款接口進行部分退款,只能整單退款,或者通過單品優(yōu)惠退款接口進行部分退款。
訂單無法享受優(yōu)惠情況
只有下單時訂單使用了優(yōu)惠,回調(diào)通知才會返回券信息。
下列情況可能導致訂單不可以享受優(yōu)惠:可能情況
【單品相關】
1、統(tǒng)一下單接口使用了單品優(yōu)惠(傳入了version字段)也不會返回coupon_type,coupon_id,但是新增字段promotion_detail里面會有代金券類型與代金券ID進行代替。
2、單品優(yōu)惠格式問題導致,需要嚴格按照文檔中detail字段值舉例 的格式進行傳值。
3、統(tǒng)一下單接口使用單品優(yōu)惠沒有傳version字段。
4、訂單金額不滿足券批次的規(guī)則(例如滿9元減1元,而訂單是8元)。
5、單品中price為負。
6、單品price帶有小數(shù)。
7、商戶在傳遞goods_detail時,同時傳遞了正常的單品信息,也傳了異常的信息。
8、商戶傳遞正常單品信息時,也傳了goods_id為空的信息。
9、商戶沒有傳單品信息。
【支付方式相關】
1、該筆訂單沒有使用優(yōu)惠。
2、規(guī)則中限制了支付模式。
3、規(guī)則中限制了支付方式。
【goodstag相關】
1、傳了goodtags,但是goodtags對應的券批次過期。
2、goodtags不符合。
3、批次中設置了goodtags,但是訂單中沒有使用。
【goodstag相關】
1、該批次開啟了自然人防刷,用戶其他賬號當天已經(jīng)用過優(yōu)惠。
2、訂單支付時間不在批次可用時間內(nèi),是否設置了有效期內(nèi)指定時間段可用。
3、訂單交易的商戶號不在批次的可用商戶號里。
4、設置了超預算發(fā)券,發(fā)券總金額可以超出總預算,預算不足時,用戶無法使用代金券。
5、批次設置單天預算發(fā)放上限,超出上限時用戶無法使用代金券。
6、訂單傳的商品編碼不匹配批次規(guī)則可用的商品編碼。
7、支付成功時間不符合。