开发接入准备
更新时间:2026.10.131、开发前准备
1.1、设置安全联系人
微信支付日常安全监测发现技术异常时,会向安全联系人和超级管理员发送风险提醒。请商户超级管理员尽快设置技术同事为安全联系人,确保能及时接收异常信息评估业务风险,详见 安全联系人设置指引 。
1.2、熟悉微信支付接口规则
正式进入开发前,开发者需要先阅读 基本规则 、 总述-APIv3如何签名和验签 了解调用微信支付接口的基本规则和签名规则。
1.3、准备开发参数
通用开发参数:如服务商商户号、子商户号(也叫特约商户号)、sp_appid、证书私钥、公钥等,获取方式详见: 开发必要参数说明 。
业务开发参数:见下表
参数名 | 用途 | 获取角色 | 获取方式 |
|---|---|---|---|
| | 超级管理员、技术负责人 | 登录服务商平台「产品中心 → APPID账号管理 → 我关联的APPID账号」查看。见管理商户号绑定的APPID账号「1、查询服务商自身绑定的APPID账号」 |
回调域名 | 微信支付向服务商发送支付成功通知和退款结果通知时的域名 | 服务商备案域名,开发人员传入地址 | 服务商自行准备公网域名,不由微信支付分配。国内服务器须先完成 ICP 备案,省管局审核时限 20 个工作日内,开发准备开始就提交;在接入商或工信部备案系统能查到已备案后使用。 准备完成后,由服务商将该域名写入 |
产品权限
需要准备 | 用途 | 办理方式 |
|---|---|---|
服务商 JSAPI 支付权限 | 授权该服务商商户号为子商户受理 JSAPI 支付,用于在微信内置浏览器中下单并调起收银台 | 已有服务商商户号:服务商平台「产品中心 → 特约商户授权产品 → 服务商JSAPI支付 → 申请开通」,审核 7 个工作日内。 尚无服务商商户号:按服务商商户入驻详细流程申请。开通结果在同一页面查看。见下文「2.1、服务商自身申请开通JSAPI支付权限」 |
支付授权目录 | 登记可调起收银台的页面目录。调起支付时,微信支付校验当前页面 URL 是否与已登记目录一致。服务商或子商户其中一处配置匹配即可调起 | 域名备案后配置,一般 5 分钟内生效。可为全体子商户配置:服务商平台「产品中心 → 开发配置」。也可为单个子商户配置:服务商平台「合作伙伴功能 → 商户基础服务 → 开发配置参数」。见配置JSAPI支付授权目录 |
子商户授权 | 授权服务商使用该子商户的 JSAPI 支付权限 | 服务商在服务商平台对子商户发起邀请,子商户登录商户平台确认授权。子商户尚未入驻时,可通过服务商平台入驻或 产品介绍 。见下文「2.2、子商户授权服务商使用JSAPI支付权限」 |
| 授权指定 | 超级管理员在服务商平台「产品中心 → AppID授权管理 → 关联AppID」提交,再登录对应平台(公众平台或开放平台)确认。已绑定账号在「产品中心 → APPID账号管理 → 我关联的APPID账号」查看。见 管理商户号绑定的APPID账号 |
| 使用 | 由服务商在服务商平台为子商户发起绑定,再登录对应平台确认。见 管理商户号绑定的APPID账号 「登录服务商平台为子商户发起APPID的授权绑定申请」 |
|
2、申请开通服务商JSAPI支付产品权限
使用服务商模式JSAPI支付产品,涉及两个权限:
2.1、服务商自身申请开通JSAPI支付权限
若商户已拥有服务商商户号(如无,请按服务商商户入驻详细流程指引申请),请按照如下步骤申请,申请完成后进入审核阶段,待审核通过后(7个工作日内),则开通JSAPI支付权限成功。
步骤一:登录服务商平台,点击“产品中心- 特约商户授权产品-服务商JSAPI支付” | 步骤二:点击“申请开通” |
|
|
当你看到如下界面,则代表权限申请完成:
开通成功页面示例 |
|---|
|
1.2、子商户授权服务商使用JSAPI支付权限
子商户(子商户需要服务商协助入驻,入驻有两种方式:服务商平台入驻或接口入驻)授权服务商使用JSAPI支付权限,涉及两个步骤:
步骤一:服务商登录服务商平台,通过路径【产品中心 -> 特约商户授权产品 -> 服务商JSAPI支付 -> 特约商户列表】找到需要授权JSAPI支付的子商户号,点击“发起邀请”。
步骤二:子商户登录商户平台,通过路径【产品中心 -> 我的授权产品】找到服务商JSAPI支付,点击“授权”。
步骤一:服务商申请授权 | 步骤二:子商户确认授权 |
|---|---|
|
|
当子商户授权服务商使用JSAPI支付权限后,授权状态会显示“已授权”,服务商平台和商户平台各自看到的状态如下所示:
子商户授权成功,服务商平台显示页面 | 子商户授权成功,商户平台显示页面 |
|---|---|
|
|







