创建企业实名证据点

接口描述

当开发者不使用e签宝的企业实名认证时，需要将企业实名认证的相关证据上传至e签宝获取证据点ID，并在后续创建e签宝签署账号时传入该证据点ID。

接口地址

点击下述蓝色字体{host}可跳转至API请求域名说明文档

https://{host}/v3/evidence/evi-point/org-realname

请求方式

POST

请求数据格式

application/json; charset=UTF-8

请求参数

展开全部参数参数名称			参数类型	必选	参数位置	参数说明
eviName			string	是	Body	证据点名称（不能超过64个字符）
customBizId			string	否	Body	开发者自定义业务编号（不能超过36个字符）
realNameMethod			string	是	Body	企业实名方式 LEGALAUTHFILE - 法人授权书 CORPORATEPAYINFO - 对公打款 REVERSEPAYINFO - 反向打款 THIRDPARTYREALNAMEINFO - 第三方平台授权
timeStamp			long	是	Body	实名完成时间（毫秒级时间戳）
name			string	是	Body	企业名称
cardNo			string	是	Body	企业证件号
cardType			string	是	Body	企业证件类型 CRED_ORG_USCC - 统一社会信用代码 CRED_ORG_REGCODE - 工商注册号
creditCode			string	否	Body	统一社会信用代码电子版证件类型为统一社会信用代码时必传；需要提前将证件图片上传至e签宝；文件上传接口：《文件上传》。
registrationNo			string	否	Body	工商注册号电子版证件类型为工商注册号时必传；需要提前将证件图片上传至e签宝；文件上传接口：《文件上传》。
mark			string	否	Body	备注信息
legalAuthFile			object	否	Body	法人授权书实名信息此参数是否传递与实名方式保持一致 realNameMethod=LEGALAUTHFILE时必传
	authFile		string	是	Body	授权书文件需要提前将授权书文件上传至e签宝；文件上传接口：《文件上传》。
corporatePayInfo			object	否	Body	对公打款实名信息此参数是否传递与实名方式保持一致 realNameMethod=CORPORATEPAYINFO时必传
	infoVerifySupplier		string	是	Body	信息核验供应商
	verifyTime		string	是	Body	核验时间
	verifySerialNumber		string	是	Body	核验流水号
	payAmount		string	是	Body	打款金额
	payTime		string	是	Body	打款时间
	backFillAmount		string	是	Body	回填金额
	customerBank		string	是	Body	客户银行总行
	customerBankBranch		string	是	Body	客户银行支行
	customerBankNo		string	是	Body	客户银行卡号
	ownBank		string	是	Body	己方银行总行
	ownBankBranch		string	是	Body	己方银行支行
	ownBankNo		string	是	Body	己方银行卡号
reversePayInfo			object	否	Body	反向打款实名信息此参数是否传递与实名方式保持一致 realNameMethod=REVERSEPAYINFO时必传
	infoVerifySupplier		string	是	Body	信息核验供应商
	verifyTime		string	是	Body	核验时间
	verifySerialNumber		string	是	Body	核验流水号
	assignPayAmount		string	是	Body	指定打款金额
	realPayAmount		string	是	Body	实际打款金额
	payTime		string	是	Body	打款时间
	customerBank		string	是	Body	客户银行总行
	customerBankBranch		string	是	Body	客户银行支行
	customerBankNo		string	是	Body	客户银行卡号
	ownBank		string	是	Body	己方银行总行
	ownBankBranch		string	是	Body	己方银行支行
	ownBankNo		string	是	Body	己方银行卡号
thirdPartyRealNameInfo			object	否	Body	第三方平台授权实名信息此参数是否传递与实名方式保持一致 realNameMethod=THIRDPARTYREALNAMEINFO时必传
	infoVerifySupplier		string	是	Body	信息核验供应商
	verifyTime		string	是	Body	核验时间
	verifySerialNumber		string	是	Body	核验流水号
orgTransactorsInfo			object	是	Body	企业实名办理人认证实名信息
	transactorsType		string	是	Body	办理人类型 LEGAL - 法定代表人 NORMAL - 普通经办人
	authFile		string	否	Body	经办人委托书文件办理人类型为普通经办人时需传入；需要提前将委托书上传至e签宝；文件上传接口：《文件上传》。
	realNameMethod		string	是	Body	办理人实名方式 THREEELEMENTS - 运营商三要素 BANKCARDFOUR - 银行卡四要素 FACE - 人脸认证
	timeStamp		long	是	Body	办理人实名完成时间（毫秒级时间戳）
	name		string	是	Body	个人姓名
	cardNo		string	是	Body	个人证件号
	cardType		string	是	Body	个人证件类型 CRED_PSN_CH_IDCARD - 中国大陆居民身份证（默认值） CRED_PSN_CH_HONGKONG - 香港来往大陆通行证（回乡证） CRED_PSN_CH_MACAO - 澳门来往大陆通行证（回乡证） CRED_PSN_CH_TWCARD - 台湾来往大陆通行证（台胞证） CRED_PSN_PASSPORT - 护照 CRED_PSN_FOREIGN - 外国人永久居住证 CRED_PSN_OTHER - 其他
	cardPortrait		string	是	Body	证件人像面需要提前将证件图片上传至e签宝；文件上传接口：《文件上传》。
	cardNationalEmblem		string	是	Body	证件国徽面需要提前将证件图片上传至e签宝；文件上传接口：《文件上传》。
	mark		string	否	Body	备注信息
	threeElements		object	否	Body	运营商三要素实名信息此参数是否传递与实名方式保持一致办理人realNameMethod=THREEELEMENTS时必传
		infoVerifySupplier	string	是	Body	信息核验供应商
		verifyTime	string	是	Body	核验时间
verifySerialNumber		string	是	Body	核验流水号
mobile		string	是	Body	认证手机号
smsCode		string	是	Body	短信验证码
smsSupplier		string	是	Body	短信供应商
bankCardFour		object	否	Body	银行卡四要素实名信息此参数是否传递应和实名方式保持一致办理人realNameMethod=BANKCARDFOUR时必传
	infoVerifySupplier	string	是	Body	信息核验供应商
	verifyTime	string	是	Body	核验时间
	verifySerialNumber	string	是	Body	核验流水号
	openingBank	string	是	Body	开户行
	bankCard	string	是	Body	银行卡号
	mobile	string	是	Body	银行卡绑定手机号
	smsCode	string	是	Body	短信验证码
	smsSupplier	string	是	Body	短信供应商
face		object	否	Body	人脸认证实名信息此参数是否传递应和实名方式保持一致办理人realNameMethod=FACE时必传
	infoVerifySupplier	string	是	Body	信息核验供应商
	verifyTime	string	是	Body	核验时间
	verifySerialNumber	string	是	Body	核验流水号
	faceImage	string	是	Body	人脸照片需要提前将证件图片上传至e签宝；文件上传接口：《文件上传》。
	faceImageSimilarScore	string	是	Body	人脸照片相似度得分
	faceLiveDetectScore	string	是	Body	人脸活体检测得分

响应参数

展开全部参数参数名称		参数类型	必选	参数说明
code		int32	是	业务码，0表示成功，非0表示异常。
message		string	否	业务信息请根据 code 来判断错误情况，不应该依赖 message 匹配，因为 message 可能会调整。
data（点击“+”展开详情）		object	否	业务数据
	eviPointId	string	否	证据点ID（以P开头）

请求示例

{
    "eviName": "测试霁林企业实名证据",
    "realNameMethod": "CORPORATEPAYINFO",
    "timeStamp": "1742809059000",
    "name": "esigntest霁林0326测试企业1",
    "cardNo": "913020202503114831",
    "cardType": "CRED_ORG_USCC",
    "creditCode": "11111",
    "cardNationalEmblem": "02723880e8da4611acc7a6d9ffe93f68",
    "corporatePayInfo": {
        "infoVerifySupplier": "对公打款信息核验供应商",
        "verifyTime": "202503264",
        "verifySerialNumber": "No1234567",
        "payAmount": "0.08",
        "payTime": "202503264",
        "backFillAmount": "0.08",
        "customerBank": "中国银行",
        "customerBankBranch": "中国银行中江支行",
        "customerBankNo": "231182999999",
        "ownBank": "中国工商银行股份有限公司",
        "ownBankBranch": "工商银行响水支行",
        "ownBankNo": "3288888888"
    },
    "orgTransactorsInfo": {
        "transactorsType": "NORMAL",
        "authFile": "1122665ce202447bb254ab57a391808c",
        "realNameMethod": "FACE",
        "timeStamp": "1742809059000",
        "name": "测试张三",
        "cardNo": "130401199601018395",
        "cardType": "CRED_PSN_CH_IDCARD",
        "cardPortrait": "9631665ce202447bb254ab57a391808c",
        "cardNationalEmblem": "02723880e8da4611acc7a6d9ffe93f68",
        "face": {
            "infoVerifySupplier": "信息核验供应商名字",
            "verifyTime": "20240324",
            "verifySerialNumber": "No1234567",
            "faceImage": "1131665ce202447bb254ab57a391808c",
            "faceImageSimilarScore": "9.3",
            "faceLiveDetectScore": "9.9"
        }
    }
}

响应示例

{
    "code": 0,
    "message": null,
    "data": {
        "eviPointId": "P1904111121936324617"
    }
}

电子数据存证服务API

创建企业实名证据点

接口描述

接口地址

请求方式

请求数据格式

请求参数

响应参数

请求示例

响应示例