已更新更新时间：2025-07-17 14:42:10文档更新记录 >配置项检测工具收藏订阅更新我的文档设置接入检测（即可查看检测结果）若有未通过的接入检测项，接口将无法调通去登录返回文档接入指南接入说明前置优惠组件是一个小程序插件，商家可以在小程序中集成前置优惠组件，向用户展示商品优惠信息。前置优惠组件有以下几种使用场景：场景支持在哪里接入是否支持页面组件商品领券，展示券场景小程序商品详情页接入小程序商品订单页接入否会员积分优惠小程序商品详情页接入是会员等级专享价优惠小程序商品详情页接入是消费金优惠小程序商品详情页接入小程序商品订单页接入是商家接入前置优惠组件时，可以通过组件里的 获取优惠信息 函数，获取到当前商品的优惠信息。获取优惠信息成功后，可以选择两种接入展示优惠信息的模式：1商家使用自有页面，适配商品优惠信息。2商家使用 前置优惠组件，展示商品优惠信息。在展示商品优惠的场景，目前支持两个版本：1新版本 前置优惠组件获取优惠信息：支持查询专享价、支付券（包含小程序商品券）、全场券、平台红包等优惠信息，新版本中不包括前端样式。 2老版本 支持将专享价、平台券、平台红包合并在组件中展示，限时优惠样式如下图。 接入流程整体的接入流程如下图所示：使用须知●使用该组件前请上报至少一个商品，如果接入消费金则提报消费金商品，其它商品类型同理。●支付宝客户端 10.1.85 及以上版本支持已使用分包的主体小程序应用组件。●不支持较早版本的 appid 为 8 位数字的小程序接入该组件。●静态加载仅支持一个小程序最多关联 10 个组件，动态加载无限制。●本组件使用了新版框架提供的能力，需设置小程序的最低基础库版本至 2.8.9 及以上。配置操作详情可查看 配置最低基础库版本。接入指引1、在小程序中声明使用插件在小程序项目的根目录 app.json中声明使用插件。tradepay指组件名，支持由用户自行定义，使用组件时以自定义名称为准。2、商品详情页获取优惠信息在商品详情页，通过获取优惠信息函数getdetailpagediscountinfo()获取优惠信息。参数详情可查看 。商品详情页接入组件代码示例：3、商品订单页获取优惠信息在商品订单页，通过获取优惠信息函数getorderpagediscountinfo()获取优惠信息。参数详情可查看 。商品订单页接入组件代码示例：4、展示优惠组件如果商户仅使用前置优惠组件查询优惠信息，则不需要通过本章节的方法展示优惠组件。在商品详情页/商品订单页展示优惠信息可以直接调用 前置优惠组件，并将上一步获取到的优惠信息传入组件。声明组件组件地址填写：plugin://${app.json里面声明的组件名称}/discountcard；使用组件商户开发者可以通过style，或者class prop控制前置优惠组件的属性（如：背景色、边框）来适配小程序的页面。此外，建议开发者前置校验一下获取优惠信息步骤拿到的接口响应的 success状态（如：接口可能返回 null / { success: false, ...... }，使用者应当自主优先判断抛弃前述异常情况下在小程序页面中做 setdata() 操作引起前置优惠组件重新渲染），而不是将接口响应回传给前置优惠组件。如果使用者使用自有的商详页，需要在用户更改了选择的商品规格后重新走本章节3，4的步骤，以更新展示成对应的优惠信息。
