商家会员卡的 (会员卡开卡接口)在给用户发卡时,必传用户的 user_uni_id 和 auth_token。
- user_uni_id:用户唯一标识, 根据 user_id_type 类型来定 ,目前暂支持支付宝 userid。
支付宝 userid 说明:支付宝用户号是以 2088 开头的 16 位纯数字组成。
- auth_token:针对用户授权接口,获取用户相关数据时,用于标识用户授权关系。
开卡组件返回(推荐)
用户访问 商家会员卡产品 中 (获取会员卡领卡投放链接接口)生成的投放链接,访问成功后会有相关的 auth_code 数据返回到投放链接接口中的 callback 配置的地址上,商家需在这个地址进行 get 方式接收,然后进行调用 alipay.system.oauth.token(换取授权访问令牌接口)进行获取相关的 user_id 参数值。
注意:
- callback 参数值配置要和应用上的授权回调地址一致,可查看 授权回调地址如何配置。 小程序上的商家会员卡产品中的投放链接接口是不能传递 callback 这个参数的,相关的数据是直接在小程序端进行获取,具体详细可参考小程序的 说明。
- 通过 获取会员信息,scope=auth_ecard(商家会员卡)的自拼接授权链接方式,于 2020-08-06 开始下架,不再支持。所有通过老授权新发放的卡都无法在卡包内显示,已发放的不影响。
(获取会员卡领卡投放链接接口)会返回一个领卡链接,当用户在支付宝客户端打开领卡链接确认领卡会跳转到商家授权回调地址 callback 页面,跳转的参数带有 auth_code,调用 alipay.system.oauth.token(换取授权访问令牌接口)获取 auth_token。
用户跳转授权回调地址返回示例如下:
https://回调地址?app_id=***&auth_code=40a04bb1ef76489dbe80512f3539ux86&state=bwnhcmq=&scope=auth_base,auth_user,auth_ecard&template_id=20191217000000002153778000300338&request_id=20191217017863949922163947864&out_string=test_callback
- 获取 user_uni_id 和 auth_token 都可通过商家会员卡的开卡组件进行配置获取。
- 通过开卡组件投放链接返回的 auth_code,调用调用换取授权访问令牌后,根据该 auth_token 可调用 alipay.user.info.share(支付宝会员授权信息查询接口)获取用户信息。
注意:小程序不支持使用 alipay.user.info.share 接口。