接入前准备
更新时间:2024.10.31在正式接入微信支付JSAPI服务前,你需要进行以下准备步骤:
选择接入模式:普通商户或普通服务商
申请参数:AppID、商户号
设置支付目录
设置授权域名
1.选择接入模式
商户需要判断自己公司注册区域适用的接入模式和自身实际情况,申请成为普通服务商:
普通服务商自身无法作为一个普通商户直接发起交易,其发起交易必须传入相关特约商户商户号的参数信息。
具体接入模式介绍请参考接入模式文档,并按照参考文档完成相应模式的接入。
2.申请参数
请根据自身接入模式参考微信支付接入准备-普通服务商中的参数申请 - 配置API key - 下载并配置商户证书三个步骤申请接入参数。
3. 设置支付目录
3.1. 支付授权目录说明
商户最后请求拉起微信支付收银台的页面地址我们称之为“支付目录”,例如:
https://www.weixin.com/pay.php
的支付授权目录为:https://www.weixin.com/
。商户实际的支付目录必须和在微信商户平台设置的一致,否则会报错“当前页面的URL未注册:”
3.2. 支付授权目录设置说明
登录【微信商户平台—>产品中心—>开发配置】,设置后一般5分钟内生效。
3.3. 支付授权目录校验规则说明
如果支付授权目录设置为顶级域名(例如:https://www.weixin.com/ ),那么只校验顶级域名,不校验后缀;
如果支付授权目录设置为多级目录,就会进行全匹配,例如设置支付授权目录为
https://www.weixin.com/abc/123/
,则实际请求页面目录不能为https://www.weixin.com/abc/
,也不能为https://www.weixin.com/abc/123/pay/
,必须为https://www.weixin.com/abc/123/
。
4. 设置授权域名
开发JSAPI支付时,在JSAPI下单接口中要求必传用户openid
,而获取openid
则需要您在公众平台设置获取openid
的域名,只有被设置过的域名才是一个有效的获取openid
的域名,否则将获取失败。具体界面如图所示:
开通流程: 服务商在【微信支付服务商平台- 产品中心 - 特约商户授权产品】中发起申请,获得商户授权后,可以替商户发起服务商JSAPI支付。