5.1获取基础营销用户号
接口地址:
生产环境:https://vsp.allinpay.com/cusapi/wxopen/getopenidmkt
测试环境:https://syb-test.allinpay.com/vsppcusapi/wxopen/getopenidmkt
接口说明:
机构通过前端跳转方式获取通联收银宝当面付微信的openid,unionid和基础营销的userid。
一般userid可用于权益查询、领券。
第一步商户按照对接规范组装报文跳往通联接口url,需要带上redirecturl
第二步通联验证签名有效性,跳往微信授权页面进行用户授权,用户授权完成后微信回调到通联
第三步通联根据微信授权回调的code获取openid,unionid,生成mktuserid,并回调给商户页面(redirecturl)
第四步商户根据对接规范验证签名并且获取相关用户信息
请求方式:GET
请求参数:
参数 |
参数名称 |
取值 |
可空 |
最大长度 |
备注 |
appid |
应用ID |
通联平台分配的APPID |
否 |
8 |
|
apptype |
公众号类型 |
01:微信 暂只支持01 |
否 |
32 |
|
redirecturl |
跳转url |
需要进行urlencode |
否 |
128 |
|
state |
自定义字段,会原样带回 |
|
否 |
128 |
重定向后会带上state参数,开发者可以填写a-zA-Z0-9的参数值,最多128字节 |
signtype |
签名方式 |
由于url长度限制,暂只支持MD5 |
否 |
16 |
|
sign |
签名 |
|
否 |
32 |
|
样例报文:
https://syb-test.allinpay.com/vsppcusapi/wxopen/getopenidmkt?appid=00000156&apptype=01&redirecturl=https%3A%2F%2Fsyb-test.allinpay.com%2Fapiweb%2Ftesth5%2Ftestnotify&signtype=MD5&state=xxxxxx&sign=CC66B15144F7D8AAC2E4D91FEB90D16D
响应参数:
字段ID |
字段名称 |
取值 |
可空 |
最大长度 |
备注 |
appid |
应用ID |
通联平台分配的APPID |
否 |
8 |
|
openid |
微信openid |
|
否 |
128 |
|
unionid |
微信 unionid |
|
可空 |
128 |
微信模式下不为空 |
userid |
基础营销用户id |
|
否 |
32 |
|
state |
自定义字段,会原样带回 |
|
否 |
128 |
重定向后会带上state参数,开发者可以填写a-zA-Z0-9的参数值,最多128字节 |
sign |
签名 |
|
否 |
32 |
|
返回样例报文: