基础支付
JSAPI支付
APP支付
Native支付
小程序支付
合单支付
付款码支付
经营能力
微信支付分
支付即服务
行业方案
智慧商圈
微信支付分停车服务
营销工具
代金券
商家券
委托营销
消费卡
支付有礼
小程序发券插件
H5发券
图片上传(营销专用)
现金红包
资金应用
付款
分账
风险合规
消费者投诉2.0
其他能力
清关报关
图片上传
视频上传

接入前准备

1.选择接入模式

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

● 直连模式:

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

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


● 服务商模式:

    —— 信息流    —— 资金流

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

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

服务商模式相关说明详见:服务商模式介绍

2.参数申请

商户自行申请入驻微信支付,无服务商协助。(商户平台申请)成为普通商户

  • 1申请APPID

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

    对于直连商户,该社交载体可以是公众号(什么是公众号),小程序(什么是小程序)或APP。

    如申请社交载体为公众号,请前往 公众平台申请

    如申请社交载体为小程序,请前往 小程序平台 申请

    如商户已拥有自己的APP,且希望该APP接入微信支付,请前往 开放平台申请

    商户可根据实际的业务需求来选择申请不同的社交载体。

    各类社交载体一旦申请成功后,可以登录对应平台查看账号信息以获取对应的appid。

  • 2申请mchid

    申请mchid和APPID的操作互不影响,可以并行操作,申请地址如下: 商户号申请平台

    申请成功后,会向服务商填写的联系邮箱下发通知邮件,内容包含申请成功的mchid及其登录账号密码,请妥善保存。

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

  • 3绑定APPID及mchid

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

    直连模式下,APPID与mchid之间的关系为多对多,即一个APPID下可以绑定多个mchid,而一个mchid也可以绑定多个APPID。

  • 完成

3.配置API key

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

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

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

  • 2在弹出窗口中点击“已沟通”。

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

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

  • 完成

4.下载并配置商户证书

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

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

以下为具体下载步骤:

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

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

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

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

  • 5获取请求串

  • 6生成证书串

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

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

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

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

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

  • 完成

5.合单-JSAPI下单

设置支付目录

支付授权目录说明

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

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


支付授权目录设置说明

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


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

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/

设置授权域名

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


开通流程:在入驻时选择线下场所,公众号场景,PC网站场景的商户系统默认开通此功能,其他商户如有需要,可以在入驻后前往商户平台-产品中心-JSAPI支付-申请开通。

6.合单-Native下单

线上扫码收银台界面规范

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

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


开通流程:在入驻时选择PC网站场景的商户系统默认开通此功能,其他商户如有需要,可以在入驻后前往商户平台-产品中心-Native支付-申请开通。

7.合单-APP下单

APP商户截图规范

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

APP收银台界面规范

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

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


开通流程:在入驻时选择APP场景的商户系统默认开通此功能,其他商户如有需要,可以在入驻后前往商户平台-产品中心-APP支付-申请开通

8.合单-小程序下单

账号申请指引

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


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


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



文档调研

技术咨询

文档反馈