5.1获取基础营销用户号


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

 

 

返回样例报文:

https://syb-test.allinpay.com/apiweb/testh5/testnotify?appid=00000156&openid=oQSLgv4IUfXVd4DrAKV4m_GFKr1s&sign=499DD66D1FEEE090E08570FDB5550C9E&state=xxxxxx&unionid=oQ0OdwJMTxfiaLN-yRvY3MvHcDPk&userid=U_01uoNY8c94K


陈佳锴chenjk3 2025年4月11日 17:06 收藏文档