蚂蚁账户新产品集成方案
账户新判断接口接入流程
更新时间：2017/11/10
访问次数：491
创建应用
要在您的应用中使用支付宝开放产品的接口能力，您需要先去蚂蚁金服开放平台（open.alipay.com），在开发者中心创建登记您的应用，此时您将获得应用唯一标识（APPID）。
配置密钥
开发者调用接口前需要先生成RSA密钥，RSA密钥包含应用私钥(APP_PRIVATE_KEY)、应用公钥(APP_PUBLIC_KEY）。生成密钥后在开放平台管理中心进行密钥配置，配置完成后可以获取支付宝公钥(ALIPAY_PUBLIC_KEY)。详情请参考《配置应用环境》。
搭建和配置开发环境
- 下载服务端SDK
为了帮助开发者调用开放接口，我们提供了开放平台服务端SDK，包含JAVA、PHP和.NET三个语言版本，封装了签名&验签、HTTP接口请求等基础功能。请先下载对应语言版本的SDK并引入您的开发工程。
各语言版本服务端SDK详细使用说明，请参考《服务端SDK使用说明》 - 接口调用配置
在SDK调用前需要进行初始化，代码如下：
AlipayClient alipayClient = new DefaultAlipayClient(URL,APP_ID,APP_PRIVATE_KEY,FORMAT,CHARSET,ALIPAY_PUBLIC_KEY,SIGN_TYPE);
关键参数说明：
| 配置参数 | 示例值解释 | 获取方式/示例值 |
|---|---|---|
| URL | 支付宝网关（固定） | https://openapi.alipay.com/gateway.do |
| APPID | APPID即创建应用后生成 | 获取见上面[创建应用] |
| APP_PRIVATE_KEY | 开发者私钥，由开发者自己生成 | 获取详见上面[配置密钥] |
| FORMAT | 参数返回格式，只支持json | json（固定） |
| CHARSET | 编码集，支持GBK/UTF-8 | 开发者根据实际工程编码配置 |
| ALIPAY_PUBLIC_KEY | 支付宝公钥，由支付宝生成 | 获取详见上面[[配置密钥] |
| SIGN_TYPE | 商户生成签名字符串所使用的签名算法类型，目前支持RSA2和RSA，推荐使用RSA2 | RSA2 |
接下来，就可以用alipayClient来调用具体的API了。alipayClient只需要初始化一次，后续调用不同的API都可以使用同一个alipayClient对象。
API说明
- 商户查询商户的用户是否是支付宝新用户（支付新，登陆新）。
- 符合条件的用户投放权益，引导商户的会员进行支付宝场景转化。
- 不支持第三方应用授权接入模式。
接口调用流程如下：
关键入参
| 参数名称 | 参数说明 |
|---|---|
| mobile | 用户手机号码 |
| scene | 场景码，商户可自己指定，后提供给支付宝业务经理，支付宝后台需配置 |
| query_tags | 该字段受scene控制，支付宝会根据scene分配可以查询的标签 |
关键出参
| 参数名称 | 参数说明 |
|---|---|
| tags_result | 对于传入的tag进行输出，格式为json，true表示是 fasle表示否，invalid表示无法判断，例如传入的账号不存在 |
API列表
| 中文名称 | 英文名称 | 文档说明 |
|---|---|---|
| 蚂蚁账户新 | alipay.user.newscene.tag.query | 蚂蚁账户新 |
相关接入产品
收发现金红包App支付
手机网站支付
