公众号纯签约

最新更新时间:2020.04.17 版本说明


商户可以通过请求此接口唤起微信委托代扣的页面。

接口说明

适用对象:直连商户

请求URL: https://api.mch.weixin.qq.com/papay/entrustweb

请求方式: GET

数据格式: XML

是否需要证书:

请求参数

参数名 变量 类型[长度限制] 必填 描述
应用ID appid string[1,32] 直连商户申请的公众号或移动应用appid。
示例值:wxcbda96de0b165486
商户号 mch_id string[1,32] 商户号是商户在微信申请微信支付成功后分配的帐号ID,登录平台为pay.weixin.qq.com
示例值:1200009811
模板id plan_id string[1,28] 协议模板id,设置路径见开发步骤
示例值:12535
签约协议号 contract_code string[1,32] 商户侧的签约协议号,由商户生成,只能是数字、大小写字母的描述。
示例值:100000
请求序列号 request_serial int64 商户请求签约时的序列号,要求唯一性。禁止使用0开头,序列号主要用于排序,不作为查询条件,纯数字,范围不能超过Int64的范围(9223372036854775807)。
示例值:1000
用户账户展示名称 contract_display_account string[1,32] 签约用户的名称,用于页面展示,参数值不支持UTF8非3字节编码的字符,例如表情符号,所以请勿传微信昵称到该字段
示例值:微信代扣
回调通知url notify_url string[1,256] 用于接收签约成功消息的回调通知地址,以http或https开头,通知url必须为外网可访问的url,不能携带参数。
请对notify_url参数值进行encode处理,注意是对参数值进行encode,例如参数为notify_url=“https://weixin.qq.com”,则需要encode的内容为https://weixin.qq.com。
示例值:https://weixin.qq.com
版本号 version string[1,8] 固定值1.0
示例值:1.0
签名 sign string[1,32] 详见签名生成算法
示例值:C380BEC2BFD727A4B6845133519F3AD6
时间戳 timestamp string[1,10] 系统当前时间,10位
示例值:1414488825
返回web return_web int 用来控制签约页面结束后的返回路径(不传此参数,则签约完成后停留在微信内)。
1表示返回签约页面的referrer url, 不填或获取不到referrer则不返回; 跳转referrer url时会自动带上参数from_wxpay=1
示例值:1

请求示例:

https://api.mch.weixin.qq.com/papay/entrustweb?appid=wx426a3015555a46be&contract_code=122&contract_display_account=name1&mch_id=1223816102&notify_url=www.qq.com%2Ftest%2Fpapay&plan_id=106&request_serial=123&timestamp=1414488825&version=1.0&sign=FF1A406564EE701064450CA2149E2514 
    
{
JAVA示例代码
}
    


版本说明

关闭
V1.0
2020年04月17日
1. 公众号纯签约接口上线

技术咨询

反馈有奖