接口描述
对用户提交的企业信息及企业法人信息进行核验，并返回认证结果。报文中敏感字段采用SM4方法加密。
请求方式
POST
生产调用地址
https://openapi.unionpay.com/upapi/udia/authService/verify/v1
测试调用地址
http://101.231.114.255:20010/upapi/udiaTest/authTest/verify/v1
URL请求参数
| 中文名称 | 英文名称 | 域类型 | 域长度 | 默认值 | 请求要求 | 备注 | |
|---|---|---|---|---|---|---|---|
| 产品token | token | string | M-必填 | 详情请参考“获取token”接口中应答参数“token”的具体数据。 | |||
| 签名信息 | sign | string | M-必填 | 详细签名算法可参考附录“签名样例代码”部分。 | |||
| 时间戳 | ts | long | M-必填 | 单位毫秒，对于Java一般使用System.currentTimeMillis();获取 |
HTTP报文体参数
| 中文名称 | 英文名称 | 域类型 | 域长度 | 默认值 | 请求要求 | 备注 | |
|---|---|---|---|---|---|---|---|
| 版本号 | version | string | 8 | 1.0.0 | O-选填 | 【非必填】默认为：1.0.0
|
|
| 交易类型 | action | string | 4 | M-必填 | 【必填】详见1.2.3
|
||
| 交易请求时间 | txnTime | string | 14 | M-必填 | 【必填】格式：yyyyMMddhhmmss
|
||
| 交易来源 | txnSrc | string | 2 | M-必填 | 【必填】详见1.2.4
|
||
| 应用方代码 | orgCode | string | 8 | M-必填 | 【必填】用于标识落地实施方和内部数据使用方
该参数已配置预检规则： 业务产品关联代码校验规则 |
||
| 应用方请求流水号 | orgSeq | string | 30 | M-必填 | 【必填】用于唯一标识落地实施方和内部数据使用方的一笔交易请求，编码规则：8位应用方代码+14位时间+8位随机数
|
||
| 外部数据使用方代码 | comUserId | string | 16 | M-必填 | 【必填】填写需通过落地实施方调用身份认证请求的外部数据使用方代码；
|
||
| 认证模式代码 | authCode | string | 6 | M-必填 | 【必填】详见数据字典
|
||
| 交易场景代码 | sceneCode | string | 2 | M-必填 | 【必填】详见数据字典
|
||
| 用户授权流水号 | authSeq | string | 32 | M-必填 | 【必填】用于唯一标识一笔身份验证交易的用户授权
|
||
| 用户电子协议版本号 | protocolVersion | string | 18 | M-必填 | 【必填】与用户签订的授权协议版本号（包括纸质或电子协议）。
|
||
| 法人姓名 | name | string | M-必填 |
该参数已配置加密规则：SM4 查看详情 |
|||
| 法人身份证号 | identity | string | C-按条件必填 | 【条件必填】认证模式代码取值为EN0001、EN0002时必填
该参数已配置加密规则：SM4 查看详情 |
|||
| 企业标识 | entmark | string | C-按条件必填 | 【条件必填】认证模式代码取值为EN0002、EN0003时必填，企业标识包括统一社会信用代码、工商注册号、组织机构代码
|
|||
| 统一社会信用代码 | creditcode | string | C-按条件必填 | 认证模式代码取值为EN0001时，统一社会信用代码、工商注册号、企业名称、组织机构代码4项必填1项；认证模式代码取值为EN0004时必填
|
|||
| 组织机构代码 | insCode | string | O-选填 | 认证模式代码取值为EN0001时，统一社会信用代码、工商注册号、企业名称、组织机构代码4项必填1项
|
|||
| 企业全称 | entname | string | C-按条件必填 | 认证模式代码取值为EN0001时，统一社会信用代码、工商注册号、企业名称、组织机构代码4项必填1项；认证模式代码取值为EN0002、EN0003时必填
|
|||
| 工商注册号 | regno | string | O-选填 | 认证模式代码取值为EN0001时，统一社会信用代码、工商注册号、企业名称、组织机构代码4项必填1项
|
|||
| 注册地址 | dom | string | C-按条件必填 | 【条件必填】认证模式代码取值为EN0004时必填
|
同步应答参数
| 中文名称 | 英文名称 | 域类型 | 域长度 | 默认值 | 请求要求 | 备注 | |
|---|---|---|---|---|---|---|---|
| 应答码 | respCd | string | 4 | M-必填 |
|
||
| 应答消息 | respMsg | string | 128 | M-必填 |
|
||
| 业务字段集合 | data | map | M-必填 |
|
示例代码
中国银联版权所有© 沪ICP备07032180号-2 沪公网安备31011502002335号
