CFCA开放平台

文档中心

接口列表

金信反欺诈服务平台

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

银行卡账户风险协查

实名人像认证

身份证照片认证

静默活体认证

获取视频数字

读数视频识别

国民二要素认证

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

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

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

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

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

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

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

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

小额对公打款验证

金信反欺诈服务平台

查看产品

更新时间：2022-12-19

实名人像认证

接口描述

实名人像认证

请求方式

POST

生产地址

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

测试地址

https://opentest.cfca.com.cn:9444/updopapi/jinxin/payment/V1/livingAuth/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-需要返回	报文头字段；请求报文头为空，保存应答报文头开放平台流水号

请求报文体参数

中文名称	英文名称	域类型	域长度	默认值	请求要求	备注
头像数据	imageData	string			M-必填	照片大小5k到150k之间，正向，无逆光，使用Base64编码
姓名	username	string	50		M-必填	RSA加密
证件号码	idcard	string	32		M-必填	RSA加密
证件类型	idtype	string	2		M-必填
证件类型	idtype	string	2		M-必填	暂只支持身份证01
请求IP	reqIp	string	32		O-选填
加密校验值	sign	string	300		M-必填	data 字段的加密校验值
授权流水号	serialNm	string	8-64		O-选填	C 端客户向终端商户进行信息核验(或查询）的个人信息使用授权协议签署的流水号(通过该流水号要能够定位到签署协议人员以及日期)
授权协议版本号	protocolVerNm	string	2-40		O-选填	终端商户与 C 端客户签订的电子协议版本号(要能够查询定位到签署授权协议的具体内容)(授权协议模版应事前备案)
使用目的	scUsePurpose	string	2-64		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	100	M-必填
交易码	transcode	string	4	121	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	121	M-必填

示例代码

Java应答代码

{

"dsorderid": "693e73619a344f699a95f1cff62dbb4b",

"merchno": "000000000000000",

"transcode": "121",

"ordersn": "693e73619a344f699a95f1cff62dbb4b",

"orderid": "20210613013904761",

"sign": "F1A0A5A0ADCD93E2A454224C3CC634BD552BBC0CB7EFE17B91874FD87691E450",

"platformCode": "001000000",

"platformDesc": "验证成功",

"data": {

"confidence": “0.88”

}

提示信息

提示