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

POST

/open/api/gateway.do

支持自由职业者实名认证+合同生成、授权签约、签约链接生成
注：1.针对合同签约有特殊处理，如果设置了授权签约，不在生成返回签约链接
2.该接口集成实名认证/证件上传/合同生成/授权签约/签约地址生成，在个人和合同数据不存在情况耗时会较长
如果已经实名认证，不在进行认证，合同已经签约会返回status=true

请求参数

Body 参数application/json

apiCode

string

接口编码：SFT0109

必需

merchantNo

string

商户号

必需

requestNo

string

请求流水

必需

timestamp

string

时间戳

必需

version

string

版本号，固定2.0

必需

sign

string

签名

必需

bizModel

object (PersonRealNameContractModel)

必需

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

身份证国徽面

可选

taxBaseCode

string

签约服务商编码

必需

projectCode

string

项目编码

可选

如果商户特殊要求，需要按不同项目签约时

authSign

boolean

是否授权签约

可选

true:授权签约

genSignUrl

boolean

是否生成签约地址

可选

true:生成地址

示例

{
   "apiCode": "SFT0109",
    "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": "",
        "taxBaseCode": "234543543",
        "projectCode": "4353464423",
        "authSign": false,
        "genSignUrl": true
    }
}

示例代码

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": "SFT0109",
    "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": "",
        "taxBaseCode": "234543543",
        "projectCode": "4353464423",
        "authSign": false,
        "genSignUrl": true
    }
}'

返回响应

🟢200成功

application/json

Body

code

integer

响应码，200:成功

必需

msg

string

响应消息

必需

contractId

number

合同ID

必需

personId

number

自由职业者ID

必需

contractUrl

string

合同签约地址

可选

status

boolean

签约状态

必需

false 待签署 true 已签署如果是授权签约，会异步处理合同存证，不以这个返回稳准，通过接收通知或者主动查询确认最终合同签约结果

示例

{
    "code": 0,
    "msg": "string",
    "contractId": 0,
    "personId": 0,
    "contractUrl": "string",
    "status": true
}

实名认证(SFT0101)

身份证照片上传(SFT0102)