企业实名认证地址（页面）

POST

/open/corpCert/getUrl

企业用户通过此接口进行企业认证操作，请求后返回认证页链接。

企业认证成功后，再调用【创建已认证企业用户】才能创建用户

具体认证步骤如下：

请求头格式

具体请求头参数，请查看公共请求格式

请求参数

Body 参数application/json

corpAuthConfig

object | null

认证基本信息

可选

corpInfo

object | null

企业信息

可选

transactorInfo

object | null

经办人个人信息

可选

pageConfig

object | null

企业认证页面配置

可选

corpAuthPageConfig

object | null

企业信息相关配置

可选

transactorAuthPageConfig

object | null

经办人信息相关配置

可选

integrationConfig

object

集成配置

必需

redirectConfig

object | null

重定向配置

可选

expirationTime

string | null

链接过期时间

可选

最长3个月

clientType

string

客户端类型

必需

h5-手机端适配，pc-电脑端适配

businessCode

string | null

业务id

可选

可关联对接应用业务码

示例

{
    "corpAuthConfig": {
        "corpInfo": {
            "corpName": "浙江签盾科技有限公司",
            "corpIDCardType": "CRED_ORG_USCC",
            "corpIDCardNum": "91330381MA2CN1L466",
            "legalRepName": "潘孝忠",
            "legalRepIDCardType": "CRED_PSN_CH_IDCARD",
            "legalRepIDCardNum": "330325XXXXXXXXXXXX"
        },
        "transactorInfo": {
            "psnName": "潘孝忠",
            "psnIDCardType": "CRED_PSN_CH_IDCARD",
            "psnIDCardNum": "330325XXXXXXXXXXXX",
            "psnMobile": "13967733222"
        }
    },
    "pageConfig": {
        "corpAuthPageConfig": {
            "corpEditableFields": [
                "corpName",
                "corpIDCardNum",
                "legalRepName"
            ],
            "corpDefaultAuthMode": "legalRep",
            "corpAvailableAuthModes": [
                "legalRep",
                "agent"
            ]
        },
        "transactorAuthPageConfig": {
            "transactorEditableFields": [
                "psnName",
                "psnIDCardNum",
                "psnMobile"
            ],
            "transactorDefaultAuthMode": "mobile",
            "transactorAvailableAuthModes": [
                "mobile",
                "face"
            ]
        }
    },
    "integrationConfig": {
        "redirectConfig": {
            "redirectUrl": "https://probable-leading.info/",
            "redirectDelayTime": 3
        },
        "expirationTime": "2025-06-01 00:00:00",
        "clientType": "h5"
    },
    "businessCode": "bz1000000001"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'api.pre-qiandun365.com/api/open/corpCert/getUrl' \
--header 'Content-Type: application/json' \
--data-raw '{
    "corpAuthConfig": {
        "corpInfo": {
            "corpName": "浙江签盾科技有限公司",
            "corpIDCardType": "CRED_ORG_USCC",
            "corpIDCardNum": "91330381MA2CN1L466",
            "legalRepName": "潘孝忠",
            "legalRepIDCardType": "CRED_PSN_CH_IDCARD",
            "legalRepIDCardNum": "330325XXXXXXXXXXXX"
        },
        "transactorInfo": {
            "psnName": "潘孝忠",
            "psnIDCardType": "CRED_PSN_CH_IDCARD",
            "psnIDCardNum": "330325XXXXXXXXXXXX",
            "psnMobile": "13967733222"
        }
    },
    "pageConfig": {
        "corpAuthPageConfig": {
            "corpEditableFields": [
                "corpName",
                "corpIDCardNum",
                "legalRepName"
            ],
            "corpDefaultAuthMode": "legalRep",
            "corpAvailableAuthModes": [
                "legalRep",
                "agent"
            ]
        },
        "transactorAuthPageConfig": {
            "transactorEditableFields": [
                "psnName",
                "psnIDCardNum",
                "psnMobile"
            ],
            "transactorDefaultAuthMode": "mobile",
            "transactorAvailableAuthModes": [
                "mobile",
                "face"
            ]
        }
    },
    "integrationConfig": {
        "redirectConfig": {
            "redirectUrl": "https://probable-leading.info/",
            "redirectDelayTime": 3
        },
        "expirationTime": "2025-06-01 00:00:00",
        "clientType": "h5"
    },
    "businessCode": "bz1000000001"
}'

返回响应

🟢200成功

application/json

Body

result

object

请求结果

必需

flowNo

string

认证流程号

必需

后续可通过此值查询认证的流程信息

certUrl

string

认证页链接

必需

提供企业认证的页面

code

string

请求结果code

必需

msg

string

请求结果

必需

logKey

string

请求编码

必需

string

请求时间戳

必需

success

boolean

是否请求成功

必需

示例

{
    "result": {
        "flowNo": "OPFN135903MwmamzuzHdmd",
        "certUrl": "http://open-pc.qiandun365.com?appId=258&flowNo=OPFN135903MwmamzuzHdmd&temporaryToken=bsTEdBIu"
    },
    "code": "200",
    "msg": "成功",
    "logKey": "f23a5d2b",
    "ts": "1740635944913",
    "success": true
}

修改于 2025-06-18 08:34:05

查询打款银行信息

查询认证信息

企业实名认证地址（页面）

请求头格式#

请求参数

示例代码

返回响应

请求头格式