接口描述
外部数据使用方注册入网信息，报文中敏感字段采用SM4方法加密。
请求方式
POST
生产调用地址
https://openapi.unionpay.com/upapi/udia/servService/regComUser/v1
测试调用地址
https://openapi.unionpay.com/upapi/udiaTest/servTest/regComUser/v1
URL请求参数
| 中文名称 | 英文名称 | 域类型 | 域长度 | 默认值 | 请求要求 | 备注 | |
|---|---|---|---|---|---|---|---|
| 产品token | token | string | M-必填 | 详情请参考“获取token”接口中应答参数“token”的具体数据。 | |||
| 签名信息 | sign | string | M-必填 | 详细签名算法可参考附录“签名样例代码”部分或参考网站“技术指南”板块第3条。 | |||
| 时间戳 | ts | long | M-必填 | 单位毫秒，对于Java一般使用System.currentTimeMillis();获取。 |
HTTP报文体参数
| 中文名称 | 英文名称 | 域类型 | 域长度 | 默认值 | 请求要求 | 备注 | |
|---|---|---|---|---|---|---|---|
| 版本号 | version | string | 8 | V1.0.0 | O-选填 |
|
|
| 交易类型 | action | string | 4 | M-必填 |
|
||
| 交易请求时间 | txnTime | string | 14 | M-必填 | 格式：yyyyMMddhhmmss。
|
||
| 交易来源 | txnSrc | string | 2 | M-必填 |
|
||
| 应用方代码 | orgCode | string | 8 | M-必填 | 用于标识落地实施方和内部数据使用方，编码规则：8位数字；若该应用方为银联入网成员机构，则复用已有的机构代码，若非银联成员机构，则与UDIA通过线下协商获得；通过“关联信息”进行校验。
该参数已配置预检规则： 业务产品关联代码校验规则 |
||
| 应用方请求流水号 | orgSeq | string | 30 | M-必填 | 用于唯一标识落地实施方和内部数据使用方的一笔交易请求，编码规则：8位应用方代码+14位时间+8位随机数。
|
||
| 操作类型 | mesgType | string | 2 | M-必填 | 01：表示新增；02：表示修改；03：表示删除，即将该外部数据使用方的状态修改为“失效”。
|
||
| 外部数据使用方代码 | comUserId | string | 16 | M-必填 | mesgType = 01时，为请求添加的外部数据使用方代码，如果代码格式不符合规范则失败；mesgType = 02时，为请求修改的外部数据使用方代码，如代码不存在则失败；mesgType = 03时，为请求删除的外部数据使用方代码，如代码不存在则失败。
|
||
| 公司全称 | comName | string | 64 | C-按条件必填 | 【mesgType = 01，条件必填】
|
||
| 公司简称 | comSname | string | 32 | C-按条件必填 | 【mesgType = 01，条件必填】
|
||
| 行业类型 | industryType | string | 4 | C-按条件必填 | 【mesgType = 01，条件必填】详见数据字典。
|
||
| 管理员姓名 | adminName | string | 32 | C-按条件必填 | 【mesgType = 01，条件必填】；采用SM4加密
该参数已配置加密规则：SM4 查看详情 |
||
| 管理员身份证号 | adminIdCode | string | 32 | C-按条件必填 | 【mesgType = 01，条件必填】；采用SM4加密
该参数已配置加密规则：SM4 查看详情 |
||
| 客服电话 | csPhone | string | 16 | O-选填 |
|
||
| 公司主体类型 | comType | string | 2 | C-按条件必填 | 【mesgType = 01，条件必填】详见数据字典。
|
||
| 公司证件类型 | comIdType | string | 2 | C-按条件必填 | 【mesgType = 01，条件必填】详见数据字典。
|
||
| 公司证件代码 | comIdCode | string | 32 | C-按条件必填 | 【mesgType = 01，条件必填】
|
||
| 公司法人姓名 | legalName | string | 32 | C-按条件必填 | 【mesgType = 01，条件必填】；采用SM4加密
该参数已配置加密规则：SM4 查看详情 |
||
| 公司法人身份证号 | legalIdCode | string | 32 | C-按条件必填 | 【mesgType = 01，条件必填】；采用SM4加密
该参数已配置加密规则：SM4 查看详情 |
||
| 需要使用的应用场景代码集合 | sceneCode | string | 128 | C-按条件必填 | 【mesgType = 01，条件必填】应用场景代码之间通过“|”分隔，例如：01|02。
|
||
| 外部数据使用方归属地 | comUserSite | string | 4 | O-选填 | 使用银联地区代码标准，支持到省、直辖市，具体地区代码详见附录。
|
同步应答参数
| 中文名称 | 英文名称 | 域类型 | 域长度 | 默认值 | 请求要求 | 备注 | |
|---|---|---|---|---|---|---|---|
| 应答码 | respCd | string | 4 | M-必填 |
|
||
| 应答消息 | respMsg | string | 128 | M-必填 |
|
||
| 业务字段集合 | data | map | C-按条件必填 |
|
示例代码
中国银联版权所有© 沪ICP备07032180号-2 沪公网安备31011502002335号
