商户/服务商在接入前首先要判断自己公司注册区域适用的接入模式,微信支付目前提供两种接入方式:直连模式和服务商模式。
信息、资金流:微信支付—>直连商户
直连模式,商户自行申请入驻微信支付,无需服务商协助。(商户平台申请)成为直连商户
直连模式相关说明详见:直连模式介绍
—— 信息流 —— 资金流
服务商模式,商户申请成为微信支付服务商,服务商自身无法作为一个直连商户直接发起交易,其发起交易必须传入相关特约商户商户号的参数信息。(服务商平台申请)成为服务商
请结合自身实际情况来选择接入模式。
由于微信支付的产品体系全部搭载于微信的社交体系之上,所以直连商户或服务商接入微信支付之前,都需要有一个微信社交载体,该载体对应的ID即为APPID。
目前服务商的社交载体只能是公众号,服务商可通过公众平台完成公众号注册申请。
公众号申请成功后,服务商可登录公众号平台即可获取对应的APPID,具体查阅目录为 【开发-> 基本配置-> 公众号开发信息】,如下图所示。通常情况下,一个服务商只需申请一个公众号即可。
服务商的收款账号即是mchid,申请mchid和APPID的操作互不影响,可以并行操作,申请地址如下: 商户号申请指引
mchid申请成功后,微信支付将下发通知邮件至机构填写的联系邮箱,内容包含申请成功的mchid及其登录账号密码,请妥善保存。
注意:一个mchid只能对应一个结算币种,若需要使用多个币种收款,需要申请对应数量的mchid。
APPID和mchid全部申请完毕后,需要建立两者之间的绑定关系。
服务商可登录服务商平台,【产品中心-> AppID管理】目录下即可完成绑定。
服务商模式下,一个APPID下可绑定多个mchid,一个mchid可绑定3个APPID。
上述步骤操作完成后,即会向服务商开放入驻子商户权限。
服务商可登录服务商平台进入【服务商功能】界面完成子商户入驻。
API v3密钥主要用于平台证书解密、回调信息解密,具体使用方式可参见接口规则文档中证书和回调报文解密章节。
请根据以下步骤配置API key:
商户API证书具体使用说明可参见接口规则文档中私钥和证书章节
服务商可登录微信服务商平台,在【账户中心 -> API安全】目录下载证书
以下为具体下载步骤:
步骤1 在【商户平台】-“复制证书串”环节,点击“复制证书串”按钮后;
步骤2 在【证书工具】-“复制请求串”环节,点击“下一步”按钮进入“粘贴证书串”环节;
步骤3 在【证书工具】-“粘贴证书串”环节,点击“粘贴”按钮后;
步骤4 点击“下一步”按钮,进入【证书工具】-“生成证书”环节
操作路径:【登录微信服务商平台 → 服务商功能 → 点金计划】,点击申请开通即可。
点击申请开通后进入开通流程,根据指引签署承诺函并填写业务联络人,即可提交申请并开通。
服务商完成点金计划开通后,即可为特约商户开通官方小票或商家小票。接下来将分别介绍官方小票和商家小票开通指引。
官方小票是指平台自动生成的电子账单,仅展示订单金额等基础信息。若特约商户无需为用户展示如:
取餐码、剩余停车时长等服务性内容,则仅开通官方小票即可。官方小票示意图如下:
在点金计划管理页面的特约商户管理列表中选择特约商户,并在“点金计划”栏下打开开关即可。直接打开“点金计划”开关后,该特约商户的点金计划页面将展示官方小票。
服务商也可通过“默认开通”按钮为全量特约商户开通点金计划。如下图所示,在特约商户管理列表 右上角有“默认开通点金计划”开关,打开后,只要特约商户产生jsapi支付,微信支付将自动为其 开通点金计划,无需服务商操作开通。
(注:打开该开关后,有jsapi支付的特约商户均会自动开通点金计划,不可单个关闭。若特约商户无jsapi支付权限,则不会为其自动打开点金计划。其中,若某些特约商户需使用“商家小票”功能,服务商/渠道商需在点金计划管理页面上或通过API额外为其打开商家小票功能开关。)
此外,微信支付侧提供“点金计划管理API”,供服务商为特约商户批量开通点金计划,具体请查看 点金计划管理API。
(注:主动关闭点金计划后,需间隔24 小时方可再次开通)
“商家小票”是指商家为用户提供的订单详情,可展示不同业务场景下的服务性内容,例如取餐码、 剩余停车时长等。开通商家小票功能后,即可将商家页面嵌入到点金计划页面中。商家小票示意图如 下:
商家小票的开通步骤如下:
注:先为特约商户打开“商家小票”开关,再打开“点金计划”开关, 是为了保证在开通点金计划后,特约商户JSAPI 支付后的页面可立即展示商家小票,避免开通时间差导致商家部分订单展示了官方小票的情况。
点金计划页面上方为商家小票提供了一个Iframe 框架,服务商在点金计划管理页面配置“商家小票链接”后,商家小票链接会嵌入该Iframe 框架内,同时,点金计划页面会与服务商交互订单信息,服务商获取订单信息并校验通过后,为用户展示对应的服务性内容即可。
● 服务商维度配置商家小票链接
操作路径:【登录微信支付服务商平台 → 服务商功能 → 点金计划】。在“商家小票链接配置” 模块中,点击“添加商家小票链接”:
添加一个链接:商家小票链接仅支持https 协议,同时需通过ICP 备案的验证,且应保证该链接线上可访问
下载验证文件,验证链接所有权:
将从添加商家小票链接页面下载的验证文件放置在要填写的链接目录下,以证明对该链接的所有权。放置完毕并确保该路径可访问后,填写链接并点击“提交”,微信支付后台会进行验证文件的查验,查验通过后即提交成功。
注:将验证文件放置在所填链接的目录或根目录均可
使用“商家小票调试工具”进行调试:为了保证商家小票在点金计划页面展示的兼容性、完整性,平台还提供了便捷的商家小票调试工具供服务商进行调试。服务商可通过商家小票调试工具,使用所选链接和真实订单号对点金计划页面的数据交互流程、前端JSAPI 的使用进行调试
● 特约商户维度配置独立商家小票链接
部分特约商户(例如:医院、学校等类型)有特殊的域名要求,服务商可为这些特约商户配置独立的商家小票链接。配置后,这些特约商户的点金计划页面将通过所特约商户维度的独立链接进行订单数据交互。未配置特约商户独立商家小票链接的,将依然使用服务商维度的商家小票链接。
特约商户维度独立的商家小票链接入口如下,具体步骤与上述服务商维度配置相同:
完成商家小票链接配置后,服务商还需为特约商户打开商家小票的开关
注:配置完商家小票链接后,才会出现商家小票功能开关
在特约商户管理列表中选择特约商户,在“商家小票”栏下打开开关即可。
同时,平台提供“商家小票管理API”,供服务商为特约商户批量开通/关闭商家小票功能,具体请查看商家小票管理API。
服务商为特约商户打开“商家小票”开关后,还需为其打开“点金计划”开关,若特约商户的“点金计划”未开通,即使 “商家小票”功能开通,其JSAPI 支付后也不会展示点金计划页面和商家小票内容。