机构账号创建

接口地址: /v1/organizations/createByThirdPartyUserId

请求方式: POST

接口描述:

  1. 对接方调用本接口在e签宝平台中创建机构账号,后续有关该机构的所有操作都需使用该机构的accountId。如提供机构证件信息,则将根据提供的机构证件信息申请数字证书。
  2. 创建机构账号前需要先创建一个个人账号并通过本接口传给服务器,该个人账号将作为该机构签署的经办人,代表企业完成实名认证和意愿认证,并完成签署操作。

请求参数

参数名称 说明 参数类型 是否必填 类型
thirdPartyUserId 机构唯一标识,可传入第三方平台机构id、企业证件号、企业邮箱等如果设置则作为账号唯一性字段,相同id不可重复创建。(个人用户与机构的唯一标识不可重复) body true string
creator 创建人个人账号id(调用个人账号创建接口返回的accountId) body true string
name 机构名称(非实名签署时必填) body false string
idType 证件类型,详见机构证件类型说明 ,默认CRED_ORG_USCC body false string
idNumber 证件号(非实名签署时必填) body false string
orgLegalIdNumber 企业法人证件号 body false string
orgLegalName 企业法人名称 body false string

请求示例

POST https://openapi.esign.cn/v1/organizations/createByThirdPartyUserId
{
    "creator":"7b04a1e86d014a26858f69162d0e39d4",
    "idNumber":"12330100470104939U",
    "idType":"CRED_ORG_USCC",
    "name":"测试企业",
    "thirdPartyUserId":"B001",
    "orgLegalIdNumber":"",
    "orgLegalName":""
}

响应参数

参数名称 说明 参数类型 是否必填 类型
orgId 机构账号id body true string

响应示例

{
    "code":0,
    "message":"成功",
    "data":{
        "orgId":"d406f301ee5349399dfc83f36a243fcd"
    }
}

返回码说明

返回码 说明
0 成功
53000000 账号已存在
53000001 账号不存在
53000002 账号类型不匹配

results matching ""

    No results matching ""