文档
测试

个人实人认证

POST
https://test.wellsign.cn/matrix/client/person/authentication

接口描述

个人实人认证(调用此接口后必须调用个人实人认证结果确认接口,否则会出现认证失败情况下已扣份数没有返还情况)

请求头

参数名
类型
描述
必填
token
string
新版后台 token
必填

请求参数

参数名
类型
描述
必填
verifyType
int
认证类型 1:阿里云(app),2:支付宝,3:阿里云(小程序),4:阿里云金融级认证(app),5:阿里云金融级认证(小程序)
必填
idCardNumber
string
支付宝认证、阿里云(小程序)、阿里云金融级认证,身份证号
可选
realName
string
支付宝认证、阿里云(小程序)、阿里云金融级认证,真实姓名
可选
bizCode
string
支付宝认证bizCode
可选
returnUrl
string
支付宝认证returnUrl
可选
code
string
短信验证码
可选
phone
string
绑定手机号
可选
teamId
int
使用团队进行个人实名认证的团队id
可选
signLinkSendObjectId
string
通过签字链接进行实名认证的签字链接sendObjectId(旧)
可选
useCoins
string
是否使用份数(为了兼容小程序上传文件接口,此参数需传string类型的boolean值,例:“true”、“false”)
必填
faceImageFile
file
使用阿里云(小程序)认证时须上传的用户头像
可选
realNamePassword
string
实名签署密码
可选
signLinkId
int
通过签字链接进行实名认证的签字链接signLinkId(新)
可选
metaInfo
string
(阿里云金融级认证) MetaInfo环境参数,需要通过客户端SDK获取
可选
identityType
int
认证方式,使用支付宝认证时有效,默认为1(1:内地居民身份证 2:港澳居民居住证 3:台湾居民居住证 4:港澳居民来往内地通行证 5:台湾居民来往内地通行证)
可选

响应参数

参数名
类型
描述
必填
code
int
响应码。0:成功;其他代表错误
必填
msg
string
提示信息
必填
data
object
数据字典
必填
authAccessValue
string
各平台的认证token
必填
realNameStatus
int
当前的认证状态
必填
certifyId
object
支付宝 和 阿里云金融级认证返回
必填

说明 / 示例

{ "code": 0, "msg": "success", "data": { "authAccessValue": "https://openapi.alipay.com/gateway.do?alipay_sdk=alipay-sdk-java-4.8.10.ALL&app_id=2016092701986160&biz_content=%7B%22certify_id%22%3A%2231689d03b769e3a81f5a7ea6453fb873%22%7D&charset=UTF-8&format=json&method=alipay.user.certify.open.certify&sign=G3FXC8D2Q%2BqPjWJAk%2BqnGXr4Wh0leD9Zr1ccropla1EUy3lk0bXbBekSJWLCBlCtI3X%2BQx1M2IOvvbYZGROcpl7tQZ3C1AVowIc%2B3X06E7zRSUO2p7qDrwRDAY8enQcXRzoUv8bimR0WAtam30G9uFLTti8X1or3pb%2F5YewlGCAJ98DWql9Eei8rRbE7Dl1vYaMagIQKOQ4H0iq9kJVhjfFkFb07hj%2BCFcqkOBhlgOoOwy2dSt0fgR4K3tvdv9Ka5C%2F7YoPO%2FiD%2F5ThZCAMUafSVOTkrn6YUjlKo9Xmg9or61skqoIYBsZXZ%2B7BocqWTatW%2FmKY77HCGsAZQTrdZPg%3D%3D&sign_type=RSA2&timestamp=2021-11-19+15%3A41%3A52&version=1.0", "realNameStatus": 1, "certifyId": "31689d03b769e3a81f5a7ea6453fb873" } }