商品订单页获取优惠信息 -凯发app官方网站

支付产品

私域产品

小程序产品

小程序产品介绍

集成说明

权限集列表

搜索关键词

搜索直达

消息

小程序码

小程序服务

订单中心

小程序开发管理

生物核身

交易组件

权限集介绍

接入准备

使用须知

接入指南

api 列表

常见问题

相关资料

小程序商品

支付有礼

商家粉丝群

营销产品

资金产品

会员产品

信用产品

广告产品

更新时间：2024-10-23 18:07:11

文档更新记录 >

订阅更新

我的文档

设置

请求参数

参数中文名称	参数英文名称	类型	是否必填	参数描述
商户收单pid	pid	string	否	如果需要查询券信息，则需要传入配置在券上面的 pid 账号，如果没有传入则会根据 appid 进行补全（补全可能存在不准确的情况）。
订单详细信息	orderdetailinfo	object	是	-
l 订单总金额	l amount	string	是	订单总金额
l 商品详情列表	l itemdetailinfolist	object[]	是	-
ll 外部商品id	ll outitemid	string	是	-
ll 外部商品skuid	ll outskuid	string	是	-
ll 价格	ll price	string	是	-
ll 数量	ll quantity	string	是	-
ll 商品id（支付券使用）	ll goodsid	string	否	支付券对应商品id，有则配置。
ll 租金信息	ll rentinfo	object	否	标准租赁模式下必填。
lll 租期开始时间	lll rentstarttime	object	是	格式 yyy-mm-dd hh:mm。租期开始时间须晚于下单时间，早于租期结束时间。
lll 租期结束时间	lll rentendtime	object	是	格式 yyy-mm-dd hh:mm。租期结束时间距开始时间最长不可超 36 个月。
l 租赁订单扣款计划	l stagepayplanlist	object[]	否	标准租赁模式下必填。
ll 租赁还款的阶段数	ll stageno	string	是	租赁阶段： 1 为首次租赁，2 为续租，3 为再次续租，以此类推。
ll 付款计划信息	ll stagepayplaninfolist	object[]	是	当前阶段的付款计划明细。
lll 计划付款编号	lll planpayno	string	是	付款明细的分期期数，如 1、2。
lll 计划付款金额	lll planpayprice	string	是	当前付款期数应付的租金。支持每期付款金额不一致，单位为元。
lll 计划付款时间	lll planpaytime	object	是	当前付款期数的计划支付时间。

公共响应参数

参数中文名称	参数英文名称	类型	参数描述
错误码	resultcode	string	-
错误信息	resultmsg	string	-
是否调用成功	success	boolean	-

响应参数

参数中文名称	参数英文名称	类型	参数描述
订单优惠信息	orderdiscountdetailinfo	object	-
l 展示状态	l showstatus	string	用于判断是否可以展示前置优惠组件。 ●true：可以展示组件 ●false：不可以展示组件如果没有会员积分、消费金等优惠的情况不展示组件。
l 限制购买	l buyrestrict	boolean	判断当前sku是否限制购买的状态： ●true：可以购买 ●false：不可以购买注意：如果商品可以使用原价下单情况，则不会限制购买。
l 咨询id	l activityconsultid	string	重要参数，用于保障当前查询订单和用户下单的优惠信息保持一致。
l 总优惠金额	l totalpromoamount	string	订单总的优惠金额 = 券优惠红包优惠渠道优惠
l 券优惠金额	l voucherpromoamount	string	订单总的券优惠金额
l 红包优惠金额	l couponpromoamount	string	订单总的红包优惠金额
l 渠道优惠金额	l channelpromoamount	string	专享价
l 优惠列表	l promoamountinfolist	list	目前单渠道暂时只会存在一种优惠
ll 优惠类型	ll salepromotype	string	●ant_member : 会员积分 ●consume_gold：消费金
ll 总积分	ll totalpointamount	string	订单总共消耗多少会员积分，或者消费金。
ll 渠道指定总优惠	ll totalchannelpromoamount	string	如消费金抵扣的总优惠、渠道立减总优惠
ll 背景图片地址	ll backgroundpic	string	-
ll 背景标识	ll backgroundtag	string	支付宝会员
ll 文案	ll backgroundcontent	string	已满2000消费金抵¥20
l sku优惠明细	l itemconsultdetailinfolist	string	-
ll 商品id	ll outitemid	string	-
ll skuid	ll outskuid	string	-
ll 限制购买状态	ll restrictcode	string	-
ll 限制购买原因	ll restrictreason	string
ll 优惠类型	ll salepromotype	string	●ant_member : 会员积分 ●consume_gold：消费金 ●discount:渠道优惠
ll 优惠子类型	ll promotype	string	会员积分价 -antmemberpromotiontypeenum.member_points 会员等级价 -antmemberpromotiontypeenum.level_price
ll 单次消耗积分	ll singleconsume	string	商品消耗的积分，以下几种情况：在消费金，会员积分场景，展示需要消耗的积分值。会员等级价情况数值为0，异常情况可能返回为空，展示时需要进行兜底处理。比如：9.9元 100积分。
ll 优惠幅度	ll promoamount	string	原价-优惠后售价特别说明：租赁行业该字段为周期均优惠值，例如优惠 2元/天。
ll 原价	ll originalprice	string	商品 sku 原价特别说明：租赁行业该字段为原价周期均价，例如 20元/天。
ll 售价	ll saleprice	string	商品 sku 售价特别说明：租赁行业该字段为售价周期均价，例如 10元/天。
l 券列表	l voucherconsultinfolist	list	展示sku下可以展示的券列表。
ll 券资产编码	ll _assetscode	string	-
ll 券id	ll voucherid	string	-
ll 券名称	ll vouchername	string	券的名称
ll 券类型	ll vouchertype	string	券类型：全场券: all 单品券: item
ll 优惠类型	ll promotype	string	优惠类型包括： ●代金券 - fix ●折扣券 - discount ●减至券 - special
ll 优惠子类型	ll promotionsubtype	string	优惠子类型包括： ●优惠券 - platform_voucher ●红包 - coupon
ll 券金额（满减券）	ll reductionamount	string	-
ll 减至金额（特价券）	ll specifiedamount	string	-
ll 折扣力度（折扣券）	ll reductionratio	string	-
ll 封顶优惠金额	ll ceilingamount	string	-
ll 优惠门槛文案	ll thresholdamountcontent	string	用于展示券使用门槛文案。比如：满100元可用。
ll 券失效时间	ll expiredtime	string	-
ll 红包金额	ll couponamount	string	如果有红包的话，返回红包金额。

请求示例

错误码

公共错误码

错误码	错误码描述
invalid_parameter	非法参数
service_not_not_exist	商品状态异常
service_not_available	商品状态异常
consult_result_error	系统错误
system_error	系统错误

业务错误码

会员积分场景

错误码	错误码描述
member_assert_unavailable	会员优惠不可用
member_point_insufficient	用户会员积分余额不足
promo_budget_not_enough	优惠库存不足
promo_count_limit	优惠计次超限

会员等级场景

错误码	错误码描述
not_qulified_member_grade	用户当前会员等级不准入
member_assert_unavailable	会员优惠不可用
promo_budget_not_enough	优惠库存不足
promo_count_limit	优惠计次超限

消费金场景

错误码	错误码描述
consume_gold_unavailable	消费金不可用
consume_gold_freeze	消费金不可用
consume_gold_unregister	消费金不可用
consume_gold_insufficient	消费金不足
consume_gold_unauthorized	消费金未授权
promo_budget_not_enough	优惠库存不足
promo_count_limit	优惠计次超限

相关问题