CFCA开放平台

文档中心

接口列表

网络身份认证平台

企业认证

银行卡

移动运营商

身份证

网络身份认证平台

查看产品

更新时间：2022-12-19

银行卡四要素信息验证（手机号）

接口描述

通过姓名、证件类型（目前只支持身份证）、证件号码、账号、电话一致性验证

请求方式

POST

生产地址

https://open.cfca.com.cn:9444/updopapi/cfca/identityVerify/V1/BankCardVerify/V1

测试地址

https://opentest.cfca.com.cn:9444/updopapi/cfca/identityVerify/V1/BankCardVerify/V1

公共请求参数

中文名称	英文名称	域类型	域长度	请求要求	备注
渠道号	X-Channel	string	32	O-选填	请求报文头填写，用于指定使用的渠道
实际渠道号	X-realChannel	string	32	R-需要返回	请求报文头为空，保存应答报文头实际渠道号
计费标识	X-feeFlag	string	4	R-需要返回	请求报文头为空，保存应答报文头收费标识
用户对账流水号	X-checkNo	string	32	O-选填	请求报文头填写，不建议使用
开放平台流水号	X-OpenCfcaNo	string	32	R-需要返回	请求报文头为空，保存应答报文头开放平台流水号
请求时间	X-OPEN-TS	string	20	M-必填	报文头字段。
数据签名	X-OPEN-SIGN	string	512	M-必填	（1）采用P7分离式签名，由CFCA提供SDK进行报文签名和验签。（2）报文签名：a. 将请求报文体和请求报文头中X-OPEN-TS以&作为连接符拼接成body=[请求报文体]&X-OPEN-TS=[X-OPEN-TS]形式的待签名串；b.对待签名串使用SHA256做摘要（摘要结果转16进制小写字符串），并使用RSA私钥对摘要做签名操作；c. 对签名做Base64编码，将编码后的签名串放在请求报文头X-OPEN-SIGN中。
开放平台账户ID	X-OPEN-APP-ID	string	128	M-必填	报文头字段。
语言地区	Locale	string	5	O-选填	请求报文体输入。
发送报文时间	Timestamp	string	14	M-必填	请求报文体输入，格式：yyyyMMddHHmmss。
交易类型	txCode	string	5	M-必填	请求报文体输入。企业法人四要素核验：02003；身份证三要素信息核验（不带发证地区代码，带照片）：04002；移动运营商校验：06004

请求报文体参数

中文名称	英文名称	域类型	域长度	默认值	请求要求	备注
是否查询银行编码与银行卡类型	QueryBankCardInfo	string	5	false	M-必填	是否查询银行编码与银行卡类型 true是 false否
电话	PhoneNo	string	16		M-必填
卡类型	CardType	string	2		M-必填	卡类型：取值固定为10
账号	AccountNo	string	32		M-必填
证件号码	IdentificationNo	string	80		M-必填
证件类型（目前只支持身份证）	IdentificationTypeCode	string	2		M-必填
姓名	SubscriberName	string	450		M-必填

同步应答参数

中文名称	英文名称	域类型	域长度	请求要求	备注
银行卡类型	BankCardType	string	2	O-选填	银行卡类型:01 借记卡02 贷记卡
银行编码	IssuerBankId	string	10	O-选填	银行编码（详见《银行编码》）
账户类型	AccountType	string	1	C-按条件必填	账户类型:返回值固定为1，无实际意义
错误分类标识	ErrorClassification	string	4	O-选填	错误分类标识:00 认证通过（收费）01 认证未通过（收费）02 重复提交03 不支持04 系统异常05 其他
验证结果描述	StatusMessage	string	200	O-选填
验证结果	Status	string	2	O-选填	验证结果:0 成功3 验证不一致99 其他错误
业务流水号	BusinessLogId	string	30	M-必填	业务流水号，为方便后续分析问题，请业务系统进行记录
结果信息	ResultMessage	string	200	M-必填	结果信息成功为“成功”
结果代码	ResultCode	string	8	M-必填	结果代码成功为“00000000”

示例代码

暂无代码

提示信息

提示