JSAPI支付场景

更新时间:2024.12.26

在正式接入本服务前,你需要进行以下准备步骤:

  1. 选择接入模式:普通商户或普通服务商
  2. 申请参数:AppID、商户号
  3. 设置支付目录
  4. 设置授权域名

# 1. 选择接入模式

商户需要判断自己公司注册区域适用的接入模式和自身实际情况,申请成为普通商户或普通服务商:

  • 普通商户自行申请入驻微信支付,无需服务商协助。
  • 普通服务商则自身无法作为一个普通商户直接发起交易,其发起交易必须传入相关特约商户商户号的参数信息。

具体接入模式介绍请参考接入模式文档,并按照参考文档完成相应模式的接入。

# 2. 申请参数

请根据自身接入模式分别参考微信支付接入准备-普通商户微信支付接入准备-普通服务商中的参数申请 - 配置API key - 下载并配置商户证书三个步骤申请接入参数。

# 3. 设置支付目录

# 3.1. 支付授权目录说明

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

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

# 3.2. 支付授权目录设置说明

登录【微信支付商户平台 (opens new window)—>产品中心—>开发配置】,设置后一般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/

cp-5

# 4. 设置授权域名

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

cp-6
cp-6-1

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

您当前查看的是旧版文档,将于 2025年 3 月 31日 进行下线处理。为了获得最新的内容和产品能力,请点击 [这里] 访问新版文档中心