小程序方式预签约

更新时间：2026.01.13

电商服务商从商户小程序拉起微信签约小程序发起签约前，需先后台调用预签约接口完成预签约，获取pre_entrustweb_id，再拉起微信签约小程序；用户完成签约授权后，再返回商户小程序。

注意：

用户在微信的页面中完成委托代扣签约后，微信会同时将签约信息通过异步通知的方式通知给商户后台。如果用户放弃签约或签约失败则不通知。
商户获取的签约会话有效期为2小时。

接口说明

适用对象：电商平台

请求URL：https://api.mch.weixin.qq.com/v3/ecommerce/combine-papay/contracts/pre-entrust-sign/mini-program

请求方式：POST

前置条件：商户已开通委托代扣能力

是否幂等：支持幂等

path 指该参数为路径参数

query 指该参数为URL参数

body 指该参数需在请求JSON传参

请求参数

参数名	变量	类型[长度限制]	必填	描述
商户APPID	appid	string[1, 32]	是	body APPID是电商服务商在微信申请公众号或移动应用成功后分配的帐号ID，登录平台为mp.weixin.qq.com或open.weixin.qq.com 示例值：wxd678efh567hg6787
委托代扣协议模板ID	plan_id	int	是	body 委托代扣协议模板ID，申请见接入指引中的接入流程相关内容。示例值：12535
商户签约协议号	out_contract_code	string[1, 32]	是	body 商户侧的签约协议号，商户侧需保证唯一性。示例值：wxwtdk20200910100000
用户账户展示名称	contract_display_account	string[1, 32]	是	body 签约用户的名称，用于签约页面展示，在签约时由商户传入。示例值：微信代扣用户A
回调通知地址	notify_url	string[1, 256]	是	body 接收微信支付异步通知回调地址，通知url必须为直接可访问的URL，不能携带参数。示例值：https://yourapp.com/notify

请求示例

1{
2  "appid": "wxd678efh567hg6787",
3  "contract_display_account": "微信代扣用户A",
4  "notify_url": "https://yourapp.com/notify",
5  "out_contract_code": "wxwtdk20200910100000",
6  "plan_id": 12535
7}

返回参数

参数名	变量	类型[长度限制]	必填	描述
预签约ID	pre_entrustweb_id	string[1, 128]	是	委托代扣签约会话ID，两个小时内有效示例值：5778aadY9nltAsZzXixCkFIGYnV2V
商户号	mchid	string[1, 32]	是	微信支付分配的商户号示例值：1900000109
委托代扣协议模板ID	plan_id	int	是	委托代扣协议模板ID 示例值：12535
商户签约协议号	out_contract_code	string[1, 32]	是	商户侧的签约协议号，商户侧需保证唯一性。示例值：wxwtdk20200910100000

返回示例

1{
2  "mchid": "1900000109",
3  "out_contract_code": "wxwtdk20200910100000",
4  "plan_id": 12535,
5  "pre_entrustweb_id": "5778aadY9nltAsZzXixCkFIGYnV2V"
6}

错误码

公共错误码

状态码	错误码	描述	解决方案
500	SYSTEM_ERROR	接口返回错误	系统异常，请用相同参数重新调用
429	FREQUENCY_LIMITED	频率超限	请降低请求接口频率
400	INVALID_REQUEST	无效请求	请根据接口返回的详细信息检查您的程序
400	PARAM_ERROR	请求参数有误	请检查传入参数是否异常
403	NO_AUTH	商户无委托代扣权限	请前往商户平台开通对应的委托代扣产品权限

文档是否有帮助

更多支持

开发文档(商户)开发文档(V2版)开发者社区微信开放平台微信公众平台腾讯客服