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

POST

https://getway.upfreework.com/openapi/v1/contract/send-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

示例

{
	"customerList": [
		{
			"name": "张三",
			"idNo": "320123199001012345",
			"phone": "13800001111",
			"bankNo": "6222021234567890123",
			"idNoFrontUrl": "https://cdn.example.com/id/front_zhangsan.png",
			"idNoBackUrl": "https://cdn.example.com/id/back_zhangsan.png"
		},
		{
			"name": "李四",
			"idNo": "320123199502123456",
			"phone": "13900002222",
			"idNoFrontUrl": "https://cdn.example.com/id/front_lisi.png",
			"idNoBackUrl": "https://cdn.example.com/id/back_lisi.png"
		}
	],
	"dutyId": 10001,
	"directUrl": "https://example.com/contract/redirect"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://getway.upfreework.com/openapi/v1/contract/send-url' \
--header 'appId: App202412230001' \
--header 'appId;' \
--header 'appSign;' \
--header 'timeStamp;' \
--header 'sign;' \
--header 'Content-Type: application/json' \
--data-raw '{
	"customerList": [
		{
			"name": "张三",
			"idNo": "320123199001012345",
			"phone": "13800001111",
			"bankNo": "6222021234567890123",
			"idNoFrontUrl": "https://cdn.example.com/id/front_zhangsan.png",
			"idNoBackUrl": "https://cdn.example.com/id/back_zhangsan.png"
		},
		{
			"name": "李四",
			"idNo": "320123199502123456",
			"phone": "13900002222",
			"idNoFrontUrl": "https://cdn.example.com/id/front_lisi.png",
			"idNoBackUrl": "https://cdn.example.com/id/back_lisi.png"
		}
	],
	"dutyId": 10001,
	"directUrl": "https://example.com/contract/redirect"
}'

返回响应

🟢200成功

application/json

三要素验证失败

Body

示例

{
    "code": 904,
    "message": "三要素校验不通过",
    "context": [
        {
            "name": "张三",
            "idNo": "132302197902278809",
            "phone": "13888888888",
            "isValid": 0
        },
        {
            "name": "张三",
            "idNo": "132302197902278809",
            "phone": "13888888888",
            "isValid": 1
        }
    ],
    "traceId": "67e67c679247d31bda724a04c04d8c97",
    "spanId": "ca83779156e434f8"
}

修改于 2025-10-28 12:29:46

ACC-005-企业申请入驻海南税源地

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