个人实名认证地址（页面）

POST

/open/psnCert/getUrl

个人实名认证地址（页面）是由签盾提供的个人用户合规认证页面，目的为简化应用接入的流程。页面支持PC或H5访问（通过integrationConfig.clientType配置）

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

认证流程如下：

请求头格式

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

请求参数

Body 参数application/json

psnAuthConfig

object | null

个人认证默认信息

可选

psnName

string | null

个人姓名

可选

psnIDCardType

string | null

个人证件类型

可选

证件类型，CRED_PSN_CH_IDCARD - 中国大陆居民身份证

psnIDCardNum

string | null

个人证件号

可选

psnMobile

string | null

认证手机号

可选

psnBankCardNo

string | null

认证银行卡号

可选

pageConfig

object | null

可选

psnEditableFields

array[string] | null

认证可编辑字段

可选

psnName：个人姓名
psnIDCardNum：证件号
psnMobile:认证手机号
psnBankCardNo：银行卡号

枚举值:

psnNamepsnIDCardNumpsnMobilepsnBankCardNo

psnDefaultAuthMode

enum<string> | enum<null>

默认认证方式

可选

face: 人脸识别认证
mobile: 实名手机号三要素认证
bank: 个人银行卡四要素认证

枚举值:

facemobilebank

psnAvailableAuthModes

array[string] | null

可选认证方式

可选

face: 人脸识别认证
mobile: 实名手机号三要素认证
bank: 个人银行卡四要素认证

枚举值:

facemobilebank

integrationConfig

object

集成配置

必需

redirectConfig

object | null

重定向配置

可选

expirationTime

string | null

链接过期时间

可选

clientType

enum<string>

客户端类型

必需

pc-电脑端适配，h5-移动端适配

枚举值:

pch5

businessCode

string | null

业务id

可选

示例

{
    "psnAuthConfig": {
        "psnName": "string",
        "psnIDCardType": "string",
        "psnIDCardNum": "string",
        "psnMobile": "string",
        "psnBankCardNo": "string"
    },
    "pageConfig": {
        "psnEditableFields": [
            "psnName"
        ],
        "psnDefaultAuthMode": "face",
        "psnAvailableAuthModes": [
            "face"
        ]
    },
    "integrationConfig": {
        "redirectConfig": {
            "redirectUrl": "string",
            "redirectDelayTime": 0
        },
        "expirationTime": "string",
        "clientType": "pc"
    },
    "businessCode": "string"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'api.pre-qiandun365.com/api/open/psnCert/getUrl' \
--header 'Content-Type: application/json' \
--data-raw '{
    "psnAuthConfig": {
        "psnName": "string",
        "psnIDCardType": "string",
        "psnIDCardNum": "string",
        "psnMobile": "string",
        "psnBankCardNo": "string"
    },
    "pageConfig": {
        "psnEditableFields": [
            "psnName"
        ],
        "psnDefaultAuthMode": "face",
        "psnAvailableAuthModes": [
            "face"
        ]
    },
    "integrationConfig": {
        "redirectConfig": {
            "redirectUrl": "string",
            "redirectDelayTime": 0
        },
        "expirationTime": "string",
        "clientType": "pc"
    },
    "businessCode": "string"
}'

返回响应

🟢200成功

application/json

Body

result

object

必需

verifyStatus

enum<string>

验证结果

必需

passed二要素认证成功，un_passed二要素认证失败

枚举值:

passedun_passed

certUrl

string

认证链接

必需

code

string

请求结果编码

必需

200-请求成功，其他-请求失败

msg

string

请求结果信息

必需

logKey

string

日志索引

必需

string

请求时间戳

必需

success

boolean

是否请求成功

必需

true请求成功

示例

{
    "result": {
        "verifyStatus": "passed",
        "certUrl": "string"
    },
    "code": "string",
    "msg": "string",
    "logKey": "string",
    "ts": "string",
    "success": true
}

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

个人银行卡四要素核验

企业四要素核验

个人实名认证地址（页面）

请求头格式#

请求参数

示例代码

返回响应

请求头格式