银行卡三要素实名认证接口

      该接口适用于互联网金融、证券行业保险、在线教育、电商、租赁、物流、旅游等行业需要实名认证的场景，如实名开户，股票期货交易身份验证、保险、担保、贷款等；购买火车票飞机票、酒店人员身份核查系统等；租赁双方需网上实名备案，自行签订房屋租赁合同也包括在内。通过输入的银行卡号、持卡人姓名、持卡人身份证号，验证此三种信息是否一致，可快速校验个人身份信息。

• 接口地址：https://api.yonyoucloud.com/apis/dst/authCardWithoutOTP/authCardWithoutOTP

• 请求方式：POST

• 请求参数(header) :

参数名	必填	描述	默认值
Content-Type	true		application/json

• 请求参数(body) :

参数名	类型	是否数组	必填	描述	默认值
cardNo	string	否	是	银行卡号
idNumber	string	否	是	身份证号
userName	string	否	是	姓名

• 返回类型参数 :

参数名	类型	是否数组	必填	描述
success	boolean	否	否	请求是否成功
code	int	否	否	返回码，参考返回类别
message	string	否	否	返回信息

• 返回码（code）说明：

返回码	返回信息	中文描述
400100	Success	认证成功
400420	Parameter illegal	请求参数不合法
400422	UID Request Exception	请求处理时发生异常
400423	UID Request Timeout	请求处理时等待超时
400431	User identity not match	身份证信息不匹配
400441	Bankcard auth failed	银行卡信息认证失败
400442	Bankcard auth error	银行卡信息认证请求异常
400443	Bankcard auth timeout	银行卡信息认证请求超时

        

• PHP示例：

<?php
header('Content-type:text/html;charset=utf-8');
//配置您申请的appkey
$apicode = "*********************";
 
$url = "https://api.yonyoucloud.com/apis/dst/matchIdentity/matchIdentity";
 
$method = "POST";
 
$params = array(
        "idNumber" => "",
        "userName" => "",
 
);
 
$header = array();
$header[] = "apicode:".$apicode;
$header[] = "content-type:application/json";
$header[] = "Content-Type:application/json";
 
 
$content = linkcurl($url,$method,$params,$header);
$result = json_decode($content,true);
if($result){
    if($result['error_code']=='0'){
        print_r($result);
    }else{
        echo $result['error_code'].":".$result['reason'];
    }
}else{
    echo "请求失败";
}
 
/**
 * 请求接口返回内容
 * @param  string $url [请求的URL地址]
 * @param  string $params [请求的参数]
 * @param  int $ipost [是否采用POST形式]
 * @return  string
 */
function linkcurl($url,$method,$params=false,$header=false){
    $httpInfo = array();
    $ch = curl_init();
     
    curl_setopt($ch, CURLOPT_CUSTOMREQUEST, $method);
    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_HTTPHEADER, $header);
    curl_setopt($ch, CURLOPT_FAILONERROR, false);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
     
    if (1 == strpos("$".$url, "https://"))
    {
        curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
        curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);
    }
    curl_setopt( $ch, CURLOPT_CONNECTTIMEOUT , 60 );
    curl_setopt( $ch, CURLOPT_TIMEOUT , 60);
    curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
 
    if($method == "POST" ){
        curl_setopt( $ch , CURLOPT_POST , true );
        curl_setopt( $ch , CURLOPT_POSTFIELDS, json_encode($params) );
    }else if($params){
        curl_setopt( $ch , CURLOPT_URL , $url.'?'.http_build_query($params) );
    }
    $response = curl_exec( $ch );
    if ($response === FALSE) {
        //echo "cURL Error: " . curl_error($ch);
        return false;
    }
    $httpCode = curl_getinfo( $ch , CURLINFO_HTTP_CODE );
    $httpInfo = array_merge( $httpInfo , curl_getinfo( $ch ) );
    curl_close( $ch );
    return $response;
}
?>

博客代码无法折叠，篇幅过长，想看其他语言的点这里-“示例说明”

• 请求参数示例：

{ "userName":"小明","idNumber":"120902199912135678","cardNo","1234567890123456789"}

• JSON正确返回示例：

 

{
    "success": true,
    "code": 400100,
    "message": "成功"
}

• 错误码说明：

调用方错误：

错误码	说明	错误信息
300001	请求header中没有设置apikey	Missing apikey
300002	api不存在或url无法解析	URL cannot be resolved
300003	apikey不存在,请输入正确的apikey	apicode does not exist
300004	服务剩余次数不足，请再次购买	Service overdue, please pay in time
300005	未设置ip白名单	not int　white　ip list
300006	IP白名单中不包含您的IP	IP white list does not contain your IP
300007	系统繁忙稍候再试	Sorry,The system is busy. Please try again late
300008	访问次数超载	Request was denied due to api flow control
300009	未找到节流信息	not int apiservice paramer
300010	header参数中缺少需签名的参数值	request header do not contain param:
300011	缺少需验证的参数列表	no sign headers found!
300012	签名信息不匹配	Signature information mismatch
300013	header中缺少参数appkey	appkey does not exist in the request header
300014	header中缺少参数appsecret	appsecret does not exist
300015	api已过期,请另行购买	Your API has been expired!
300017	要求必填参数为不能为空	Requied parameter can not be null!
300018	api没有授权	The app key do not has the authorization of this api

• 服务地址：银行卡三要素实名认证
• 数据来源：用友旗下中关村银行和第三方支付公司畅捷支付直连银联，通过银联接口实时核验，非缓存数据

 

特别提醒：选择实名认证接口时一定要仔细甄别，由于身份证实名制服务提供时间已久，很多数据提供商(实则是二道贩子)利用缓存数据对外提供服务（这些历史缓存数据的源头有可能是NCIIC，这也是他们敢宣称“直连公安部接口”的原因）。目前国内预计有8亿元的缓存量市场，由于缓存的数据并没有什么成本，所以这些鱼龙混杂的公司，在市面上提供的接口调用价格甚至低至0.1元/次。实际上不仅其数据更新的及时性远远无法达到NCIIC的标准，而且留存用户信息的行为本身就是违法的，更不要说用于商业目的。这些服务商随时都面临着被查封的风险，一旦接入这种服务，如果服务商挂了，给使用接口的单位带来的损失或将是无法估量的。。。