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

更新时间:2021/08/05 18:47:01

接口描述

获取组织机构实名认证地址。该接口可结合电子签名场景使用。

关于认证方式选择对公打款请注意:

1.沙箱环境下,选择对公打款中的平台方向贵司打款方式进行企业实名认证,默认不会执行打款动作,开发者只需在回填金额中写入0.01进行确认提交,即可完成企业实名认证;正式环境下对公打款流程不变。

2.对公打款申请次数超过次数上限,当日会被限制,隔天可以重新申请打款,无须获取新的flowid。金额回填校验失败超过3次,页面上可以直接重新申请打款,无须获取新的flowid。

接口

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

请求方式

POST

请求头

提供两种安全接入方式,对应参数如何获取,参考文档【请点击】。

方式一:请求签名鉴权(优先推荐)

参数名称

类型

必选

参数说明

示例值

X-Tsign-Open-App-Id

string

项目ID


X-Tsign-Dns-App-Id

String

项目ID。在微信小程序中对接,该参数必传;其他场景无需添加该参数


Content-Type

string

application/json;charset=UTF-8


X-Tsign-Open-Ca-Timestamp

string

API 调用者传递时间戳,值为当前时间的毫秒数,也就是从1970年1月1日起至今的时间转换为毫秒,时间戳有效时间为15分钟,为了防重放攻击


Accept

string

建议统一填写 */*


X-Tsign-Open-Ca-Signature

string

签名字符串


Content-MD5

string

当请求 Body 非 Form 表单时,可以计算 Body 的 MD5 值传递给云网关进行 Body MD5 校验。建议当请求 Body 非 Form 表单时,加上此请求头。


X-Tsign-Open-Auth-Mode

string

选择请求方式进行鉴权,固定值,Signature


方式二:OAuth2.0鉴权(不推荐使用)

当安全接入选择OAuth2.0鉴权方式请点击查阅详情。

请求参数

参数名称

类型

必选

参数类型

参数说明

示例值

accountId

string

path

组织机构账号ID,通过创建机构账号接口获取


agentAccountId

string

body

办理人账号ID,通过

创建个人账号接口

获取


authType

string

body

指定默认认证类型(打开认证页面所展示的第一个认证类型)

ORG_BANK_TRANSFER组织机构对公账户打款认证ORG_ZM_AUTHORIZE企业芝麻认证ORG_LEGAL_AUTHORIZE组织机构法定代表人授权书签署认证


availableAuthTypes

list

body

指定页面显示认证方式

ORG_BANK_TRANSFER组织机构对公账户打款认证ORG_ZM_AUTHORIZE企业芝麻认证ORG_LEGAL_AUTHORIZE组织机构法定代表人授权书签署认证


agentAuthAdvancedEnabled

list

body

指定办理人在认证过程中,如果通过银行卡认证或运营商认证方式进行实名认证时,可指定是否使用详情版,如指定则核验失败可返回具体不匹配信息,传空默认为普通版。

PSN_BANK4_AUTHCODE-个人银行卡四要素认证

PSN_TELECOM_AUTHCODE-个人运营商三要素认证

注:

  • 详情版只适用个人认证过程的信息比对,企业认证过程暂不支持详情版信息比对
  • 详情版,信息比对核验失败,会返回具体不匹配的信息结果。该功能需要单独购买,具体购买方式请咨询e签宝工作人员
  • 普通版,信息比对核验失败,不会返回具体的不匹配信息


receiveUrlMobileNo

string

body

接收实名认证链接短信通知的手机号。传入手机号会发送邀请实名认证短信通知到该用户,并收取一次短信费用,不传入则不发送,不产生短信费用


contextInfo

object

body

业务方交互上下文信息



contextId

string

body

发起方业务上下文标识

在异步通知时发送回发起方


notifyUrl

string

body

发起方接收实名认证状态变更通知的地址

,异步通知参考【请点击


origin

string

body

认证发起来源,BROWSER - 浏览器;APP - 移动端APP。不填默认为为BROWSER


redirectUrl

string

body

认证结束后页面跳转地址.点击】查看如何跳转回APP


showResultPage

boolean

body

实名完成是否显示结果页,默认显示


orgEntity

object

body

组织机构基本信息



name

string

body

组织机构名称


certNo

string

body

组织机构证件号



legalRepCertType


string

body

法人证件类型。不传默认:中国大陆身份证INDIVIDUAL_CH_IDCARD-中国大陆身份证INDIVIDUAL_CH_TWCARD-台湾来往大陆通行证INDIVIDUAL_CH_HONGKONG_MACAO-港澳来往大陆通行证

INDIVIDUAL_PASSPORT-护照



legalRepCertNo

string

body

法定代表人身份证号


legalRepName

string

body

法定代表人姓名



agentName

string

body

当前实名认证办理人姓名



agentIdNo

string

body

当前实名认证办理人证件号



organizationType

int

body

组织类型,1 - 企业类;2 - 个体工商户 ;3 - 其他组织。

不填为不指定组织类型;若指定组织类型,则页面上不可切换


configParams

object

body

认证配置信息



orgUneditableInfo

array

body

指定页面上不可修改的信息属性。
创建e签宝账号时传入的信息属性在页面上固定不可修改;未传入的信息属性可通过此参数指定在页面上是否可修改,未指定的信息属性可以修改。

name组织机构名称

certNo组织机构证件号

legalRepName法定代表人姓名

legalRepCertNo法定代表人身份证号

agentName办理人姓名

agentIdNo办理人证件号


repeatIdentity

boolean

body

是否允许重复实名,默认允许


响应参数

参数名称

类型

必选

参数说明

示例值

code

int

错误码


message

string

错误信息


data

object

业务信息





flowId

string

实名认证流程Id


shortLink

string

获取组织机构实名认证短链接,链接有效期30天。


url

string

获取组织机构实名认证长链接,链接永久有效。


请求示例  

{
   	"authType":"ORG_BANK_TRANSFER",
    "availableAuthTypes":["ORG_BANK_TRANSFER","ORG_ZM_AUTHORIZE"],
  	"agentAuthAdvancedEnabled":["PSN_TELECOM_AUTHCODE","PSN_BANK4_AUTHCODE"],
    "agentAccountId":"ca991b71dcxxxx",
    "contextInfo":{
    	"contextId":"20190822135330888",
    	"notifyUrl":"http://baidu.com",
    	"origin":"BROWSER",
    	"redirectUrl":"http://baidu.com",
    	"showResultPage":"true"
    },
    "orgEntity":{
    	"certNo":"91440xxxxxxx",
    	"organizationType":1,
    	"name":"天谷信息科技有限公司",
      "legalRepCertNo":"37140xxxxx",
    	"legalRepName":"xxx"
    },

    "repeatIdentity":"true"
}

响应示例

{
    "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": "成功"
}

错误码

错误码

错误描述

解决方案

30500000

操作出错,请联系服务人员处理, ID:XXXX

请核实入参格式是否正确

30500150

未找到个人用户基本信息

请核实传入的办理人账号是否真实存在

30500151

未找到企业组织用户基本信息

请核实传入的企业账号是否真实存在

30500152

当前账户已实名

请核实入参repeatIdentity是否允许企业重复实名

30500156

账号不存在,请检查accountId的正确性

请核实待认证企业账号accountId是否正确

30500101

参数错误:XXXX

请核实企业信息是否传入正确