开发接入准备

更新时间:2026.10.13
||| 安装 Skill

1、开发前准备

1.1、设置安全联系人

微信支付日常安全监测发现技术异常时,会向安全联系人和超级管理员发送风险提醒。请商户超级管理员尽快设置技术同事为安全联系人,确保能及时接收异常信息评估业务风险,详见 安全联系人设置指引 。

1.2、熟悉微信支付接口规则

正式进入开发前,开发者需要先阅读 基本规则 、 总述-APIv3如何签名和验签 了解调用微信支付接口的基本规则和签名规则。 

1.3、准备开发参数

通用开发参数:如服务商商户号、子商户号(也叫特约商户号)、sp_appid、证书私钥、公钥等,获取方式详见: 开发必要参数说明 。

业务开发参数:见下表

参数名

用途

获取角色

获取方式

 sp_appid 

 sp_appid 是服务商在微信开放平台(移动应用)或公众平台(公众号/小程序)上申请的一个唯一标识。该 sp_appid 必须与服务商商户号 sp_mchid 进行绑定,使用微信支付功能会校验该参数。见开发必要参数说明 

 超级管理员、技术负责人

 登录服务商平台「产品中心 → APPID账号管理 → 我关联的APPID账号」查看。见管理商户号绑定的APPID账号「1、查询服务商自身绑定的APPID账号」 

 回调域名

 微信支付向服务商发送支付成功通知和退款结果通知时的域名

 服务商备案域名,开发人员传入地址

 服务商自行准备公网域名,不由微信支付分配。国内服务器须先完成 ICP 备案,省管局审核时限 20 个工作日内,开发准备开始就提交;在接入商或工信部备案系统能查到已备案后使用。

准备完成后,由服务商将该域名写入 notify_url。见回调通知注意事项 

产品权限

需要准备

用途

办理方式

 服务商 JSAPI 支付权限

 授权该服务商商户号为子商户受理 JSAPI 支付,用于在微信内置浏览器中下单并调起收银台

 已有服务商商户号:服务商平台「产品中心 → 特约商户授权产品 → 服务商JSAPI支付 → 申请开通」,审核 7 个工作日内。

尚无服务商商户号:按服务商商户入驻详细流程申请。开通结果在同一页面查看。见下文「2.1、服务商自身申请开通JSAPI支付权限」 

 支付授权目录

 登记可调起收银台的页面目录。调起支付时,微信支付校验当前页面 URL 是否与已登记目录一致。服务商或子商户其中一处配置匹配即可调起

 域名备案后配置,一般 5 分钟内生效。可为全体子商户配置:服务商平台「产品中心 → 开发配置」。也可为单个子商户配置:服务商平台「合作伙伴功能 → 商户基础服务 → 开发配置参数」。见配置JSAPI支付授权目录 

 子商户授权

 授权服务商使用该子商户的 JSAPI 支付权限

 服务商在服务商平台对子商户发起邀请,子商户登录商户平台确认授权。子商户尚未入驻时,可通过服务商平台入驻或 产品介绍 。见下文「2.2、子商户授权服务商使用JSAPI支付权限」 

 sp_mchid 与 sp_appid 绑定

 授权指定 sp_appid 使用该服务商商户号,下单时微信支付会校验二者的绑定关系

 超级管理员在服务商平台「产品中心 → AppID授权管理 → 关联AppID」提交,再登录对应平台(公众平台或开放平台)确认。已绑定账号在「产品中心 → APPID账号管理 → 我关联的APPID账号」查看。见 管理商户号绑定的APPID账号  

 sub_mchid 与 sub_appid 绑定

 使用 sub_appid 时,授权该应用标识与对应子商户号绑定,下单时微信支付会校验该参数

 由服务商在服务商平台为子商户发起绑定,再登录对应平台确认。见 管理商户号绑定的APPID账号 「登录服务商平台为子商户发起APPID的授权绑定申请」 

注意:

在开发的过程中,请将应答的HTTP头Request-ID值打印到日志中。Request-ID作为请求的唯一标识,在调用接口遇到问题时,可向微信侧提供该值用于快速定位到请求记录,协助排查问题原因。

2、申请开通服务商JSAPI支付产品权限

使用服务商模式JSAPI支付产品,涉及两个权限:

  • 服务商自身申请开通JSAPI支付权限,详见1.1。

  • 子商户(也叫特约商户)授权服务商使用JSAPI支付权限,详见1.2。 

2.1、服务商自身申请开通JSAPI支付权限

若商户已拥有服务商商户号(如无,请按服务商商户入驻详细流程指引申请),请按照如下步骤申请,申请完成后进入审核阶段,待审核通过后(7个工作日内),则开通JSAPI支付权限成功。

步骤一:登录服务商平台,点击“产品中心- 特约商户授权产品-服务商JSAPI支付”

步骤二:点击“申请开通”

 

 

当你看到如下界面,则代表权限申请完成:

开通成功页面示例

 

1.2、子商户授权服务商使用JSAPI支付权限

子商户(子商户需要服务商协助入驻,入驻有两种方式:服务商平台入驻或接口入驻)授权服务商使用JSAPI支付权限,涉及两个步骤:

步骤一:服务商登录服务商平台,通过路径【产品中心 -> 特约商户授权产品 -> 服务商JSAPI支付 ->  特约商户列表】找到需要授权JSAPI支付的子商户号,点击“发起邀请”。 

步骤二:子商户登录商户平台,通过路径【产品中心 -> 我的授权产品】找到服务商JSAPI支付,点击“授权”。 

步骤一:服务商申请授权

步骤二:子商户确认授权

 

 

当子商户授权服务商使用JSAPI支付权限后,授权状态会显示“已授权”,服务商平台和商户平台各自看到的状态如下所示:

子商户授权成功,服务商平台显示页面

子商户授权成功,商户平台显示页面