ACC-007-个人实名-H5地址

POST

https://getway.upfreework.com/openapi/v1/contract/sign-h5-url

💡

ACC-006-个人实名-短信通知和ACC-007-个人实名-H5地址二选一即可

若贵司系统内已预先保存客户的姓名、身份证号等基础信息，可通过接口将其同步传入，数据传入后会在链接中实时回显，减少客户后续录入的操作量。

1.本接口用于自由职业者的实名认证、海南税务登记。如果申请发票或进行海南完税开票，对应的自然人必须完成链接中的所有步骤。

短信：向传参中的手机号发送一条短信，短信中包含跳转URL链接，用户可在短信中直接打开URL进行实名认证等操作。

2.跳转链接的H5预览：

2.1 中间页（待实名）

2.2 实名信息填写页

2.3 中间页-实名完成（待关系绑定）

2.4 关系绑定-刷脸页

2.5 关系绑定列表页（绑定及解绑）

2.6 完成页

2.7 实名信息详情页

请求参数

Authorization

Header 参数

Body 参数application/json

示例

{
    "userInfo": {
        "name": "张三",
        "idNo": "110101199003076178",
        "phone": "13800138000",
        "bankNo": "6222020200023456789",
        "idNoFrontUrl": "https://example.com/images/id-front.jpg",
        "idNoBackUrl": "https://example.com/images/id-back.jpg"
    },
    "dutyId": 123456789,
    "redirectUrl": "https://example.com/redirect"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://getway.upfreework.com/openapi/v1/contract/sign-h5-url' \
--header 'appId: App202412230001' \
--header 'appId;' \
--header 'appSign;' \
--header 'appSign;' \
--header 'timeStamp;' \
--header 'timeStamp;' \
--header 'sign;' \
--header 'sign;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "userInfo": {
        "name": "张三",
        "idNo": "110101199003076178",
        "phone": "13800138000",
        "bankNo": "6222020200023456789",
        "idNoFrontUrl": "https://example.com/images/id-front.jpg",
        "idNoBackUrl": "https://example.com/images/id-back.jpg"
    },
    "dutyId": 123456789,
    "redirectUrl": "https://example.com/redirect"
}'

返回响应

🟢200成功

application/json

三要素验证失败

Body

示例

{
    "code": 0,
    "message": "成功",
    "context": {
        "url": "https://considerate-shore.com/"
    },
    "traceId": "68941d23dc86a72d3cfbc175ee1a2964",
    "spanId": "5c7a0992e63085a8"
}

修改于 2025-10-28 09:25:34

ACC-006-个人实名-短信通知

ACC-008-个人实名结果查询