适用对象:直连商户
请求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¬ify_url=www.qq.com%2Ftest%2Fpapay&plan_id=106&request_serial=123×tamp=1414488825&version=1.0&sign=FF1A406564EE701064450CA2149E2514