接口描述
用户在实证认证前获取token
请求方式
POST
生产调用地址
https://openapi.unionpay.com/upapi/udia/authService/queryToken/v1
测试调用地址
https://openapi.unionpay.com/upapi/udiaTest/authTest/queryToken/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-必填 | 【必填】用于标识落地实施方和内部数据使用方，编码规则：8位数字；若该应用方为银联入网成员机构，则复用已有的机构代码，若非银联成员机构，则与UDIA通过线下协商获得；通过“关联信息”进行校验。
|
||
| 应用方请求流水号 | orgSeq | string | 30 | M-必填 | 【必填】用于唯一标识落地实施方和内部数据使用方的一笔交易请求，编码规则：8位应用方代码+14位时间+8位随机数
|
||
| 外部数据使用方代码 | comUserId | string | 16 | M-必填 | 【必填】对于数据使用方，前8位对应关联的应用方代码；后8位全部填写为0。
|
||
| 认证模式代码 | authCode | string | 6 | M-必填 | 【必填】详见数据字典
|
||
| 交易场景代码 | sceneCode | string | 2 | M-必填 | 【必填】详见数据字典
|
||
| 用户电子协议版本号 | protocolVersion | string | 18 | O-选填 | 【选填】与用户签订用户授权协议版本号（包括纸质或电子协议）。
|
||
| 用户授权流水号 | authSeq | string | 32 | O-选填 | 【选填】用于唯一标识身份验证交易的用户授权
|
||
| 应用信息 | appInfo | string | 1024 | M-必填 | 【必填】将以下3个参数组成json字符串后，由应用方使用对称秘钥进行SM4加密得到值作为【appInfo】参数的内容进行传输。
|
||
| 扩展信息A | extA | string | 1024 | O-选填 |
|
||
| 扩展信息B | extB | string | 1024 | O-选填 |
|
||
| 扩展信息C | extC | string | 1024 | O-选填 |
|
||
| 敏感信息秘钥 | secKey | string | 2048 | M-必填 | 【必填】敏感信息加解密的对称秘钥，需要应用方生成，并通过SM2使用平台公钥进行加密传输，Base64编码。
|
||
| 请求方自定义域 | reqReserved | string | 128 | O-选填 |
|
||
| 请求方自定义域 | reqReserved | string | 128 | R-需要返回 |
|
同步应答参数
| 中文名称 | 英文名称 | 域类型 | 域长度 | 默认值 | 请求要求 | 备注 | |
|---|---|---|---|---|---|---|---|
| 应答码 | respCd | string | 4 | M-必填 |
|
||
| 应答消息 | respMsg | string | 128 | M-必填 |
|
||
| 业务字段集合 | data | string | M-必填 |
|
示例代码
中国银联版权所有© 沪ICP备07032180号-2 沪公网安备31011502002335号
