新闻中心NEWS

UPTATED:2015-08-01 返回列表微信商户功能官方文档介绍

商户接入指引 V3.0
微信公众平台-商户接入指引 V3.0
更新日期 2013-10-31
商户接入指引 V3.0
1.商户功能简介 ................................................................................................................................ 4
2.申请流程........................................................................................................................................ 5
3.应用场景........................................................................................................................................ 6
3.1 网页内购买场景---JS API 支付接口 ................................................................................. 6
3.2 线下扫码购买场景---Native(原生)支付接口 .............................................................. 8
3.3 共享收货地址 ..................................................................................................................... 9
3.4 接入用户维权系统 ........................................................................................................... 11
4.商户模块...................................................................................................................................... 12
4.1 商品消息推广 ................................................................................................................... 12
4.2 订单流水 ........................................................................................................................... 12
4.3 登录财付通企业版 ........................................................................................................... 13
4.4 支付测试 ........................................................................................................................... 14
5.功能接口...................................................................................................................................... 14
6.帐号体系...................................................................................................................................... 15
7.费率标准...................................................................................................................................... 16
8.保证金.......................................................................................................................................... 16
9.商户系统对接 .............................................................................................................................. 17
10.行业案例 .................................................................................................................................... 19
10.1 在线销售 ......................................................................................................................... 19
10.2 线下扫码购物 ................................................................................................................. 20
10.3 虚拟物品交易 ................................................................................................................. 21
10.4 自动售卖机收款 ............................................................................................................. 22
商户接入指引 V3.0
11.常见问题 .................................................................................................................................... 22
商户接入指引 V3.0
1.商户功能简介
公众平台商户功能,是微信公众平台向有出售物品需求的公众号(即公众平台商户)提
供的以微信支付为核心功能,支持客户关系维护、售后投诉、交易统计的整套解决方案。
注意:只有商家完成支付、发货、用户维权的接入,体验检查通过后,才能上线。
商户接入指引 V3.0
2.申请流程
商户提交微信支付申请需要经过四步(若仅申请 APP 支付,则仅需前三步) 。
步骤一:填写初审信息——这一步需选择此帐号(或 APP)的经营类目,并描述经营内容,
有特殊资质要求的类目,还需上传对应的资质文件资料;
步骤二: 填写商户信息及设置商户功能——填写商户信息这一步需要准备 《营业执照》 、 《税
务登记证照》 、 《组织机构代码证照》 、 《法人或业务经办人身份证》等基本资料,然后按照网
页的引导进行填写和资料上传, 填写商户设置这一步可以选择所需支付类型 (公众号、 APP) ,
商户接入指引 V3.0
并填写各支付方式下的开发配置项(URL、客服电话、APPID 等) ,审核通过后,商户会收
到分别来自微信和财付通的邮件, 获得正式的商户帐号 AppID 和财付通商户号 PartnerID,
支付权限生效、并进入测试状态;
步骤三:签署合同——这一步需在线下完成,商户下载协议后,盖章并寄回指定地址;
步骤四:发布产品——这一步仅限于公众号支付,在产品开发已完成、合同已经寄回、保
证金已经缴纳之后,可以提交发布申请,微信进行产品审核、通过后即向全量用户发布。
3.应用场景
商户通过图文消息、自定义菜单、关键字回复等方式向订阅用户推送商品消息,用户可
在微信公众号中完成选购、填写收货地址、支付的流程。
商户也可以把商品网页生成二维码,张贴在线下的场景,如车站和广告海报。用户扫描
后可打开商品详情,在微信中直接购买。
3.1  网页内购买场景---JS API  支付接口
商户已有 H5 商城网站, 在微信内打开网页时, 可以调用微信支付完成下单购买的流程。
步骤(1) :左图,商户下发图文消息或者通过自定义菜单吸引用户点击进入商户网页。
步骤(2) :右图,进入家网页,用户选择购买,完成选购流程。
商户接入指引 V3.0
步骤(3) :左图,调起微信支付控件,用户开始输入支付密码。
步骤(4) :右图,密码验证通过,支付成功。商户后台得到支付成功的通知。
步骤(5) :左图,返回商户页面,显示购买成功。该页面由商户自定义。
步骤(6) :右图,公众号下发消息,提示发货成功。该步骤可选。
商户接入指引 V3.0
注意: 商户也可以把商品网页的链接生成二维码, 用户扫一扫打开后即可完成购买支付。
3.2  线下扫码购买场景---Native (原生)支付接口
与网页内支付场景不同,部分商户不需要经过网页选购,可以直接下单购买。
步骤(1) :左图,商户根据微信支付的规则,为不同商品生成不同的二维码,张贴在
各种场景,便于用户扫描购买。
步骤(2) :右图,用户使用微信扫描二维码后,获取商品信息,同时到商户后台下单。
步骤(3) :左图,用户开始支付,输入支付密码。
商户接入指引 V3.0
步骤(4) :右图,支付成功,商户后台得到通知,进行发货处理。
注意: 商户也可以把二维码对应的链接, 通过图文消息下发给用户, 用户点击直接支付。
用户每次点击或者扫描这类链接,都会访问商户后台进行下单。
以上两种支付场景,最大的差别在于是否需要经过网页调起支付。
3.3  共享 收货地址
收货地址共享,是指用户在微信浏览器内打开商品网页,填写过地址,后续支持自动填
写,也可增加和编辑。此地址为用户属性,可在不同网页中共享使用。支持原生控件填写地
址,地址数据会传递到商户后台。
步骤(1) :左图,新用户进入网页,没有获取到收货地址。
步骤(2) :右图,点击新增收货地址,进入微信控件,填写地址,商户可获得此数据。
商户接入指引 V3.0
步骤(3) :左图,对于已有地址的用户,进入网页时可以快速选择,并填上,完成购买
流程,而且地址数据作为用户属性,长久保存。
步骤(4) :右图,点击收货地址,可以新增、删除或者编辑地址,所有流程在客户端界
面完成,数据会同步到云端。
商户接入指引 V3.0
3.4  接入用户维权系统
用户在公众号内支付购买行为出现异常时, 通常会投诉到腾讯客服, 因此微信侧需要即
时了解公众号与用户交易的详情。同时,为了最快效率的解决用户的问题,微信作为连接用
户和商户的桥梁,会通过此维权系统即时将问题同步给商户,并将解决结果反馈至用户。
所有获得商家功能(微信支付)的公众号必须接入用户维权系统。
基本交互如下:
商户接入指引 V3.0
4.商户模块
申请支付权限后, 可以登录公众平台 (http://mp.weixin.qq.com) 使用商户模块功能,
查 看 交 易 相 关 的 统 计 数 据 , 也 可 使 用 财 付 通 的 商 户 号 , 登 录 财 付 通 企 业 版
(http://mch.tenpay.com) ,查看订单流水,进行退款、下载对账单等操作。
4.1  商品消息推广
商品消息,是特殊类型的图文消息,用户打开后跳转到商户网站的商品详情页,不经过
公众平台中间页。 商户可以通过群发、 实时回复、 自动回复等方式, 把商品消息下发给用户。
4.2  订单流水
『订单流水』可以汇总了一定周期内商户交易的流水情况,数据包括订单信息,金额,
买家,渠道来源等等。商户也可以从订单中直接向买家发起对话。
商户接入指引 V3.0
4.3  登录财付通企业版
开通商户功能后,会分配商户一个财付通商户号(PartnerID) ,可以登录财付通企业版
(http://mch.tenpay.com)管理资金和进行退款、下载对账单等操作。
商户接入指引 V3.0
4.4  支付测试
商户在获得支付权限后, 此时处于支付测试状态, 只有白名单内的用户可以在微信客户
端上使用支付功能,此时需要在“支付测试”模块中添加白名单。在各项准备工作完成后,
可发起发布申请,申请通过后商户的支付功能才能被全量用户使用。
5.功能接口
以下是商户可能用到的功能和接口,可根据商户的业务定制开通:
编号 类型  功能描述  申请方式
1  商品消息  可下发该类型消息, 用户打开后跳转到商户网站的商品详
情页,不经过公众平台中间页。
默认开通
2  用户身份识别
即网页授权接口,用户打开商户的网页,或扫描对应链接
的二维码,微信会把该用户的OpenID传递到商户后台,
可唯一标识每个用户。
默认开通
3  支付功能  选择以下至少一种的支付方式:
1.  JS API支付: 通过商品消息或者二维码打开的商品详
情网页内,选购商品后,调用客户端的支付功能,在
WebView内基于JS API实现;
默认开通
商户接入指引 V3.0
2.  Native (原生) 支付: 可直接通过图文消息、 二维码,
进入原生购买页面,适用没有选购流程的支付场景。
4  支付相关接口  提供支付订单查询、退款、对账单下载等接口,辅助商家
完成支付流程;同时,商户必须接入发货通知接口,同步
发货状态到微信。
默认开通
5  支付账户管理  可在财付通登录商户的支付帐号管理后台, 查看交易和资
金流水,可进行退款、结算等操作。
默认开通
6  接入维权系统  处理用户投诉, 有效地解决用户购买后发货掉单的投诉问
题,微信侧会监控商家的经营情况。商户必须接入维权系
统,才能上线支付等相关服务。
默认开通
7  共享收货地址  用户在下单网页内填写过地址,后续支持自动填写,也可
增加和编辑。此地址为用户属性,可在商户网页中共享使
用。 支持原生控件填写地址, 地址数据会传递到商户后台。
申请开通
8  支付后推荐关注  未关注此公众号的用户,在此公众号进行支付后,会看到
提示关注此公众号的按钮,确认后即可成功关注。
申请开通
6.帐号体系
商户向微信公众平台提交企业信息以及银行账户资料, 审核通过并签约后, 可以获得以
下帐户(包含财付通的相关支付资金账户) ,用于公众号支付。
帐号  作用
appId
公众号身份标识。
appSecret
公众平台 API(如下发消息、查询 OpenID 等)的权限获取所需密钥 Key,在
使用公众平台 API 时, 都需要先用它去换取 access_token, 然后再进行调用。
paySignKey
公众号支付请求中用于加密的密钥 Key,可验证商户唯一身份,PaySignKey
对应于支付场景中的 appKey 值。
partnerId
财付通商户身份标识,即财付通商户号。
partnerKey
财付通商户权限密钥 Key,用于财付通商家的身份验证。
商户接入指引 V3.0
注:具体的帐号说明和使用场景,请参考《微信公众号支付帮助文档》
7.费率标准
如上文所述,商户需要分别和微信、财付通签订合共 2 份合同,按每笔交易交纳微信
支付手续费,费率的具体数额请参考网页提示。
在商户资金结算时,收取的费用统一由财付通代为扣取。
8.保证金
需缴纳的保证金金额,最终以《微信公众平台商户功能服务协议》里约定的为准。
需要缴纳保证金的商户,可以登录财付通企业版进行缴纳。
商户接入指引 V3.0
9.商户系统对接
开通商户功能后,可按以下步骤完成商户和微信侧的对接,请商户仔细阅读以下部分:
商户接入指引 V3.0
1、生成商品消息:通过接口或者登录公众平台网站,根据商户网站的商品网页生成对
应的消息,也可根据网页链接生成二维码;
2、商品推广:通过群发,自定菜单、关键字回复等方式,下发商品消息,也可把二维
码张贴在车站、海报等线下的场景;
3、用户浏览:用户接收消息或者扫描二维码,即可打开商品网页,浏览商品详情;
4、用户下单:选购商品,可确认款式、数量和收货地址等信息,确认下单;
5、用户支付:商户调用微信支付功能,发起交易;用户确认交易信息,验证支付密码
即可,支付成功,微信支付商户后台;
6、支付成功:用户看到支付成功的结果,通知商户后台,可更新订单状态,进行发货
等相应操作;
7、发货通知:商户收到支付成功通知,发货后,需要通知微信后台,微信记录状态;
8、客服维权:客服系统即时将问题同步给商户,商户可以联系用户解决;
9、资金结算:按照规定的结算周期,系统结算资金到商户的银行账户,同时根据合同
的费率收取支付服务费;
10 、 退 款 操 作 : 商 户 使 用 分 配 的 财 付 通 商 户 号 , 登 录 财 付 通 企 业 版
(http://mch.tenpay.com/)手动操作退款,也可以使用后台接口进行退款;
11、对账单下载:商家除了登录财付通企业版(http://mch.tenpay.com/)手动下载订单
流水,也可以使用后台接口下载订单对账;
注:退款和对账单下载的接口,请参考《财付通支付网关商户开发指南》
商户接入指引 V3.0
10.行业案例
公众平台的商户功能,可以覆盖不同行业,解决线上线下的售卖需求场景。
10.1  在线销售
商户向订阅用户推送商品消息,利用自定义菜单、关键字回复和 CallBack 接口下发商
品信息,用户可在微信公众号中完成选购、填写收货地址、支付的流程。
对于已有帐号系统的商户,通过微信 OpenID 和已有帐号绑定,实现数据互通。
案例:易迅
商户接入指引 V3.0
10.2  线下扫码购物
商户把商品网页生成二维码,张贴在线下的场景,如车站和广告海报。用户扫描后可打
开商品详情,在微信中完成选购和支付的流程。
线下购物后,商户可提供后续服务。
案例:微团购
商户接入指引 V3.0
10.3  虚拟物品交易
微信支付适合小额的快速交易,如话费、Q 币、游戏道具等,支持多代理商结算,快速
退款。
案例:QQ 充值/腾讯充值中心
商户接入指引 V3.0
10.4  自动售卖机收款
结合传统的售卖机,用户选购商品后,扫码机器上的二维码,使用 Native(原生)支
付,快速购买。微信可提供支付帐号和硬件芯片的解决方案。
案例:友宝
11.常见问题
1、微信支付和财付通的关系?
答: 微信支付是以绑定银行卡为基础的支付服务, 由财付通提供支付牌照和银行通道的
技术支持。用户使用微信支付绑定银行卡,和微信号对应 QQ 使用财付通的绑定无关。
同时,用户使用微信号对应 QQ 登录财付通,无法查看微信支付绑定的银行卡和对应
的交易记录。
对于用户,主要认知的是微信支付品牌。对于商户,除了拥有微信公众号的商户身份,
还会有微信公众平台分配一个财付通的商户号,用于结账收款。
2、微信支付如何绑定银行卡?如何支付?
商户接入指引 V3.0
答:用户首次支付时,输入银行卡号和持卡人信息,验证银行预留手机号,即可绑定。
用户还会设置支付密码(非银行取款密码) ,后续购买不用再绑卡,验证支付密码即可直接
支付。微信支付的绑定和支付流程,都是标准的快捷支付流程。
3、微信支付可以绑定的银行卡数量?
答:支持绑定 13 家银行,22 个卡种的银行卡,包括储蓄卡和信用卡都可以。目前正
在不断接入银行,覆盖范围会越来越大。
4、商户如何申请接入微信支付?
答: 商户在微信公众平台申请商户功能, 接入支付, 即可分配微信的商户帐号 (AppID)
和财付通商户号 (PartnerID) , 其中财付通商户号用于资金收款, 会和商户的银行账户绑定。
其中,财付通商户号由微信公众平台代理申请,商户在公众平台网站即可完成申请。
用户支付后,资金会转到商户的财付通商户号,结算周期到了,会结算到商户的银行帐
号上面。
5、微信除了提供商户的支付接口,还有其他接口能力吗?
答:除了支付接口,微信还会提供订单查询、退款、退款查询、对账单下载等支付相关
的接口,和财付通提供给商家的接口能力一样。不少商户担心退款和对账的接口,这些都是
可以提供的。具体参考《财付通支付网关商户开发指南》 。
除了支付相关的接口,网页授权标识用户,收货地址共享,支付后推荐关注等,也会向
商户提供。
6、微信支付的支付类型是?
答:微信支付使用的是 B2C 即时到账接口,暂不支持 C2C 的担保交易类型。
7、商户是订阅号,可以接入支付吗?
答:目前只有服务号才能接入微信支付。
商户接入指引 V3.0
8、收货地址共享的地址格式是?
答:微信收货地址是基于三级的国标数据,地区对应是国标三级地区码,如“广东省-
广州市-天河区” ,对应的是 510630。
详情参考:http://www.stats.gov.cn/tjbz/xzqhdm/t20130118_402867249.htm
9、微信支付的安全性如何保证?
答:有以下手段保证支付安全:
- 绑定银行卡需要验证实名信息和银行预留手机号;绑定银行卡后设置支付密码,交易
需要验证此支付密码,大额支付还需要验证手机短信;
- 微信认证商家网页是安全的支付环境,会有微信安全支付的认证标题,提示用户;
- 支付后台有腾讯的大数据支撑, 海量的数据和云端的计算能够及时判定用户的支付行
为存在的风险性,如异地支付、非常用设备支付、QQ 号被盗等情况,会分析和拦截异常支
付行为;
- 7*24 小时客户服务,加上微信客服,将及时为用户排忧解难;同时为微信支付开辟的
专属客服通道,将以最快的速度响应用户的提出问题并做出处理判断;
10、接入微信支付,商户担心网页会被假冒和钓鱼?
答:微信会认证安全商户的网页,提示“微信安全支付” ;不安全或者高风险的网页,
微信会弹出中间页提示不安全,并拦截,未受安全认证的网页内填写相关帐号或者支付,也
会提示有系统“ 网页内提示不要输入 QQ 密码或请勿支付 ” 。
11、商户接入微信支付的成本高吗?
答:对于已有 H5 商城的商户接入 JS API 支付,前端页面上加微信支付按钮即可,支
付成功后,后台接收通知发货;对于接入 Native(原生)支付,商家后台增加一个下单接
口,接收微信的下单请求即可。开发成本较低,不需要改变已有的流程
商户接入指引 V3.0
12、商家使用微信支付需要有一个财付通商户号,能否使用已有的商户号?
答:由于支付权限和支付费率的差异,不能使用已有的财付通商户号,需要在微信公众
平台重新申请开通。