公众号调起签约api

https://api.mch.weixin.qq.com/papay/partner/entrustweb

否

GET

请求appid

appid

是

String(32)

wxcbda96de0b165486

服务商商户号绑定的APPID

商户号

mch_id

是

String(32)

1200009811

服务商商户号

特约商户公众账号ID

sub_appid

否

String(32)

wxcbda96de0b165489

子商户号绑定的服务号的appid(非必填，如需操作，需要服务商在商户平台为子商户绑定)

特约商户号

sub_mch_id

是

String(32)

1900000109

子商户号

模板id

plan_id

是

String(28)

12535

协议模板id，设置路径见开发步骤。

签约协议号

contract_code

是

String(128)

100000

商户侧的签约协议号，由商户生成

请求序列号

request_serial

是

int64

1000

商户请求签约时的序列号，商户侧须唯一。序列号主要用于排序，不作为查询条件，纯数字。长度不超过12位

用户账户展示名称

contract_display_account

是

String(128)

微信代扣

签约用户的名称，用于页面展示，参数值不支持UTF8非3字节编码的字符，例如表情符号，所以请勿传微信昵称到该字段

回调通知url

notify_url

是

String

https://weixin.qq.com

用于接收签约成功消息的回调通知地址，以http或https开头。请对notify_url参数值进行encode处理,注意是对参数值进行encode，例如参数为notify_url=“https://weixin.qq.com”，则需要encode的内容为https://weixin.qq.com

版本号

version

是

string

1.0

固定值1.0

签名

sign

是

String(32)

C380BEC2BFD727A4B6845133519F3AD6

详见签名生成算法

时间戳

timestamp

是

String(10)

1414488825

系统当前时间，10位

以下字段为非必填项，用来控制签约页面结束后的返回路径（不传此参数，则签约完成后停留在微信内）:

返回web

return_web

否

int

1

1表示返回签约页面的referrer url, 不填或获取不到referrer则不返回; 跳转referrer url时会自动带上参数from_wxpay=1

返回状态码

return_code

是

SUCCESS

String(16)

SUCCESS/FAIL
此字段是通信标识，非交易标识，交易是否成功需要查看result_code来判断

返回信息

return_msg

否

签名失败

String(128)

返回信息，如非空，为错误原因
签名失败
参数格式校验错误

以下字段在return_code为SUCCESS的时候返回

业务结果

result_code

是

SUCCESS

String(16)

SUCCESS/FAIL

以下字段在return_code 和result_code都为SUCCESS的时候有返回

商户号

mch_id

是

10000098

String(32)

微信支付分配的商户号

子商户号

sub_mch_id

是

1900000109

String(32)

微信支付分配的子商户号

签约协议号

contract_code

是

100001256

String(128)

签约协议号

模板id

plan_id

是

123

String

协议模板id

用户标识

openid

是

onqOjjmM1tad-3ROpncN-yUfa6ua

String(32)

Appid下，用户的唯一标识

用户子标识

sub_openid

否

oUpF8uMuAJO_M2pxb1Q9zNjWeS6o

String(32)

sub_appid下，用户的唯一标识

签名

sign

是

C380BEC2BFD727A4B6845133519F3AD6

String(32)

详见签名生成算法

变更类型

change_type

是

ADD

String(32)

有两个变更类型取值:
ADD--签约
DELETE--解约

操作时间

operate_time

是

2015-07-01 10:00:00

String

操作时间

委托代扣协议id

contract_id

是

Wx15463511252015071056489715

String（32）

签约成功后，微信返回的委托代扣协议id

协议到期时间

contract_expired_time

否

2016-07-01 10:00:00

String

协议到期时间，当change_type为ADD时有返回

协议解约方式

contract_termination_mode

否

3

int

当change_type为DELETE时有返回
0-未解约
1-有效期过自动解约
2-用户主动解约
3-商户API解约
4-商户平台解约
5-注销

请求序列号

request_serial

是

1695

int64

商户请求签约时的序列号，商户侧须唯一,纯数字。长度不超过12位

返回状态码

return_code

是

SUCCESS

String(16)

SUCCESS/FAIL
SUCCESS表示商户接收通知成功并校验成功

返回信息

return_msg

否

OK

String(32)

返回信息，如非空，为错误原因
签名失败
参数格式校验错误