获取组织机构实名认证地址

接口描述

  • 获取组织机构实名认证地址

接口地址

  • /v2/identity/auth/web/{accountId}/orgIdentityUrl

请求方式

  • POST
  • 请求报文体采用Json数据格式，编码方式采用UTF-8编码

请求参数

参数名称 说明 参数类型 是否必填 类型
accountId 待认证e签宝企业账号Id
账号创建详见 创建e签宝组织账号（电子签名场景专用））		 path 是 string
参数名称 说明 参数类型 是否必填 类型
agentAccountId 经办人账号Id body 是 string
authType 指定默认认证方式,可指定方式详见:组织机构认证类型对照表 body 否 string
availableAuthTypes 指定页面显示认证方式，会从appid已配置方式下取值，可指定方式见：组织机构认证类型对照表 body 否 list
contextInfo 业务方交互上下文信息 body 否 object
orgEntity 组织机构基本信息 body 否 object
configParams 认证配置信息 body 否 object
repeatIdentity 是否允许重复实名，默认允许 body 否 boolean
receiveUrlMobileNo 接收实名认证邀请链接短信手机号。传入手机号会发送邀请短信到该用户，并收取一次短信费用，不传入则不发送，不产生短信费用 body 否 string

带页面交互的实名与业务方通信数据模型

参数名称 说明 参数类型 是否必须 类型
contextId 发起方业务上下文标识
在异步通知时发送回发起方		 body 否 string
notifyUrl 发起方接收实名认证状态变更通知的地址 body 否 string
origin 实名发起来源 body 否 string
redirectUrl 实名结束后页面跳转地址.如果origin=APP,则需在该url参数中以key为esignAppScheme设置APP Scheme参数 body 是 string
showResultPage 实名完成是否显示结果页,默认显示 body 否 boolean

企业/组织认证基本信息

参数名称 说明 参数类型 是否必须 类型
name 组织机构名称 body false string
certNo 组织机构证件号，支持统一信用代码或工商注册号 body false string
legalRepName 法定代表人姓名 body false string
legalRepCertNo 法定代表人身份证号 body false string
agentName 经办人姓名 body false string
agentIdNo 经办人身份证号 body false string
organizationType 组织类型，1 - 企业类；2 - 个体工商户 ；3 - 其他组织；不填为不指定组织类型；若指定组织类型，则页面上不可切换 body false int

认证配置信息

参数名称 说明 参数类型 是否必须 类型
orgUneditableInfo 指定页面上不可修改的信息属性。
详见:组织机构页面版认证信息属性名称对照表
创建e签宝账号时传入的信息属性在页面上固定不可修改；未传入的信息属性可通过此参数指定在页面上是否可修改，未指定的信息属性可以修改。		 array 否 string

请求示例

POST /v2/identity/auth/web/1dcdcb4e5a7742b7a4e5b1739e199130/orgIdentityUrl HTTP/1.1

{
    "agentAccountId": "c6480e2efed44dcc84648f13fc10b6ba",
    "authType": "ORG_BANK_TRANSFER",
    "availableAuthTypes":["ORG_BANK_TRANSFER","ORG_ZM_AUTHORIZE"],
    "configParams":{
        "orgUneditableInfo": ["name", "certNo", "legalRepName", "legalRepCertNo", "agentName", "agentIdNo"]
    },
    "contextInfo": {
        "contextId": "57cc9602-d1b6-48bd-bdbb-61e9f8443955",
        "notifyUrl": "https://www.notifyUrl.cn",
        "origin": "BROWSER",
        "redirectUrl": "https://www.redirectUrl.cn",
        "showResultPage": true
    },
    "orgEntity": {
        "name": "杭州天谷信息科技有限公司",
        "certNo": "913301087458306077",
        "legalRepName": "何一兵",
        "legalRepCertNo": "362428198001010010",
        "agentName": "李四",
        "agentIdNo": "362428199001010010",
        "organizationType": 1
    },
    "repeatIdentity": true,
    "receiveUrlMobileNo": "13811111111"
}

响应参数

参数名称 说明 类型
code 错误码 int
data 业务信息 object
message 错误信息 string

获取实名认证链接地址响应数据

属性名称 说明 类型
flowId 认证流程Id string
shortLink 认证地址短连接 string
url 认证地址原始链接 string

响应示例

{
    "code": 0,
    "data": {
        "flowId": "806742726212082619",
        "shortLink": "https://testt.tsign.cn/rXTpvXA9ofIx",
        "url": "http://testfront.tsign.cn:8890/identity/login?param=RjnJDvu5CYdgGzn5fC9z2vW1sdPoQIsT6rAc50wvvVTHDZuzNDE8KC9NjW8a%2BmU5bHsgBvMoP3uETH8XJ1KBgi5DdgD9vI79W%2FA3g5ENKNwo0bOt5d3AqjyQXETMJmp8rol2NWuDw6WiJ1m0a0ak5%2BX0IxIuOgDkXxGhVMNtkfBCVXSo%2FnYGWL9z3afWjZPd8Dt6F4bdMmdzkzUVvyX7KUQK6qRAAK1K2wltCUGiIJmwUJQCpTmP5zDtx4HMio2IgNXJRk2KxE6emS%2BLUWQyIw%3D%3D"
    },
    "message": "成功"
}

Copyright © 2019 杭州天谷信息科技有限公司版权所有 浙ICP备11026113号

results matching ""

    No results matching ""