通过此接口发起实名认证,同步返回认证结果
测试请求地址 | 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); }