商户进件
特约商户进件
基础支付
JSAPI支付
APP支付
H5支付
Native支付
小程序支付
合单支付
付款码支付
经营能力
支付即服务
点金计划
行业方案
平台收付通
智慧商圈
微信支付分停车服务
电子发票
营销工具
代金券
商家券
委托营销
支付有礼
小程序发券插件
H5发券
图片上传(营销专用)
现金红包
资金应用
分账
连锁品牌分账
风险合规
商户开户意愿确认
消费者投诉2.0
商户平台处置通知
其他能力
图片上传
视频上传
微信支付平台证书

合单支付接入前准备

1.选择接入模式

商户/服务商在接入前首先要判断自己公司注册区域适用的接入模式,微信支付目前提供两种接入方式:直连模式和服务商模式。

● 直连模式:

信息、资金流:微信支付—>直连商户

直连模式,商户自行申请入驻微信支付,无需服务商协助。(商户平台申请)成为直连商户

直连模式相关说明详见:直连模式介绍


● 服务商模式:

    —— 信息流    —— 资金流

服务商模式,商户申请成为微信支付服务商,服务商自身无法作为一个直连商户直接发起交易,其发起交易必须传入相关特约商户商户号的参数信息。(服务商平台申请)成为服务商

请结合自身实际情况来选择接入模式。

2.参数申请

  • 1申请APPID

    由于微信支付的产品体系全部搭载于微信的社交体系之上,所以直连商户或服务商接入微信支付之前,都需要有一个微信社交载体,该载体对应的ID即为APPID。

    目前服务商的社交载体只能是公众号,服务商可通过公众平台完成公众号注册申请。

    公众号申请成功后,服务商可登录公众号平台即可获取对应的APPID,具体查阅目录为 【开发-> 基本配置-> 公众号开发信息】,如下图所示。通常情况下,一个服务商只需申请一个公众号即可。

  • 2申请mchid

    服务商的收款账号即是mchid,申请mchid和APPID的操作互不影响,可以并行操作,申请地址如下: 商户号申请指引

    mchid申请成功后,微信支付将下发通知邮件至机构填写的联系邮箱,内容包含申请成功的mchid及其登录账号密码,请妥善保存。

    注意:一个mchid只能对应一个结算币种,若需要使用多个币种收款,需要申请对应数量的mchid。

  • 3绑定APPID及mchid

    APPID和mchid全部申请完毕后,需要建立两者之间的绑定关系。

    服务商可登录服务商平台,【产品中心-> AppID管理】目录下即可完成绑定。

    服务商模式下,一个APPID下可绑定多个mchid,一个mchid可绑定3个APPID。

  • 4入驻子商户

    上述步骤操作完成后,即会向服务商开放入驻子商户权限。

    服务商可登录服务商平台进入【服务商功能】界面完成子商户入驻。

  • 完成

3.配置API key

API v3密钥主要用于平台证书解密、回调信息解密,具体使用方式可参见接口规则文档中证书和回调报文解密章节。

请根据以下步骤配置API key:

  • 1登录微信服务商平台,进入【账户中心 > API安全】目录,设置APIV3密钥。

  • 2在弹出窗口中点击【已沟通】。

  • 3输入API密钥,内容为32位字符,包括数字及大小写字母。点击获取短信验证码。

  • 4输入短信验证码,点击【确认】即设置成功。

  • 完成

4.下载并配置商户证书

商户API证书具体使用说明可参见接口规则文档中私钥和证书章节

服务商可登录微信服务商平台,在【账户中心 -> API安全】目录下载证书

以下为具体下载步骤:

  • 1从2018年底开始,微信支付新入驻机构及商户都将使用CA签发证书,在证书申请页面上点击“申请证书”。

  • 2在弹出窗口中点击“确定”。

  • 3在弹出窗口内点击“下载证书工具”按钮下载证书工具。

  • 4安装证书工具并打开,选择证书需要存储的路径后点击“申请证书”。

  • 5在证书工具中,将复制的商户信息粘贴并点击“下一步”。

  • 6获取请求串

  • 7生成证书串

    步骤1 在【商户平台】-“复制证书串”环节,点击“复制证书串”按钮后;

    步骤2 在【证书工具】-“复制请求串”环节,点击“下一步”按钮进入“粘贴证书串”环节;

    步骤3 在【证书工具】-“粘贴证书串”环节,点击“粘贴”按钮后;

    步骤4 点击“下一步”按钮,进入【证书工具】-“生成证书”环节

  • 8在【证书工具】-“生成证书”环节,已完成申请证书流程,点击“查看证书文件夹”,查看已生成的证书文件。

  • 完成

5.合单-JSAPI下单

5.1. 设置支付目录

5.1.1. 支付授权目录说明

1)商户最后请求拉起微信支付收银台的页面地址我们称之为“支付目录”,例如:https://www.weixin.com/pay.php。

2)商户实际的支付目录必须和在微信服务商平台设置的一致,否则会报错“当前页面的URL未注册:”

3)服务商模式支付目录设置可分为2种方式:

    ● 服务商为全体子商户设置支付目录

    ● 服务商为某一子商户单独设置支付目录

5.1.2. 支付授权目录设置说明

1). 服务商为全体子商户设置支付目录

登录【微信服务商平台—>产品中心—>开发配置】,设置后一般5分钟内生效。


2). 服务商为某一子商户单独设置支付目录

登录【微信服务商平台—>服务商功能—>特约商户管理】,设置后一般5分钟内生效。

5.1.3. 支付授权目录校验规则说明

1)如果支付授权目录设置为顶级域名(例如:https://www.weixin.com/ ),那么只校验顶级域名,不校验后缀;

2)如果支付授权目录设置为多级目录,就会进行全匹配,例如设置支付授权目录为https://www.weixin.com/abc/123/,则实际请求页面目录不能为https://www.weixin.com/abc/,也不能为https://www.weixin.com/abc/123/pay/,必须为https://www.weixin.com/abc/123/

5.2. 设置授权域名

开发JSAPI支付时,在JSAPI下单接口中要求必传用户openid,而获取openid则需要您在公众平台设置获取openid的域名,只有被设置过的域名才是一个有效的获取openid的域名,否则将获取失败。具体界面如图所示:

开通流程:服务商在 微信支付服务商平台 - 产品中心 - 特约商户授权产品 中发起申请,获得商户授权后,可以替商户发起服务商JSAPI支付

6.合单-Native下单

线上扫码收银台界面规范

示例1:单独显要区域,常驻微信支付

示例2:单独页签+页签首位+新logo+推荐标签+直接二维码

开通流程:服务商在 微信支付服务商平台 - 产品中心 - 特约商户授权产品 中发起申请,获得商户授权后,可以替商户发起服务商Native支付。

7.合单-APP下单

APP商户截图规范

APP商户申请时,如选择提供截图,请参见《微信支付APP商户截图标准》提供APP首页截图、APP尾页截图、APP应用内截图和APP支付页截图。

APP收银台界面规范

列表首位+默认勾选+标准logo+推荐标签+标语

素材下载:《微信支付logo、APP支付素材下载

开通流程:服务商在 微信支付服务商平台 - 产品中心 - 特约商户授权产品 中发起申请,获得商户授权后,可以替商户发起服务商APP支付。

8.合单-小程序下单

账号申请指引

1、申请小程序开发者账号,进行微信认证,获取appid登录《微信公众平台》,注册一个小程序的开发者账号。小程序账号申请指引


2、小程序开通微信支付,即申请或复用微信支付商户号 申请完小程序后,登录小程序后台(mp.weixin.qq.com)。点击左侧导航栏的微信支付,在页面中进行开通。


点击开通按钮后,有2种方式可以获取微信支付能力,新申请微信支付商户号或绑定一个已有的微信支付商户号,请根据你的业务需要和具体情况选择,只能二选一。



技术咨询

文档反馈