如何快速接入已经托管的电子合同
当您在环球签 App 中完成模板创建并完成托管后,即可通过 API 快速发起电子合同。无论是为自己发起还是为他人(如客户、用户)发起,只需几步即可完成接入。
前提条件:
• 您已在 App 中创建并成功托管一份合同模板;
• 模板中已正确设置签名区、印章位及可编辑输入框。
• 您已在 App 中创建并成功托管一份合同模板;
• 模板中已正确设置签名区、印章位及可编辑输入框。
第一步:进入 API 接入页面
- 打开 环球签 App 首页;
- 找到您要使用的已托管模板;
- 点击该模板右侧的 “开始” 按钮;
- 在弹出的操作选项中,选择 “接入 API”。

第二步:选择合同发起类型
系统将引导您选择合同的使用场景:
👤 自行发起合同
适用于:
您本人作为签署方之一,与他人签约(如老板与员工、个人与供应商)。
特点:
• 您需完成活体认证
• 合同由您主动发起并签署
👥 为他人发起合同
适用于:
SaaS 平台、HR 系统、电商平台等为终端用户代发合同。
特点:
• 无需您本人签署
• 通过 API 动态传入签署人信息
• 支持批量发起
根据您的业务场景,点击对应选项查看对应文档。
第三步:获取 API 文档与调用参数
- 系统将自动生成该模板的 专属 API 接入文档;
- 文档包含:
– API 请求地址(Endpoint)
– 所需 Header(如 Authorization)
– 请求 Body 结构(含字段名、签署人手机号、角色等)
– 返回示例与错误码说明 - 不同的合同模版中所需的内容与校验码是完全不同的,因此您在创建每份合同模版后都应仔细检查合同模版中的内容和输入框等信息是否有误,并核对好API文档中对应的输入信息。
💡 小贴士: 所有可编辑字段的名称(如 {{name}}、{{amount}})已在 API 文档中明确列出,确保传参字段名一致即可自动填充。若有接入问题可联系我们帮您解答。
第四步:测试并上线
- 使用测试环境调用 API,验证合同能否正常生成;
- 检查签署链接是否能正确跳转、字段是否填充准确;
- 确认无误后,切换至生产环境正式使用。