当前位置: 产品API > 数据 > 人机智能验证服务
产品介绍
  • 服务对象
    商户、机构
应答码参照
应答码状态列表
  • 应答码 描述 解决方案
    0000 处理成功 暂无
    0001 访问频次超限 暂无
    0002 会话已过期 暂无
    0004 失败 暂无
    2000 人机验证平台系统错误 暂无
    9901 您的IP(XXX.XXX.XXX.XXX)没有登记,请登录银联开放平台(open.unionpay.com)进行白名单登记 暂无
    9902 您的IP(XXX.XXX.XXX.XXX)已被限制访问,请登录银联开放平台(open.unionpay.com)提交申诉请求 暂无
    9903 您的IP(XXX.XXX.XXX.XXX)请求过于频繁,已被临时限制,请5分钟后再尝试 暂无
    9904 您的 IP(XXX.XXX.XXX.XXX)不属于你设置的开发IP列表,请登录银联开放平台(open.unionpay.com)确认相关配置 暂无
    9905 请求参数值有误,请确认请求参数信息 暂无
    9906 您的账号不具备当前产品请求权限,如有权限,可重新获取该产品Token后再尝试 暂无
    9907 app_id与app_secret验证失败 暂无
    9908 您的Token已过期,请重新获取Token 暂无
    9909 您的Token信息非最新Token,请确保您的系统中使用的是最新的Token值 暂无
    9910 您的签名密钥未设置,请登录银联开放平台(open.unionpay.com)确认相关配置 暂无
    9911 您的签名信息验证不通过,请检查您的签名实现是否符合银联开放平台(open.unionpay.com)提供的签名规则 暂无
    9912 您的报文格式有误,要求报文符合JSON数据格式 暂无
    9913 你的报文数据有误,未通过数据信息校验,具体原因视业务需求 暂无
    9914 您的报文无法解密,请检查您在银联开放平台(open.unionpay.com)上提供的RSA公钥是否正确 暂无
    9991 银联开放平台系统内部错误:产品服务调用失败 暂无
    9992 银联开放平台系统内部错误:产品服务系统未知错误 暂无
    9993 银联开放平台系统内部错误:产品服务未注册至服务中心 暂无
    9994 银联开放平台系统内部错误:产品服务参数错误 暂无
接入流程
接入流程

1.如需申请该API,请点击本页面“业务申请”,并认真填写相关内容;

 

2.待业务接口人审核通过后即可调用该API,审核周期约为2-3个工作日;

 

3.技术联调,可参照《“快速接入”产品API技术文档—接入指南》


报文举例

1. 获取产品调用token信息

请求URL:

https://openapi.unionpay.com/upapi/captcha/token?app_id=[value]&app_secret=[value]

应答JSON报文体:

{
       “respCd”:“0000”
       “respMsg”:“成功”    
       “token”:”fsddfssseessseee”,
       “expire_in”:7200
}


2. 注册应用

请求URL:

https://openapi.unionpay.com/upapi/captcha/regapp?token=[token]&sign=[sign]&ts=[ts]

请求JSON报文体:

{
    "busAppId":"329f055063d990a22ddd53",
    “appId”:”up_jvcvcwl92f_yiizqm”
 }

应答JSON报文体

{
    “respCd”:”0000”,
        “respMsg”:”成功”,
}


3. 初始化session

请求URL:

https://openapi.unionpay.com/upapi/captcha/initses?token=[token]&sign=[sign]&ts=[ts]

请求JSON报文体:

{
    "busAppId":"329f055063d990a22ddd53",
    "appId":"up_jvcvcwl92f_yiizqm",
    "capType":"4",
    "userId":"XXXXX",
    "expiration":"30"
 }

应答JSON报文体

{
    “respCd”:”0000”,
        “respMsg”:”成功”,
        “data”: {
        "sesId":"0e31a62d8fc64ac79502e28df5557ec4"
        }
}


4. 二次验证

请求URL:

https://openapi.unionpay.com/upapi/captcha/ensure?token=[token]&sign=[sign]&ts=[ts]

请求JSON报文体:

{
    "sesId":"aUX2ds_xaQut03A",
    "token":"61cf50fb61ad7fda4446c6513b4a3930",
    "busAppId":"329f055063d990a22ddd53",
    "appId":"up_jvcvcwl92f_yiizqm"
 }

应答JSON报文体

{
    “respCd”:”0000”,
        “respMsg”:”成功”
}


技术指南

1. “快速接入”产品API使用教程请参考在线文档:

《“快速接入”产品API指南—接入指南》


2. “快速接入”产品API安全调用过程请参考在线文档:

2.1《“快速接入”产品API指南—获取产品token》

2.2《“快速接入”产品API指南—产品功能接口调用》


3. “快速接入”产品API接口调用报文签名样例请参考在线文档:

《“快速接入”产品API指南—报文签名样例代码》


4. “快速接入”产品API测试工具使用说明请参考在线文档:

《“快速接入”产品API指南—“快速接入”测试工具》


5. 产品使用接入,参考附件文档:

人机验证平台接入指南2.0-技术开放平台.doc


API接口
了解全局token
获取token
接口描述
产品token是开放平台每个产品的全局唯一接口调用凭据,用户调用各接口时都需使用产品token。
请求方式
GET
生产地址
https://openapi.unionpay.com/upapi/captcha/token
测试地址
敬请期待
请求URL参数
名称 标识 字段类型 长度 请求要求 默认值 备注
用户唯一凭证密钥 app_secret string M-必填 详情可在登录技术开放平台后“个人中心-我的信息-API认证信息-API认证密钥”中查看   
用户唯一凭证 app_id string M-必填 详情可在登录技术开放平台后“个人中心-我的信息-API认证信息-API认证账号”中查看   
同步应答参数
名称 标识 字段类型 长度 请求要求 默认值 备注
应答码 respCd string 4 M-必填   
应答消息 respMsg string M-必填   
产品token token string C-依条件必填 获取到的凭证; 凭证是字符串   
过期时间 expire_in int C-依条件必填 凭证有效时间,单位:秒   
注册应用
接口描述
busAppId为应用在人机验证平台的标识,可用于个性化配置,应用在调用人机验证服务之前,需将自身busAppId注册在人机验证平台,只需注册一次。
请求方式
POST
生产地址
https://openapi.unionpay.com/upapi/captcha/regapp
测试地址
敬请期待
请求URL参数
名称 标识 字段类型 长度 请求要求 默认值 备注
产品token token string M-必填 详情请参考“获取token”接口中应答参数“token”的具体数据。   
签名信息 sign string M-必填 详细签名算法可参考“技术指南”板块第3条。   
时间戳 ts long M-必填 单位毫秒,对于Java一般使用System.currentTimeMillis();获取   
请求报文体参数
名称 标识 字段类型 长度 请求要求 默认值 备注
应用ID busAppId string 32 M-必填 32位字符串,由接入方生成   
应用名称 busAppNm string M-必填 1~60位接入方应用名称,由接入方生成   
用户身份 appId string M-必填 开放平台app_id   
同步应答参数
名称 标识 字段类型 长度 请求要求 默认值 备注
应答码 respCd string 4 M-必填 参考左侧菜单“应答码参照”   
应答消息 respMsg string M-必填 如果respCd不是0000,该字段解释了具体的出错原因。   
初始化session
接口描述
session为一次验证流程的信息保持会话,接入方调用人机智能服务时,需要先进行session的初始化,以sessionId作为会话标识。
请求方式
POST
生产地址
https://openapi.unionpay.com/upapi/captcha/initses
测试地址
敬请期待
请求URL参数
名称 标识 字段类型 长度 请求要求 默认值 备注
产品token token string M-必填 详情请参考“获取token”接口中应答参数“token”的具体数据。   
签名信息 sign string M-必填 详细签名算法可参考“技术指南”板块第3条。   
时间戳 ts long M-必填 单位:毫秒;对于Java一般使用System.currentTimeMillis();获取。   
请求报文体参数
名称 标识 字段类型 长度 请求要求 默认值 备注
应用ID busAppId string M-必填 参数备注信息   
用户身份 appId string M-必填 开放平台app_id   
验证码类型 capType string M-必填 1:字符型 2:数学型 3:点触型 4:滑块型   
应用用户ID userId string O-选填 可选,用于标识应用系统的唯一用户   
失效时间 expiration string M-必填 验证码失效时间,单位为秒。默认为1800秒。   
同步应答参数
名称 标识 字段类型 长度 请求要求 默认值 备注
应答码 respCd string 4 M-必填 "参考左侧菜单“应答码参照”   
应答消息 respMsg string M-必填 如果respCd不是0000,该字段解释了具体的出错原因。   
应答报文 data map C-依条件必填   
验证会话ID sesId string M-必填   
二次验证
接口描述
二次验证用于校验前端验证结果的真实性和有效性,确保验证真实非伪造。
请求方式
POST
生产地址
https://openapi.unionpay.com/upapi/captcha/ensure
测试地址
敬请期待
请求URL参数
名称 标识 字段类型 长度 请求要求 默认值 备注
产品token token string M-必填 详情请参考“获取token”接口中应答参数“token”的具体数据。   
签名信息 sign string M-必填 详细签名算法可参考“技术指南”板块第3条。   
时间戳 ts long M-必填 单位:毫秒,对于Java一般使用System.currentTimeMillis();获取。   
请求报文体参数
名称 标识 字段类型 长度 请求要求 默认值 备注
验证会话ID sesId string M-必填 参数备注信息   
验证结果令牌 busToken string M-必填 参数备注信息   
应用ID busAppId string M-必填 参数备注信息   
用户身份 appId string M-必填 开放平台app_id   
同步应答参数
名称 标识 字段类型 长度 请求要求 默认值 备注
应答码 respCd string 4 M-必填 "参考左侧菜单“应答码参照”   
应答消息 respMsg string M-必填 如果respCd不是0000,该字段解释了具体的出错原因。   
联系我们

业务咨询: 吕伟

021-20633211

lvwei@unionpay.com

技术咨询: 吕伟

021-20633211

lvwei@unionpay.com

中国银联版权所有©2002-2019沪 ICP备07032180号