CFCA开放平台

文档中心

接口列表

金信反欺诈服务平台

银行卡账户风险协查（反欺诈识别）

银行卡账户风险协查

实名人像认证

身份证照片认证

静默活体认证

获取视频数字

读数视频识别

国民二要素认证

运营商风险识别（在网状态）

运营商风险识别（三要素详版）

运营商风险识别（三要素简版）

运营商风险识别（二要素简版）

银行卡风险识别（四要素简版）

银行卡风险识别（三要素简版）

银行卡风险识别（二要素简版）

小额对公打款验证-交易查询

小额对公打款验证

金信反欺诈服务平台

查看产品

更新时间：2022-12-19

读数视频识别

接口描述

通过在录制视频时，由系统随机分配4个数字，用户需准确读出数字来校验活体且实名认证结果。

请求方式

POST

生产地址

https://open.cfca.com.cn:9444/updopapi/jinxin/payment/V1/notionalLiveDigital/V1

测试地址

https://opentest.cfca.com.cn:9444/updopapi/jinxin/payment/V1/notionalLiveDigital/V1

公共请求参数

中文名称	英文名称	域类型	域长度	请求要求	备注
APPID	X-OPEN-APP-ID	string		M-必填	报文头字段。
签名值	X-OPEN-SIGN	string		M-必填	报文头字段。
时间	X-OPEN-TS	string		M-必填	报文头字段。
渠道号	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-需要返回	报文头字段；请求报文头为空，保存应答报文头开放平台流水号

请求报文体参数

中文名称	英文名称	域类型	域长度	默认值	请求要求	备注
备注	remark	string	100		O-选填
流水号	voiceSession	string			O-选填	从获取视频数字拿到
视频数据	videoData	string	1		O-选填	使用Base64编码
姓名	username	string	1		O-选填	RSA加密
证件号码	idcard	string	1		O-选填	RSA加密
证件类型	idtype	string	1		C-按条件必填	暂只支持身份证01
请求IP	reqIp	string	32		O-选填
二级商户名称	sCustomerName	string	64		M-必填	终端业务机构商户名-终端业务机构产品名称-终端业务机构具体使用方法
交易业务场景	sceneCode	string	64		M-必填	发起交易商户业务场景编码
商户订单号	dsorderid	string	32		M-必填	每笔交易唯一，限32位长度
商户号	merchno	string	15		M-必填	认证系统分配
流水号	ordersn	string	32		M-必填	唯一值，每次请求都唯一，限32位长度
版本号	version	string	4	0100	M-必填
数据签名	sign	string			M-必填	签名信息
交易码	transcode	string	4	612	M-必填

同步应答参数

中文名称	英文名称	域类型	域长度	默认值	请求要求	备注
查询结果数据	data	string			O-选填	查询结果，为JSON格式字符串，需要使用RSA解密
加密校验值	sign	string	300		O-选填	加密校验值，商户未注册等等无sign字段
平台返回信息	platformDesc	string	128		M-必填	描述交易具体情况
平台返回码	platformCode	string	16		M-必填	1000000
平台交易流水号	orderid	string	32		M-必填	平台唯一流水号
商户订单号	dsorderid	string	32		M-必填	每笔交易唯一
商户号	merchno	string	15		M-必填	商户号，认证系统分配
商户请求流水号	ordersn	string	32		M-必填	唯一值，每次请求都唯一
交易码	transcode	string	4	612	M-必填

示例代码

Java应答代码

{

“dsorderid”: ”47e6dXXXXXXXXXXXdacd8b”,

“merchno”: ”000000000000XXXX”,

“transcode”: ”309”,

“ordersn”: ”47e6dXXXXXXXXXXXdacd8b”,

“orderid”: ”201912XXXXXXXX0881”,

“sign”: ”879ed23b7da7de282f357de454a6f04b”,

“platformCode”: ”001000000”,

“platformDesc”: ”验证通过”,

“data”: {

“base64Image”: “/9j/4AAQSkZJRgA……UEn/2==”,

“confidence”: “0.91”

}

提示信息

提示