文档中心 > API类目 > 历史接口

alipay.user.userinfo.share (支付宝钱包用户信息共享)

外部应用上架到支付宝钱包,当支付宝用户从钱包访问外部应用时,会跳转到外部应用并带上用户的授权码。 外部应用用授权码调用授权令牌交换API(alipay.system.oauth.token)可得到授权令牌。 用授权令牌调用此接口得到支付宝会员相关信息。 特别说明:此接口的不需要授权是指不需外部应用主动引导用户授权,支付宝钱包会在引导用户授权后, 带上授权码再跳转到外部应用。

公共参数

请求地址:
环境 HTTPS请求地址
正式环境 https://openapi.alipay.com/gateway.do
公共请求参数:
参数 类型 是否必填 最大长度 描述 示例值
app_id String 32 支付宝分配给开发者的应用ID 2014072300007148
method String 128 接口名称 alipay.user.userinfo.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 针对用户授权接口,获取用户相关数据时,用于标识用户授权关系。详见用户信息授权
app_auth_token String 40 详见应用授权概述

请求参数

参数 类型 是否必填 最大长度 描述 示例值

公共响应参数

参数 类型 是否必填 最大长度 描述 示例值
code String - 网关返回码,详见文档 40004
msg String - 网关返回码描述,详见文档 Business Failed
sub_code String - 业务返回码,详见文档 ACQ.TRADE_HAS_SUCCESS
sub_msg String - 业务返回码描述,详见文档 交易已被支付
sign String - 签名,详见文档 DZXh8eeTuAHoYE3w1J+POiPhfDxOYBfUNn1lkeT/V7P4zJdyojWEa6IZs6Hz0yDW5Cp/viufUb5I0/V5WENS3OYR8zRedqo6D+fUTdLHdc+EFyCkiQhBxIzgngPdPdfp1PIS7BdhhzrsZHbRqb7o4k3Dxc+AAnFauu4V6Zdwczo=

响应参数

参数 类型 是否必填 最大长度 描述 示例值
avatar String 选填 200 用户头像 http://tfsimg.alipay.com/images/partner/T1uIxXXbpXXXXXXXX
user_type_value String 选填 2 用户类型(1/2)
1代表公司账户2代表个人账户
1
user_status String 选填 2 用户状态(Q/T/B/W)。
Q代表快速注册用户
T代表已认证用户
B代表被冻结账户
W代表已注册,未激活的账户
T
gender String 选填 10 性别(F:女性;M:男性) F
is_certified String 选填 1 是否通过实名认证。T是通过 F是没有实名认证 T
province String 选填 20 省份名称。 安徽省
city String 选填 20 市名称。 安庆
is_student_certified String 选填 1 是否是学生 T
alipay_user_id String 必填 20 支付宝用户ID 2088156897126906
nick_name String 选填 200 用户昵称 哈哈就是我

请求示例

  • JAVA
  • .NET
  • PHP
  • HTTP请求源码
AlipayClient alipayClient = new DefaultAlipayClient("https://openapi.alipay.com/gateway.do","app_id","your private_key","json","GBK","alipay_public_key","RSA2");
AlipayUserUserinfoShareRequest request = new AlipayUserUserinfoShareRequest();
AlipayUserUserinfoShareResponse response = alipayClient.execute(request);
if(response.isSuccess()){
System.out.println("调用成功");
} else {
System.out.println("调用失败");
}

响应示例

  • JSON示例
{
	"alipay_user_userinfo_share_response":{
		"user_status":"T",
		"gender":"F",
		"province":"安徽省",
		"is_certified":"T",
		"city":"安庆",
		"user_type_value":"1",
		"nick_name":"哈哈就是我",
		"alipay_user_id":"2088156897126906",
		"avatar":"http://tfsimg.alipay.com/images/partner/T1uIxXXbpXXXXXXXX",
		"is_student_certified":"T"
	}
}

异常示例

  • JSON示例
{
	"error_response":{
		"msg":"Service Currently Unavailable",
		"code":"20000",
		"sub_msg":"系统繁忙",
		"sub_code":"isp.unknow-error"
	},
	"sign":"ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE"
}

业务错误码

错误码 错误描述 解决方案
isv.invalid-argument 参数不正确,缺少auth_token参数 输入正确的auth_token
isv.invalid-token auth_token为无效的令牌 请确认令牌有效
aop.unknow-error 支付宝系统异常 重试或联系小二
isp.unknow-error 支付宝系统繁忙 重试或请联系小二

公共错误码

返回
顶部