北京慧阅信息服务有限公司.pdf

北京慧阅信息服务有限公司 银行卡验证接口 V1.0.1 目录 1、接入方需要申请的信息3 2、接口地址3 3、请求规则3 4 、请求参数3 5、返回数据JSON 参数说明3 6、附录4 7、POST 示例4 1、接入方需要申请的信息 验证帐号(sid)，3DES 密码，Md5 密码，IVPS （固定值） 2、接口地址 /zxbank/verifyApi.do 3、请求规则 说明 描述 传输方式 采用HTTP 请求方式 采用POST 方法请求 数据格式 Json 字符串 字符编码 UTF-8 算法 MD5 校验 请求和接受数据均需要校验 4、请求参数 字段 描述 Value 备注 name 姓名(UTF-8 编码) 用3des 加密后base64 编码成string 字符串 idnum 身份证号 用3des 加密后base64 编码成string 字符串 只支持18 位 phone 电话号码 用3des 加密后base64 编码成string 字符串 sid 服务账号 vtype 02/03 02 代表三项验证，03 代表4 项验证 bankCard 银行卡号 用3des 加密后base64 编码成string 字符串 cpserialnum 请求方订单号 长度不超过20 个字符 md5num Md5 编码 bankCard (密)+idnum(密)+cpserialnum+md5 密码 字符串连接后进行md5 【注：vtype=02 时，phone 值必须为””3des 加密后的值，当 vtype=03，phone 为真实手机号3des 加密后值】 5、返回数据JSON 参数说明 字段 描述 Value 描述 cpserialnum 公司流水号 result 验证结果 BANKCONSISTENT：一致 （收费） FAIL 收费见 BANKINCONSISTENT ：不一致 （收费） 附录 BANKNOLIB ：库无 （不支持该银行卡验证）（不 收费） FAIL：验证失败 （见errmsg 描述） sysserialnum 系统验证流水 长度不超过32 个字符 FAIL 无 号 md5num Md5 编码 result+cpserialnum+sysserialnum+ md5 密码 FAIL 无 字符串连接后进行md5 errmsg 错误代码 见附录 FAIL 有 【注：当result 为FAIL 时{errmsg:ERR2014,result:FAIL}，否则每个字段都 有】 6、附录 错误码 描述