实名认证(SFT0101)

POST

/open/api/gateway.do

自由职业者

1.支持身份证二要素(姓名+身份证号)和银行卡三要素认证(姓名+身份证号+银行卡号)
2.身份证图片不做OCR解析，默认商户上送的照片正确可信
注：
1）个人信息已经注册过后，不在进行认证
2）身份信息作为后续服务商报税使用，保证真实有效

请求参数

Body 参数application/json

apiCode

string

接口编码:SFT0101

必需

merchantNo

string

商户号

必需

requestNo

string

请求流水

必需

timestamp

string

时间戳

必需

version

string

接口版本

必需

固定2.0

sign

string

签名

必需

bizModel

object (PersonRealNameModel)

接口参数对象

必需

realName

string

姓名

必需

certNo

string

身份证号

必需

bankCardNo

string

银行卡号

可选

mobileNo

string

手机号码

必需

authType

string

认证类型

可选

默认EC2, E0 不认证 EC2: 身份证二要素认证 (姓名+身份证号) EM3: 运营商三要素认证 (姓名+身份证号+手机号) EB3: 银行卡三要素认证 (姓名+身份证号+银行卡号) EB4: 银行卡四要素认证 (姓名+身份证号+银行卡号+手机号)

fileType

string

文件类型

可选

URL:地址 BASE64:base64格式

idCardFront

string

身份证人像面

可选

idCardBack

string

身份证国徽面

可选

示例

{
    "apiCode": "SFT0101",
    "merchantNo": "1088202103120003",
    "requestNo": "eb4eae77-78f7-439a-9650-50cc42ea9601",
    "timestamp": "20240111112612",
    "version": "2.0",
    "sign": "iWQVsQBISu0+7gatdav1Mj9vQ9IKTYKcb9pXtk4IBSg396E1p2b+vDWCOMdlBCcQo9cPaWTZum9zvFk+fEbzWrlo9XIb/njJK9/zDGXt1c1RDUvAuTqn3EwYc/orpaP1RKDXxIpOqQ7PdR7LqnHLWSQIKP7WljvKbhBey0LqzAA=",
    "bizModel": {
        "realName": "谢高龙",
        "certNo": "345645655455647566",
        "bankCardNo": "3453453453454",
        "mobileNo": "18682008122",
        "auth": false,
        "authType": "BNAK",
        "fileType": "URL",
        "idCardFront": "",
        "idCardBack": ""
    }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/open/api/gateway.do' \
--header 'Content-Type: application/json' \
--data-raw '{
    "apiCode": "SFT0101",
    "merchantNo": "1088202103120003",
    "requestNo": "eb4eae77-78f7-439a-9650-50cc42ea9601",
    "timestamp": "20240111112612",
    "version": "2.0",
    "sign": "iWQVsQBISu0+7gatdav1Mj9vQ9IKTYKcb9pXtk4IBSg396E1p2b+vDWCOMdlBCcQo9cPaWTZum9zvFk+fEbzWrlo9XIb/njJK9/zDGXt1c1RDUvAuTqn3EwYc/orpaP1RKDXxIpOqQ7PdR7LqnHLWSQIKP7WljvKbhBey0LqzAA=",
    "bizModel": {
        "realName": "谢高龙",
        "certNo": "345645655455647566",
        "bankCardNo": "3453453453454",
        "mobileNo": "18682008122",
        "auth": false,
        "authType": "BNAK",
        "fileType": "URL",
        "idCardFront": "",
        "idCardBack": ""
    }
}'

返回响应

🟢200OK

application/json

Body

code

integer

响应码，200:成功

必需

msg

string

响应消息

必需

personId

number

自由职业者ID

必需

示例

{
    "code": 200,
    "msg": "成功",
    "personId": 1316806079669153800
}

🟢201Created

🟠401Unauthorized

🟠403Forbidden

🟠404Not Found

自由职业者

实名认证+合同综合接口(SFT0109)