小票wwwqq.com

微信支付点金计划产品文档V2.
12020.
9.
10一、产品介绍.
2二、产品优势.
4三、操作指引.
53.
1服务商开通点金计划53.
1.
1服务商申请开通53.
1.
2签署承诺函.
63.
2官方小票功能开通.
73.
2.
1为特约商户打开"点金计划"开关.
83.
3商家小票功能开通.
103.
3.
1第一步:配置"商家小票链接"123.
3.
2第二步:为特约商户打开"商家小票"开关.
153.
3.
3第三步:为特约商户打开"点金计划"开关.
153.
4商家小票开发指引.
163.
4.
1商家小票链接数据交互(重要)163.
4.
2点金计划页面JSAPI.
173.
4.
3点金计划页面JSSDK(重要)233.
4.
4注意事项243.
5同业过滤标签设置(可选)243.
6关闭广告展示(可选)25一、产品介绍点金计划是微信支付官方提供的支付后回调能力的升级计划.
1、产品简介:微信支付平台提供支付后页面模板,支持账单展示、服务性内容展示、流量位推广等功能.
其中,流量位推广指接入微信广告平台;2、服务商收益:服务商提供点金计划相关技术服务,由微信支付向服务商支付返佣奖励;3、服务商管理工具:可在服务商平台对特约商户开通/关闭点金计划,以及为特约商户配置同业过滤标签,过滤所选行业的广告.
同时,对于有需要的特约商户,服务商可为其开通商家小票功能,即可在点金计划官方页面上方嵌入商家服务性内容,例如展示取餐码、停车时长等.
4、产品形态:服务商为特约商户开通点金计划之后,特约商户的JSAPI支付(除小程序场景)完成后的页面将仅展示点金计划官方页面,同时发起支付的服务商H5页面将被关闭.
服务商可根据特约商户情况,自行选择是否为特约商户开通商家小票功能:1)若仅为特约商户开通点金计划,未开通商家小票功能,该商户JSAPI支付后会展示官方小票样式;2)若为特约商户开通点金计划时,已开通了商家小票功能且已按开发文档完成接入,该商户JSAPI支付后会展示商家小票样式.
注:官方小票指平台自动生成的电子账单,仅展示订单金额等基础信息;商家小票指商家为用户提供的订单详情,可展示不同业务场景下的服务性内容,例如取餐码、停车时长等.
二、产品优势1、产品开通零成本:一键加入"点金计划",即可按月获得对应的奖励.
2、广告对接零成本:由微信广告团队负责广告主的对接和广告内容的投放策略,服务商不需花费精力拓展和对接广告主.
3、广告质量有保障:微信广告提供高质量的广告内容和稳定的广告曝光率,且广告支持一键关注、跳转小程序等能力,从而提升转化效果.
4、商家小票灵活可配置:对于有需要为用户展示服务性内容(取餐码、停车剩余时长等)的特约商户,服务商可为其开通商家小票功能,按开发文档快速接入后,即可在点金计划页面上方嵌入展示商家自定义的服务性内容.
三、操作指引以下将为你介绍点金计划的操作指引:3.
1服务商开通点金计划首先,服务商需先自行开通点金计划.
步骤如下:3.
1.
1服务商申请开通操作路径:【登录微信支付服务商平台→服务商功能→点金计划】,点击申请开通即可.
3.
1.
2签署承诺函点击申请开通后进入开通流程,根据指引签署承诺函并填写业务联络人,即可提交申请并开通.
服务商完成点金计划开通后,即可为特约商户开通官方小票或商家小票.
接下来将分别介绍官方小票和商家小票开通指引.
3.
2官方小票功能开通官方小票是指平台自动生成的电子账单,仅展示订单金额等基础信息.
若特约商户无需为用户展示如取餐码、剩余停车时长等服务性内容,则仅开通官方小票即可.
官方小票示意图如下:开通官方小票仅需为特约商户打开"点金计划"开关,接下来具体介绍.
3.
2.
1为特约商户打开"点金计划"开关在点金计划管理页面的特约商户管理列表中选择特约商户,并在"点金计划"栏下打开开关即可.
直接打开"点金计划"开关后,该特约商户的点金计划页面将展示官方小票.
服务商也可通过"默认开通"按钮为全量特约商户开通点金计划.
如下图所示,在特约商户管理列表右上角有"默认开通点金计划"开关,打开后,只要特约商户产生jsapi支付,微信支付将自动为其开通点金计划,无需服务商操作开通.
(注:打开该开关后,有jsapi支付的特约商户均会自动开通点金计划,不可单个关闭.
若特约商户无jsapi支付,则不会为其自动打开点金计划.
其中,若某些特约商户需使用"商家小票"功能,服务商/渠道商需在点金计划管理页面上或通过API额外为其打开商家小票功能开关.
)此外,微信支付侧提供"点金计划管理API",供服务商为特约商户批量开通点金计划,具体请查看点金计划管理API.
(注:主动关闭点金计划后,需间隔24小时方可再次开通)3.
3商家小票功能开通"商家小票"是指商家为用户提供的订单详情,可展示不同业务场景下的服务性内容,例如取餐码、剩余停车时长等.
开通商家小票功能后,即可将商家页面嵌入到点金计划页面中.
商家小票示意图如下:商家小票的开通步骤如下:注:先为特约商户打开"商家小票"开关,再打开"点金计划"开关,是为了保证在开通点金计划后,特约商户JSAPI支付后的页面可立即展示商家小票,避免开通时间差导致商家部分订单展示了官方小票的情况.
接下来具体介绍各步骤.
3.
3.
1第一步:配置"商家小票链接"点金计划页面上方为商家小票提供了一个Iframe框架,服务商在点金计划管理页面配置"商家小票链接"后,商家小票链接会嵌入该Iframe框架内,同时,点金计划页面会与服务商交互订单信息(如3.
4.
2所述),服务商获取订单信息并校验通过后,为用户展示对应的服务性内容即可.
1、服务商维度配置商家小票链接1)打开点金计划管理页面操作路径:【登录微信支付服务商平台→服务商功能→点金计划】.
在"商家小票链接配置"模块中,点击"添加商家小票链接":2)按照页面操作指引添加一个链接商家小票链接仅支持https协议,同时需通过ICP备案的验证,且应保证该链接线上可访问.
3)下载验证文件,验证链接所有权将从添加商家小票链接页面下载的验证文件放置在要填写的链接目录下,以证明对该链接的所有权.
放置完毕并确保该路径可访问后,填写链接并点击"提交",微信支付后台会进行验证文件的查验,查验通过后即提交成功.
(注:将验证文件放置在所填链接的目录或根目录均可)4)使用"商家小票调试工具"进行调试为了保证商家小票在点金计划页面展示的兼容性、完整性,平台还提供了便捷的商家小票调试工具供服务商进行调试.
服务商可通过商家小票调试工具,使用所选链接和真实订单号对点金计划页面的数据交互流程、前端JSAPI的使用进行调试.
具体调试内容请参考商家小票开发指引.
2、特约商户维度配置独立商家小票链接部分特约商户(例如:医院、学校等类型)有特殊的域名要求,服务商可为这些特约商户配置独立的商家小票链接.
配置后,这些特约商户的点金计划页面将通过所特约商户维度的独立链接进行订单数据交互.
未配置特约商户独立商家小票链接的,将依然使用服务商维度的商家小票链接.
特约商户维度独立的商家小票链接入口如下,具体步骤与上述服务商维度配置相同:3.
3.
2第二步:为特约商户打开"商家小票"开关完成商家小票链接配置后,服务商还需为特约商户打开商家小票的开关(注:配置完商家小票链接后,才会出现商家小票功能开关)在特约商户管理列表中选择特约商户,在"商家小票"栏下打开开关即可.
同时,平台提供"商家小票管理API",供服务商为特约商户批量开通/关闭商家小票功能,具体请查看商家小票管理API.
3.
3.
3第三步:为特约商户打开"点金计划"开关服务商为特约商户打开"商家小票"开关后,还需为其打开"点金计划"开关,若特约商户的"点金计划"未开通,即使"商家小票"功能开通,其JSAPI支付后也不会展示点金计划页面和商家小票内容.
开通"点金计划"开关的操作指引可参考上文为特约商户打开"点金计划"开关3.
4商家小票开发指引3.
4.
1商家小票链接数据交互(重要)点金计划页面会通过如下流程与商家小票链接进行数据交互,以方便商家快速获取订单基础信息,为用户展示服务性内容.
1)通过商家小票链接获取用户订单信息:点金计划页面打开时,页面上方的iframe框架会请求服务商填写的商家小票链接,会在链接后附上:"特约商户号(sub_mch_id)"、"商户订单号(out_trade_no)"、"md5校验码(check_code)"三个字段的信息,方便服务商快速定位到具体订单的同时,也保证链接的可靠性.
a)增加参数后的链接格式为:服务商链接sub_mch_id=特约商户号&out_trade_no=商户订单号&check_code=b)举例:若服务商配置的链接为https://www.
qq.
com,特约商户号为1234567,商户订单号为ABCDEFG,则请求的链接为https://www.
qq.
comsub_mch_id=1234567&out_trade_no=ABCDEFG&check_code=39f0876dd58e4eb61b66250f69d027052)服务商校验check_code服务商获取到上述完整链接时,为了保证参数没有被篡改,需要做MD5校验.
a)校验方式通过链接上的"商户订单号",到后台获取该订单对应的"微信订单号",即transaction_id,并拼在原有链接后(需去除check_code,即:服务商链接sub_mch_id=特约商户号&out_trade_no=商户订单号&transaction_id=),进行MD5计算.
b)举例若transaction_id为abcdefg,则MD5值为:Stringmy_check_code=MD5("https://www.
qq.
comsub_mch_id=1234567&out_trade_no=ABCDEFG&transaction_id=abcdefg");若my_check_code与最初链接参数中的check_code相等,说明该链接未被篡改,可正常跳转到商家小票内容,否则服务商需展示错误提示页.
3)商家小票尺寸适配:点金计划页面上方的商家小票Iframe框架默认尺寸为640px*600px,会根据各手机型号的屏幕宽高比自适应展示.
服务商页面需兼容该尺寸,若Iframe框架高度不满足展示诉求,可参考点金计划页面JSAPI的指引调整高度.
3.
4.
2点金计划页面JSAPI为了提升用户体验,满足商家各类业务需求,点金计划页面提供了一系列JSAPI,协助商家实现以下功能:1、按订单确认是否展示商家小票(onIframeReady事件):已开通商家小票功能的特约商户,服务商依然可以按照当前订单的情况决定是否展示商家小票(也可选择直接展示官方小票).
2、调整Iframe框架高度(onIframeReady事件):供服务商调整商家小票区域的整体高度(规则:以宽度640px为基准,商家小票高度最小600px,最大960px.
若服务商通过jsapi传入高度小于600px,页面会展示600px,传入大于960px,页面仅展示960px).
3、外跳新页面(jumpOut事件):支持从点金计划页面上方的商家小票区域,点击外跳到商家的完整页面(此处不可模拟用户点击自动外跳,否则相关能力会被处罚).
以下为具体的jsapi事件描述,每个事件的触发时机不同,请留意下文对每个事件的触发时机说明:3.
4.
2.
1onIframeReady事件(重要):所有订单必须响应onIframeReady事件,否则无法正常进行商家小票的展示.
通信方式:iframepostMessage事件通知数据格式:json字符串事件名称:onIframeReady事件功能:1)按订单确认是否展示商家小票2)调整Iframe框架高度触发时机:商家小票页面完全渲染完毕之后事件参数:参数说明类型是否必填action事件名称:onIframeReadyString是displayStyle需展示的页面,目前有两个值:1.
展示商家小票SHOW_CUSTOM_PAGE2.
展示官方小票SHOW_OFFICIAL_PAGEString是height自定义高度,范围600-960px(按宽度640px为基数进行转换);若不传,则为默认高度600px;若传入高度超过600px,则展示"展开"按钮,用户点击后展示完整内容;若displayStyle为SHOW_OFFICIAL_PAGE,则传入height无效Int否备注:1)展示商家小票时,建议在商家小票页面渲染完毕后再调用JSAPI;2)从加载商家小票到响应onIframeReady事件之间的用时不可超过3s,若超过3s未响应,为保证用户体验,平台会为用户展示如下图所示的超时页面和刷新按钮,用户可点击刷新按钮重新请求商家小票内容.
示例:(1)展示商家小票:"letmchData={action:'onIframeReady',displayStyle:'SHOW_CUSTOM_PAGE'}letpostData=JSON.
stringify(mchData)parent.
postMessage(postData,'https://payapp.
weixin.
qq.
com')"(2)展示官方小票:"letmchData={action:'onIframeReady',displayStyle:'SHOW_OFFICIAL_PAGE'}letpostData=JSON.
stringify(mchData)parent.
postMessage(postData,'https://payapp.
weixin.
qq.
com')"(3)自定义高度:"letmchData={action:'onIframeReady',displayStyle:'SHOW_CUSTOM_PAGE',height:900}letpostData=JSON.
stringify(mchData)parent.
postMessage(postData,'https://payapp.
weixin.
qq.
com')"注,由于各手机屏幕尺寸不同,为避免设置固定高度值带来的体验不一致问题,服务商可按如下换算规则计算出通过jsapi传给点金计划父页面的高度值:Step1:计算服务商页面当前高度constcustomPageHeight=document.
body.
scrollHeight;//单位pxStep2:换算传入点金计划页面的高度传给父页面的高度(单位:px)=customPageHeight*(640/子页面真实宽度)constheight=customPageHeight*(640/Math.
round(document.
documentElement.
getBoundingClientRect().
width));其中:传给点金计划页面的height值需遵循文档规范,请勿超过限定范围:[600px,960px],即600若未引用,平台会根据《点金计划须知和承诺函》中的相关规定对服务商进行功能处罚.
3.
4.
4注意事项1)为了保证商家小票区域美观性,给用户更好的页面体验,商家小票设计规范建议参考《点金计划商家小票模块设计规范建议》;2)请尽量降低页面请求资源包大小,提升链接打开速度,保障用户体验;3)微信支付将会实时对商家小票内容进行安全检测,商家小票仅可放置例如"取餐码"、"用户评价"、"停车剩余时长"等围绕用户进行服务的内容,请勿出现涉政、黄、赌、毒等违规的内容和行为;且不得出现模拟用户点击、自动触发跳转的行为.
一经出现,平台会关闭其"商家小票"功能,并会进一步联动处罚.
3.
5同业过滤标签设置(可选)点金计划还为商家提供了过滤同业广告的能力(即同业过滤标签设置),服务商只需在点金计划管理页面,选中需设置的特约商户,并点击操作栏的"修改标签",在标签配置页面选择需过滤的行业标签并点击确认即可.
注:特约商户默认无同业过滤标签,且每个商户最多只能设置3个标签.
其中,未开通点金计划的特约商户不可设置.
3.
6关闭广告展示(可选)为了满足某些特约商户不展示广告的诉求,点金计划还提供了关闭广告的能力,服务商只需在点金计划管理页面,选中需设置的特约商户,在"广告展示"栏下关闭开关即可.
同时,平台提供"关闭广告展示API",供服务商为特约商户批量关闭广告展示功能,具体请查看关闭广告展示API.
若需重新打开广告展示,也可通过"开通广告展示API"再次为特约商户批量操作,且在打开广告展示的同时为特约商户设置同业过滤标签,具体请查看开通广告展示API.