公用接口-实名认证

接口描述

通过此接口发起实名认证,同步返回认证结果

实名认证请求

基本信息

测试请求地址 https://cbtrxtest.helipay.com/cbtrx/rest/authenticate/apply
请求地址 https://cbptrx.helipay.com/cbtrx/rest/authenticate/apply
提交方式 采用POST方法提交,requestbody传值 Content-Type=[application/json;charset=UTF-8]
签名算法 UTF-8字符编码 SHA256签名 AES加密

请求参数

名称 参数 类型 必填 示例值 说明
产品编码 productCode String(20) AUTHENTICATETWO/AUTHENTICATEFOUR AUTHENTICATETWO:二要素实名认证,姓名 + 身份证号码,必传 AUTHENTICATEFOUR:四要素实名认证,使用该参数时,姓名+身份证号码+卡号+银行预留手机号,必传
实名认证订单号 orderNo String(64) p_20170302185347
商户编号 merchantNo String(10) Me10000002 合利宝-跨境系统分配的商户编号
姓名 name String(20) 张三
证件类型 cardType String(10) IDCARD 固定值(身份证):IDCARD
证件号码 cardNo String(18) 110101200001012999
卡号 accountNo String(19) 1234567890
银行预留手机号 mobile String(11) 13701234567

响应参数

名称 参数 类型 必填 示例值 说明
产品编码 productCode String(20) QUICKPAY
实名认证订单号 orderNo String(64) p_20170302185347
商户编号 merchantNo String(10) Me10000002 合利宝-跨境系统分配的商户编号
响应码 errorCode String(10) 0000 0000 代表成功发起实名认证请求,具体认证结果参见 authStatus
响应信息 errorMessage String(200) 成功 响应信息 错误信息
认证结果 authStatus String(20) SUCCESS 认证结果,返回码非0000时,authStatus为空
SUCCESS:认证通过
FAILED:认证未通过
DOING:认证中 (可通过过查单接口查询该鉴权订单状态)
平台流水号 serialNumber String(32)
响应时间 current String(20) 2018-04-01 12:00:00 格式yyyy-MM-dd HH:mm:ss

代码示例

    @Test
    public void testAuthenticate() {

        AuthenticationForm form = new AuthenticationForm();
        form.setMerchantNo("Me10000002");
        form.setProductCode("AUTHENTICATETWO");
        form.setOrderNo("TEST_AUTH_" + System.currentTimeMillis());
        form.setCardType("IDCARD");
        form.setName("测试");
        form.setCardNo("11111111111111111");

        HeliRequest request = encodeAndSign(form, form.getProductCode(), form.getMerchantNo());

        RemoteService remoteService = new RemoteServiceImpl();
        HeliRequest heliRequest = remoteService.postRemoteInvoke(LoadPropertiesUtils.getProperty("authenticationUrl"), JSONObject.toJSONString(request), HeliRequest.class);
        AuthenticationResponseForm responseForm = decode(heliRequest, AuthenticationResponseForm.class, request.getProductCode(), request.getMerchantNo());
        logger.info("实名认证返回结果:{}", responseForm);
    }