银行卡有效性校验

sceneType
startTime lastTime usBiblioteka BaidurTag zmproduct
含义
相应结果 银行卡使用校验 结果 请求是否成功 是否曾经使用过 结果码
使用场景
开始使用时间 最近使用时间 最近多少天内使 用 产品结果标识
示例值
T T CU1001
01
2012-02-19 23:35:08 2015-03-11 20:38:01 最近(180, 270] 天内使用 ZM10000008
merchantId appId productId sences extParams
是否必须
是 是 是 是 是
示例值
268820000029457334041 100001
w1010100100000000010
参见业务参数部分
2) 业务参数
extParams : { "certType": "100", "certNo": "610700196509050406", "name": "牛德华",
说明
T 成功 F 失败 T 使用过 F 未使用过 CU1001 使用过 CU1002 不曾使用过 CU1000 无法判断 01 充值卡； 02 提现卡； 03 快捷卡； 04 其他转账卡； 多个场景之间以,分割
暂时无含义，商户无需关注
8. 异常码
errorCode
000000 000001 000002 000003 000300 000301
zmOpenApiRequest.setExtParams(exts); ZmOpenApiResponse openApiResponse = zmOpenApiClient.execute(zmOpenApiRequest, GATEWAY);
芝麻信用管理有限公司
应用生命周期不满足条件 API 调用次数超限，包含调用频率超限 字符集为空 字符集错误 用私钥解密参数发生错误 用公钥加密返回值发生错误 用公钥验签发生错误 用私钥加签发生错误 商户 ID 为空 商户 ID 无效 商户 ID 与 appId 不匹配 应用场景信息为空 场景信息无效 产品 ID 为空 customerId 转化成客户 roleId 错误 芝麻信用引擎处理错误 用户 id 为空 用户 id 不合法 商户对产品未签约 商户对产品的合约已失效 商户对产品的合约不在有效期内 鉴权不通过 查询芝麻产品失败 查询信用核心失败 未授权或授权已失效 授权协议未开启 授权等级不够 授权等级不正确 商户未认证 产品 id 不合法 产品 id 无效 客户不存在 计费事件码不存在 查询计费事件码异常 信用核心：查询结果为空 信用核心：不支持的方法 信用核心：不支持的证件类型 未知错误
errorMessage
系统错误 缺少 AppId 无效的 AppId 该 IP 地址不允许访问 应用调用次数超限，包括调用频率超限 应用状态不满足条件
000302 000303 000304 000305 000400 000401 000402 000403 000500 000501 000502 000503 000504 000505 000521 009000 009004 009005 009006 009007 009008 009009 009010 009011 009013 009015 009016 009017 009100 009201 009202 009300 009400 009401 009503 009505 009506 009998
610700196509050406
name
姓名
牛德华
zm_antifraud_user_info 校验信息
需要验证的信息。注意，此字段的值必须
是一个符合 json 格式的字符串。
bankCard
银行卡
6222023499922267384
7. 产品返回结果
银行卡最近使用过的情况
{ "content": { "bankCardUsage": { "isSuccess": "T", "isUsed": "T", "lastTime": "2015-03-11 20:38:01", "resultCode": "CU1001", "sceneType": "01,03", "startTime": "2012-02-19 23:35:08", "userTag": "最近(180, 270]天内使用" } }, "zmproduct": "ZM10000008"
"content": { "bankCardUsage": { "isSuccess": "T", "resultCode": "CU1000" }
}, "zmproduct": "ZM10000008" }
字段说明 字段名
content bankCardUsage isSuccess isUsed resultCode
}
银行卡未使用过的情况
{ "content": { "bankCardUsage": { "isSuccess": "T", "isUsed": "F", "resultCode": "CU1002" } }, "zmproduct": "ZM10000008"
}
银行卡未知的情况
{
芝麻信用管理有限公司
9. Java 代码样例
芝麻信用管理有限公司
String GATEWAY = “https://zmopenapi.zmxy.com.cn/gateway.do”; ZmOpenApiRequest zmOpenApiRequest = new ZmOpenApiRequest(); zmOpenApiRequest.setMerchantId("268820000029457334041"); zmOpenApiRequest.setAppId("100001"); zmOpenApiRequest.setProductId("w1010100400000000010"); zmOpenApiRequest.setSences(""); Map<String, String> exts = new HashMap<String, String>(); exts.put(“certType”, "100"); exts.put(“certNo”, " 610700196509050406"); exts.put(“name”, "牛德华");
芝麻信用管理有限公司
银行卡有效性校验
版本号：1.1
文档修订历史
版本号 1.0 1.1
作者 量利 籽薇
芝麻信用管理有限公司
备注 银行卡有效性校验 银行卡有效性校验
修订日期 2015-08-26 2015-10-14
目录
银行卡有效性校验........................................................................................................ 1 1. 产品名称..........................................................................................................3 2. 产品码..............................................................................................................3 3. 产品介绍..........................................................................................................3 4. 产品特性..........................................................................................................3 5. 产品费率..........................................................................................................3 6. 产品入参..........................................................................................................3 7. 产品返回结果..................................................................................................4 8. 异常码..............................................................................................................5 9. Java 代码样例..................................................................................................7
芝麻信用管理有限公司
1. 产品名称
银行卡有效性校验
2. 产品码
w1010100100000000010
3. 产品介绍
判断用户输入的银行卡的使用情况。包括是否使用过，使用场景，最早使用时间， 最近使用时间，最近多少天内使用。
4. 产品特性
无需用户授权
5. 产品费率
暂无
6. 产品入参
1) 系统参数
字段名
备注
商户 id 应用 id 产品 id 场景 id
芝麻信用管理有限公司
"zm_antifraud_user_info": {
" bankCard": "6222023499922267384"
}
}
字段说明
字段名
含义
示例值
certType
证件类型
100，表示身份证。当前仅支持身份证
certNo
证件号
Map<String, String> info = new HashMap<String, String>(); info.put("bankCard", "6222023499922267384"); exts.put(“zm_antifraud_user_info”, JSONObject.toJSON(info).toString());