基础介绍
- 概述:海外签是为涉及海外业务的文件提供的线上化签署解决方案,涵盖【中国大陆 - 海外】、【海外 - 中国大陆】、【海外 - 海外】三类签署场景。
- 差异说明:与纯中国大陆用户直接发起签署不同,海外签在认证流程、通知方式、签署证据等方面存在较大差异。其目的是匹配全球范围内主流的电子签名应用方式,方便用户便捷使用及合规举证。
本公司海外签署场景的适用性主要由各国/地区的电子签名法规决定。关于具体情况,请咨询与您对接的商务经理获取详细信息。
效果展示
海外签署(H5端)
设置不使用大陆实名和意愿认证,采用访问口令方式进行验证演示:
(以上演示是接口获取的免登录链接,该链接在集成开发者自身系统时使用体验更友好)
若通过指定的用户邮箱打开签署链接,需先进行邮箱验证后进入:
《海外签补充条款》内容参考(PC端签署):
海外签证书报告示例:
API接口
API接口(点击直接跳转相关API文档) | API描述 | 是否必需 |
此接口用来发起签署,发起成功后会返回签署流程标识:signFlowId。 | 必需 | |
此接口获取签署方签署页面链接,可用于签署或预览。 | 按需 | |
此接口可以根据发起签署接口返回的signFlowId,来查询签署状态、签署配置等信息。 | 按需 | |
此接口可在签署流程结束后,下载签署后的PDF文件以及海外签证书报告。 | 建议 |
基于文件发起签署接口代码案例
相关参数
- signMode(签署模式):指定GLOBAL(海外签);
- globalWillingness(是否需要意愿认证):如果不需要刷脸、短信意愿、签署密码任意一种意愿方式,则传false;
- globalAuthModes(海外签身份验证方式):不需要身份验证,则传:NO_NEED,需要访问口令验证则传:ACCESS_CODE;
- globalAccessCode(海外签访问口令):访问口令验证方式的的口令码。
代码案例
平台自身自动签署和个人用户手动签署案例,个人是海外签认证方式(无意愿认证+访问口令方式)
{
"docs": [
{
"fileId": "请设置待签署文件的fileId",
"fileName": "请设置待签署文件的文件名称.pdf"
}
],
"signFlowConfig": {
"signFlowTitle": "此场景演示平台方自身、个人用户双方签署",
"noticeConfig": {
"noticeTypes": "1,2"
},
"signConfig": {
"signMode": "GLOBAL"
},
"notifyUrl": "请设置异步回调地址,以http/https开头",
"redirectConfig": {
"redirectUrl": "请设置重定向跳转地址,例如:https://www.esign.cn/"
}
},
"signers": [
{
"signerType": 1,
"signFields": [
{
"customBizNum": "自定义编码001",
"fileId": "请设置待签署文件的fileId",
"normalSignFieldConfig": {
"signFieldStyle": 1,
"autoSign": true,
"signFieldPosition": {
"positionPage": "3",
"positionX": 234,
"positionY": 191
}
}
}
]
},
{
"signerType": 0,
"psnSignerInfo": {
"psnAccount": "请设置个人用户的邮箱/手机号",
"psnInfo": {
"psnName": "请设置个人用户的名字"
}
},
"authConfig": {
"globalWillingness": false,
"globalAuthModes": "ACCESS_CODE",
"globalAccessCode": "123456"
},
"signFields": [
{
"customBizNum": "自定义编码002",
"fileId": "请设置待签署文件的fileId",
"normalSignFieldConfig": {
"signFieldStyle": 1,
"signFieldPosition": {
"positionPage": "3",
"positionX": 480,
"positionY": 197
}
}
}
]
}
]
}