获取认证链接

接口描述

用于获取实名认证链接或授权认证链接，用户可通过访问链接进行实名认证或授权认证操作。

该接口支持 实名认证（authentication）和授权认证（combination）两种模式：

（1）使用实名认证模式可以为用户创建e签宝SaaS官网账号并生成实名认证链接用于核验用户真实性。

当传入的手机号或邮箱已完成实名认证时，接口默认不会返回实名认证链接，仅返回“账号已实名，无需重复实名”信息。

（2）使用授权认证模式包含实名认证模式的功能，同时还可以授权appId所属平台获取用户在e签宝SaaS官网的账号信息。

当传入的手机号或邮箱180天内已完成授权认证，接口不会返回授权认证链接，请在180天内查询获取用户已授权的信息。

实名认证模式和授权认证模式都支持以下认证方式，用户可自主选择其中一种方式进行实名认证。

个人：人脸识别认证、银行卡四要素认证和手机号三要素认证。

机构：法定代表人认证、授权委托书认证、对公账号打款认证和企业支付宝认证。

接口

/v3/oauth2/index

请求方式

POST

请求头

方式一：请求签名鉴权

当接口调用选择请求签名鉴权方式，【请点击】。

方式二：OAuth2.0鉴权

当接口调用选择OAuth2.0鉴权方式，请点击。

请求参数

响应参数

请求示例（个人实名认证模式）

{
    "appId": "7438790001",
    "redirectUrl": "https://www.esign.cn/",
    "notifyUrl": "http://xx.xx.xx.xx:8081/asyn/notify",
    "bizType": "authentication",
    "state": "xxxx",
    "account": "13800001111",
    "authConfigParam": {
       "authType": "PSN_TELECOM_AUTHCODE",
        "availableAuthTypes": [
            "PSN_TELECOM_AUTHCODE",
            "PSN_FACEAUTH_BYURL",
            "PSN_BANK4_AUTHCODE"
        ],
        "indivEditableInfo": [
            "name",
            "certNo"
        ],
        "showResultPage": true
    },
    "individualInfo": {
        "bankCardNo": "",
        "certNo": "110101199603121978",
        "certType": "CRED_PSN_CH_IDCARD",
        "name": "**"
    }
}

请求示例（机构授权认证模式）

{
    "appId": "7438790001",
    "redirectUrl": "https://www.esign.cn/",
    "notifyUrl": "http://10.00.00.001:58081/asyn/notify",
    "bizType": "combination",
    "scope": "get_user_info,op_organ_admin",
    "responseType": "code",
    "state": "Test002xxx",
    "account": "138xxxx1111",
    "authConfigParam": {
        "authType": "ORG_BANK_TRANSFER",
        "availableAuthTypes": [
            "ORG_BANK_TRANSFER",
            "ORG_LEGAL_AUTHORIZE"            
        ],
        "indivEditableInfo": [
            "name" ,
            "certNo"
        ],
         "orgEditableInfo": [
            "name"
        ],
        "showResultPage": true
    },
    "authSubject": {
        "name":"xxx测试企业",
         "certType":"CRED_ORG_USCC",
        "certNo":"911112200000000001",
        "legalRepName":"**"
    },
    "individualInfo": {
        "bankCardNo": "",
        "certNo": "110101199603121978",
        "certType": "CRED_PSN_CH_IDCARD",
        "name": "**"
    }
}

响应示例

{
    "code": 0,
    "message": "成功",
    "data": "https://openapi.esign.cn/usercenterFront/oemAuth/v3/realName/index?contextKey=aabbf05ef2e3fe97d4a1ffeb5536c39f&appId=743879xxx"
}

错误码