本文介绍了卡证核身方案银行卡二三四要素认证的Java SDK调用示例。

SDK使用说明

如果需要其他语言的SDK示例代码,您可以通过OpenAPI开发者门户在线调试工具调试API接口。该工具会自动生成相应API的SDK调用示例代码,详细信息,请参见:

调用VerifyBankElement接口

前提条件

使用Maven引入SDK

<dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>cloudauth20200618</artifactId>
    <version>1.0.5</version>
</dependency>

示例

  • 方式一:使用证件图片的URL认证示例
    import java.util.Arrays;
    import java.util.List;
    
    import com.aliyun.cloudauth20200618.Client;
    import com.aliyun.cloudauth20200618.models.VerifyBankElementRequest;
    import com.aliyun.cloudauth20200618.models.VerifyBankElementResponse;
    import com.aliyun.tea.TeaException;
    import com.aliyun.tea.TeaUnretryableException;
    import com.aliyun.tearpc.models.Config;
    import com.aliyun.teautil.models.RuntimeOptions;
    
    public class VerifyBankElementTest {
    
        public static void main(String[] args) throws Exception {
    
            // 通过以下代码创建API请求并设置参数。
            VerifyBankElementRequest request = new VerifyBankElementRequest();
            // 场景ID。
            request.setSceneId(xxxxL);
            request.setOuterOrderNo(商户请求的唯一标识);
            request.setMode(OCR_VERIFY_BANK_CARD);
            request.setIdName(张三);
            request.setIdNo(18位身份证号);
            request.setMobile(手机号);
            //request.setBankCardNo(银行卡号);
            request.setBankCardUrl(银行卡证件http、https地址);
    
            // 推荐,支持服务路由。
            VerifyBankElementResponse response = bankElementSmartVerifyAutoRoute(request);
    
            // 不支持服务自动路由。
            //BankElementSmartVerifyResponse response = bankElementSmartVerify(cloudauth.cn-shanghai.aliyuncs.com, request);
    
            System.out.println(response.getRequestId());
            System.out.println(response.getCode());
            System.out.println(response.getMessage());
            System.out.println(response.getResultObject().getPassed());
            System.out.println(response.getResultObject().getSubCode());
            System.out.println(response.getResultObject().getCertifyId());
            System.out.println(response.getResultObject().getMaterialInfo());
        }
    
        private static VerifyBankElementResponse bankElementSmartVerifyAutoRoute(VerifyBankElementRequest request) {
            // 第一个为主区域Endpoint,第二个为备区域Endpoint。
            List<String> endpoints = Arrays.asList(cloudauth.cn-shanghai.aliyuncs.com, cloudauth.cn-beijing.aliyuncs.com);
            VerifyBankElementResponse lastResponse = null;
            for (String endpoint : endpoints) {
                try {
                    VerifyBankElementResponse response = bankElementSmartVerify(endpoint, request);
                    lastResponse = response;
    
                    // 服务端错误,切换到下个区域调用。
                    if (response != null && "500".equals(response.getCode())) {
                        continue;
                    }
    
                    return response;
                } catch (Exception e) {
                    // 网络异常,切换到下个区域调用。
                    if (e.getCause() instanceof TeaException) {
                        TeaException teaException = ((TeaException)e.getCause());
                        if (teaException.getData() != null && "ServiceUnavailable".equals(
                            teaException.getData().get("Code"))) {
                            continue;
                        }
                    }
    
                    if (e.getCause() instanceof TeaUnretryableException) {
                        continue;
                    }
                }
            }
    
            return lastResponse;
        }
    
        private static VerifyBankElementResponse bankElementSmartVerify(String endpoint, VerifyBankElementRequest request)
            throws Exception {
            // 通过以下代码创建Config实例并初始化。
            Config config = new Config();
            // 您的AccessKey ID。
            config.setAccessKeyId(您的AccessKey ID);
            // 您的AccessKey Secret。
            config.setAccessKeySecret(您的AccessKey Secret);
            // 设置您的Endpoint。
            config.setEndpoint(endpoint);
            // 设置https代理。
            //config.setHttpsProxy(https://xx.xx.xx.xx:xxxx);
            // 设置http代理。
            //config.setHttpProxy(http://xx.xx.xx.xx:xxxx);
            Client client = new Client(config);
    
            // 创建RuntimeObject实例并设置运行参数。
            RuntimeOptions runtime = new RuntimeOptions();
            // 设置连接超时时间(单位ms)。
            runtime.readTimeout = 10000;
            // 设置调用超时时间(单位ms)。
            runtime.connectTimeout = 10000;
            // 设置是否自动重试。
            runtime.autoretry = false;
    
            return client.verifyBankElement(request, runtime);
        }
    }
  • 方式二:使用本地证件文件路径认证示例
    import java.io.FileInputStream;
    import java.io.InputStream;
    import java.util.Arrays;
    import java.util.List;
    
    import com.aliyun.cloudauth20200618.Client;
    import com.aliyun.cloudauth20200618.models.VerifyBankElementAdvanceRequest;
    import com.aliyun.cloudauth20200618.models.VerifyBankElementResponse;
    import com.aliyun.tea.TeaException;
    import com.aliyun.tea.TeaUnretryableException;
    import com.aliyun.tearpc.models.Config;
    import com.aliyun.teautil.models.RuntimeOptions;
    
    public class BankElementSmartVerifyDemo2 {
    
        public static void main(String[] args) throws Exception {
    
            // 通过以下代码创建API请求并设置参数。
            VerifyBankElementAdvanceRequest request = new VerifyBankElementAdvanceRequest();
            // 场景ID。
            request.setSceneId(xxxxL);
            request.setOuterOrderNo(商户请求的唯一标识);
            request.setMode(OCR_VERIFY_BANK_CARD);
            request.setIdName(张三);
            request.setIdNo(18位身份证号);
            request.setMobile(手机号);
            //request.setBankCardNo(银行卡号);
    
            InputStream inputStream = new FileInputStream(银行卡本地文件路径);
            request.setBankCardFileObject(inputStream);
    
            // 推荐,支持服务路由。
            VerifyBankElementResponse response = bankElementSmartVerifyAutoRoute(request);
    
            // 不支持服务自动路由。
            // BankElementSmartVerifyResponse response = bankElementSmartVerify(cloudauth.cn-shanghai.aliyuncs.com, request);
    
            System.out.println(response.getRequestId());
            System.out.println(response.getCode());
            System.out.println(response.getMessage());
            System.out.println(response.getResultObject().getPassed());
            System.out.println(response.getResultObject().getSubCode());
            System.out.println(response.getResultObject().getCertifyId());
            System.out.println(response.getResultObject().getMaterialInfo());
    
            // 通过以下代码关闭资源。
            inputStream.close();
        }
    
        private static VerifyBankElementResponse bankElementSmartVerifyAutoRoute(VerifyBankElementAdvanceRequest request) {
            // 第一个为主区域Endpoint,第二个为备区域Endpoint。
            List<String> endpoints = Arrays.asList(cloudauth.cn-shanghai.aliyuncs.com, cloudauth.cn-beijing.aliyuncs.com);
            VerifyBankElementResponse lastResponse = null;
            for (String endpoint : endpoints) {
                try {
                    VerifyBankElementResponse response = bankElementSmartVerify(endpoint, request);
                    lastResponse = response;
    
                    // 服务端错误,切换到下个区域调用。
                    if (response != null && "500".equals(response.getCode())) {
                        continue;
                    }
    
                    return response;
                } catch (Exception e) {
                    // 网络异常,切换到下个区域调用。
                    if (e.getCause() instanceof TeaException) {
                        TeaException teaException = ((TeaException)e.getCause());
                        if (teaException.getData() != null && "ServiceUnavailable".equals(teaException.getData().get("Code"))) {
                            continue;
                        }
                    }
    
                    if (e.getCause() instanceof TeaUnretryableException) {
                        continue;
                    }
                }
            }
    
            return lastResponse;
        }
    
        private static VerifyBankElementResponse bankElementSmartVerify(String endpoint, VerifyBankElementAdvanceRequest request)
            throws Exception {
            // 通过以下代码创建Config实例并初始化。
            Config config = new Config();
            // 您的AccessKey ID。
            config.setAccessKeyId(您的AccessKey ID);
            // 您的AccessKey Secret。
            config.setAccessKeySecret(您的AccessKey Secret);
            // 设置您的Endpoint。
            config.setEndpoint(endpoint);
            // 设置https代理。
            //config.setHttpsProxy(https://xx.xx.xx.xx:xxxx);
            // 设置http代理。
            //config.setHttpProxy(http://xx.xx.xx.xx:xxxx);
            Client client = new Client(config);
    
            // 创建RuntimeObject实例并设置运行参数。
            RuntimeOptions runtime = new RuntimeOptions();
            // 设置连接超时时间(单位ms)。
            runtime.readTimeout = 10000;
            // 设置调用超时时间(单位ms)。
            runtime.connectTimeout = 10000;
            // 设置是否自动重试。
            runtime.autoretry = false;
    
            return client.verifyBankElementAdvance(request, runtime);
        }