支付宝会员授权信息查询接口 -凯发app官方网站

产品地图

支付产品

私域产品

公域产品

营销产品

资金产品

会员产品

人脸认证

获取会员信息

产品介绍

接入准备

接入指南

api 列表

用户信息

用户授权

公共请求参数

参数	类型	是否必选	最大长度	描述	示例值
app_id	string	必选	32	支付宝分配给开发者的应用id	2014072300007148
method	string	必选	128	接口名称	alipay.user.info.share
format	string	可选	40	仅支持json	json
charset	string	必选	10	请求使用的编码格式，如utf-8,gbk,gb2312等	utf-8
sign_type	string	必选	10	商户生成签名字符串所使用的签名算法类型，目前支持rsa2和rsa，推荐使用rsa2	rsa2
sign	string	必选	344	商户请求参数的签名串，详见签名	详见示例
timestamp	string	必选	19	发送请求的时间，格式"yyyy-mm-dd hh:mm:ss"	2014-07-24 03:07:50
version	string	必选	3	调用的接口版本，固定为：1.0	1.0
auth_token	string	必选	40	用户授权令牌，同 access_token（用户访问令牌）。针对用户授权接口，获取用户相关数据时，用于标识用户授权关系。需使用 auth_code（用户授权码）换取此令牌，详情见用户授权
app_auth_token	string	可选	40	详见应用授权概述
biz_content	string	必选		请求参数的集合，最大长度不限，除公共参数外所有请求参数都必须放在这个参数中传递，具体参照各产品快速接入文档

业务请求参数

无业务请求参数

常见请求示例

默认示例

curl 'https://openapi.alipay.com/gateway.do?charset=utf-8&method=alipay.user.info.share&format=json&sign=${sign}&app_id=${appid}&version=1.0&sign_type=rsa2×tamp=${now}' \
 -f 'app_auth_token=${app_auth_token}' \
 -f 'auth_token=${auth_token}'

说明：本示例仅供参考。

公共响应参数

参数	类型	是否必选	最大长度	描述	示例值
code	string	必选	-	网关返回码,	40004
msg	string	必选	-	网关返回码描述,	business failed
sub_code	string	可选	-	业务返回码，参见具体的api接口文档	acq.trade_has_success
sub_msg	string	可选	-	业务返回码描述，参见具体的api接口文档	交易已被支付
sign	string	必选	-	签名,	dzxh8eetuahoye3w1j poiphfdxoybfunn1lket/v7p4zjdyojwea6izs6hz0ydw5cp/viufub5i0/v5wens3oyr8zredqo6d futdlhdc efyckiqhbxizgngpdpdfp1pis7bdhhzrszhbrqb7o4k3dxc aanfauu4v6zdwczo=

业务响应参数

avatar必选string(400)

【描述】用户头像地址。注意：如果没有数据（用户未设置）时不会返回该信息，请做好容错。

【示例值】http://tfsimg.alipay.com/images/partner/t1uixxxbpxxxxxxxx

city必选string(20)

【描述】市名称。

【示例值】安庆

nick_name必选string(50)

【描述】用户昵称。注意：如果没有数据（用户未设置）时不会返回该信息，请做好容错。

【示例值】支付宝小二

province必选string(20)

【描述】省份名称。

【示例值】安徽省

以下参数二选一

user_idstring(16)

【描述】支付宝用户的userid。

新商户建议使用open_id替代该字段。对于新商户，user_id字段未来计划逐步回收，存量商户可继续使用。如使用open_id，请确认应用-开发配置-openid配置管理已启用。无该配置项，可查看openid配置申请。

【示例值】2088102104794936

open_id｜支付宝用户的openidstring(128)

【描述】支付宝用户的openid。详情可查看 openid简介

【示例值】074a1cctg1lelxke4xqc0zgndid0nxi95b5lsnpazwyoco5

gender特殊可选string(10)

【描述】性别。枚举值如下： f：女性； m：男性。

【示例值】f

参数	类型	是否必选	最大长度	描述	示例值
user_id	string	二选一	16	支付宝用户的userid。新商户建议使用open_id替代该字段。对于新商户，user_id字段未来计划逐步回收，存量商户可继续使用。如使用open_id，请确认应用-开发配置-openid配置管理已启用。无该配置项，可查看openid配置申请。	2088102104794936
open_id	string	128	支付宝用户的openid。详情可查看 openid简介	074a1cctg1lelxke4xqc0zgndid0nxi95b5lsnpazwyoco5
avatar	string	必选	400	用户头像地址。注意：如果没有数据（用户未设置）时不会返回该信息，请做好容错。	http://tfsimg.alipay.com/images/partner/t1uixxxbpxxxxxxxx
city	string	必选	20	市名称。	安庆
nick_name	string	必选	50	用户昵称。注意：如果没有数据（用户未设置）时不会返回该信息，请做好容错。	支付宝小二
province	string	必选	20	省份名称。	安徽省
gender	string	特殊可选	10	性别。枚举值如下： f：女性； m：男性。	f

响应示例

正常示例

异常示例

{
    "alipay_user_info_share_response": {
        "code": "10000",
        "msg": "success",
        "user_id": "2088102104794936",
        "avatar": "http://tfsimg.alipay.com/images/partner/t1uixxxbpxxxxxxxx",
        "city": "安庆",
        "nick_name": "支付宝小二",
        "province": "安徽省",
        "gender": "f"
    },
    "sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}