银联商务天满服务平台
Java PHP Python



import com.chinaums.open.api.OpenApiCache;
import com.chinaums.open.api.OpenApiContext;
import com.chinaums.open.api.constants.ConfigBean;
import com.chinaums.open.api.internal.util.http.HttpTransport;
import java.util.UUID;

public class OpenApiSdkTest {
    public static void main(String[] args) throws Exception{
        String url = "v1/datacenter/smartverification/encrypted/legalperson/query";
        //开发者ID
        String appId = "平台分配";
        //开发者秘钥
        String appKey = "平台分配";
        //实例化客户端
        ConfigBean configBean = new ConfigBean();
        OpenApiContext context = new OpenApiContext();
        String request = "{\"data\":\"\"}";
        context.setStartTime(System.currentTimeMillis());
        context.setRequestId(UUID.randomUUID().toString().replace("-", ""));
        context.setOpenServUrl(url.split("/v")[0].concat("/"));
        context.setApiServiceUrl(url);
        context.setVersion(url.split("/")[3]);
        context.setAppId(appId);
        context.setAppKey(appKey);
        context.setConfigBean(configBean);
        context.setServiceCode(url.split("/v")[1].substring(1));
        OpenApiCache.getCurrentToken(context);
        System.out.println(HttpTransport.getInstance().doPost(context, request));
    }
}
<?php
require_once "../utils/Log.php";
require_once "../utils/Tools.php";
require_once "../DefaultOpenApiClient.php";
class DataRequest

{
    public $url = "";
    public $serviceCode = "";
    public $apiVersion ="";
    public $needToken = true;
    public $needDataTag = false;
    public $data;

    function __construct($data, $url)
    {
        $this->data = $data;
        $apiVersion = preg_split("/[/]+/s",$url)[2];
        $this->apiVersion = $apiVersion;
        $serviceCode = strstr($url,$apiVersion);
        $this->url = strstr($url,"/".$apiVersion,true);
        $this->serviceCode = preg_replace("/^" . preg_quote($apiVersion, "/") . "/", "", $serviceCode);
    }
}

class DataDemo{
    public function main(){
        $appid = "平台分配";
        $appkey = "平台分配";
        $url = "v1/datacenter/smartverification/encrypted/legalperson/query";
        $data = json_encode(array("data"=>""));
        $reqiest = new DataRequest($data,$url);
        $client = new DefaultOpenApiClient();
        $content = $client->execute($reqiest,$appid,$appkey);
        $obj = json_decode($content);
        print_r($obj->errCode);
        print_r($obj->errInfo);
    }
}
$p = new DataDemo();
$p->main();
?>
# -*- coding: utf-8 -*-
from webapi.DefaultOpenApiClient import DefaultOpenApiClient

url = "v1/datacenter/smartverification/encrypted/legalperson/query"

class DataRequest(object):
    def __init__(self, data: dict) -> dict:
        self.data = data
        self.serviceCode = url[len(url.split("/v")[0])+len(url.split("/")[3])+1: len(url)]
        self.apiVersion = url.split("/")[3]
        self.needToken = True
        self.needDataTag = True

appId="平台分配"
appKey="平台分配"
client = DefaultOpenApiClient(appId, appKey)
cls = DataRequest({\"data\":\"\"})
response = client.execute(cls)
print(str(response.get("data")))
print(response.get("errCode"))
print(response.get("errInfo"))
print(response.get("resultCode"))
print(response.get("resultInfo"))

法人信息验证

URL

  • 生产环境: POST https://api-mop.chinaums.comv1/datacenter/smartverification/encrypted/legalperson/query

描述:进行法人信息验证操作

ContentType:HTTP(S) + JSON

请求头

名称 必填 描述 示例值
Authorization 认证内容
Content-Type application/json;charset=utf-8

请求参数

名称 类型 必填 最大长度 描述 示例值
data stringObject 加密数据
   userNo string - 用户号
   serviceType string - 服务类型。取值范围:1
   enterpriseName string - 企业名称。企业名称与企业唯一标识至少上送一个
   enterpriseNo string - 企业唯一标识
   legalPersonName string - 法人姓名
   legalPersonCert string - 法人身份证

响应示例

{
  "errCode":"20000000 – 成功",
  "errInfo":"",
  "data":""
}

响应参数

名称 类型 必填 最大长度 描述 示例值
errCode string - 错误代码 详见错误码说明 20000000 – 成功
errInfo string - 错误说明
data stringObject 加密数据
   respCode string - 应答码
   respMsg string - 应答码描述
   detailRespCode string - 细分应答码
   detailRespMsg string - 细分应答码描述
   resultCode string - 第三方返回错误代码
   resultInfo string - 第三方返回错误信息
   serviceType string - 服务类型。取值范围:1
   enterpriseName string - 企业名称
   enterpriseNo string - 企业唯一标识
   legalPersonName string - 法人姓名
   legalPersonCert string - 法人身份证

错误码

错误码 错误描述 解决方案
00 验证一致 应答码
01 验证不一致 应答码
02 不支持验证 应答码
03 验证要素格式有误 应答码
04 系统异常 应答码
05 超出权限 应答码
0000 企业名称、企业标识、法人姓名、法人身份证均一致 细分应答码
0001 企业名称与企业标识、法人姓名一致,法人身份证不一致 细分应答码
0010 企业名称与企业标识、法人身份证一致,法人姓名不一致 细分应答码
0011 企业名称与企业标识一致,法人姓名、法人身份证不一致 细分应答码
0200 企业名称与法人姓名、法人身份证一致,企业标识为空未上送 细分应答码
0210 企业名称与法人身份证一致,法人姓名不一致,企业标识为空未上送 细分应答码
1000 企业标识与法人姓名、法人身份证一致,企业名称不一致 细分应答码
1001 企业标识与法人姓名一致,企业名称、法人身份证不一致 细分应答码
1010 企业标识与法人身份证一致,企业名称、法人姓名不一致 细分应答码
1011 企业标识一致,企业名称、法人姓名、法人身份证不一致 细分应答码
1111 企业名称、企业标识、法人姓名、法人身份证均不一致 细分应答码
1200 法人姓名与法人身份证一致,企业名称不一致,企业标识为空未上送 细分应答码
1210 法人身份证一致,企业名称与法人姓名不一致,企业标识为空未上送 细分应答码
1211 企业名称与法人姓名一致,法人身份证不一致,企业标识为空未上送 细分应答码
2000 企业标识与法人姓名、法人身份证一致,企业名称为空未上送 细分应答码
2001 企业标识与法人姓名一致,法人身份证不一致,企业名称为空未上送 细分应答码
2010 企业标识与法人身份证一致,法人姓名不一致,企业名称为空未上送 细分应答码
2011 企业标识一致,法人姓名、法人身份证不一致,企业名称为空未上送 细分应答码
2111 企业标识与法人姓名、法人身份证不一致,企业名称为空未上送 细分应答码
4005 姓名格式错误 细分应答码
4006 企业名称和企业标识不得同时为空 细分应答码
4007 法人姓名不得为空 细分应答码
4008 法人身份证不得为空 细分应答码
4009 法人姓名和法人身份证均不得为空 细分应答码
5001 接口未授权该服务类 细分应答码
3001 查询成功且无结果 细分应答码
3002 上游接口报错 细分应答码
4003 无效证件号 细分应答码
5000 未知商户,不予通过 细分应答码
2002 无效服务编号 细分应答码