对接常见问题

认证相关

问题1：调用接口需要的Token和Secret如何获取？

​ 登录开放平台控制台进行企业注册，认证申请通过后，登陆后在配置--开发设置目录下，通过添加应用可获取相关的Token和Secret。

问题2：企业认证必须要做吗?

​ 认证是必须要做的，测试环境中填写的数据至少保证企业名称要真实。

问题3：契约锁提供的个人实名认证中，默认认证流程的具体流程顺序是什么？

​ 具体流程分为两步：手机三要素（身份证、手机号、姓名）认证、人脸认证，其中流程中任一一步通过认证，均不再往下认证,即：如果三要素认证通过则不会继续进行人脸认证。

问题4：如何指定个人接收方的认证方式？

​ 契约锁提供3种认证方式供发起方选择，默认（三要素认证、人脸识别认证和人工审核认证任一通过即可）、人脸识别认证、银行卡认证。指定方式：登录契约锁云平台：文件 –>业务分类，修改业务分类中的认证方式，并在调用创建合同接口时，将该业务分类作为参数传入接口即可。

问题5：个人认证三种方式分别是怎么样的流程：

​ 1. 手机号、用户名、身份证号 三要素认证：会发送短信验证码验证手机号是否正确，验证用户名与身份证号是否匹配

​ 2. 银行卡认证：页面需要填写手机号、用户名、身份证号、银行卡号、银行预留手机号，对手机号进行验证和其他信息进行验证

​ 3. 人脸认证，页面需要填写手机号、用户名、身份证号，会录制人脸视频，校验用户名、身份证号与视频信息是否相互匹配

问题6：如果客户系统已经集成了实名认证，签署方签署合同的时候可以跳过契约锁的实名认证吗？

​ 可以跳过认证，需要将业务分类中的实名认证设置为“无需认证”，但是这对于我们平台来说，该签署方并没有完成实名认证，所以使用该功能的对接方需要提前签署风险须知。

问题7：调用认证接口返回的认证页面为何没有打开过就失效了？

​ 确认复制链接之后是否对链接进行了用聊天软件，包括但不限于QQ、微信等进行传递发送操作，导致了链接失效。链接只能打开一次，此类聊天软件有对链接的安全校验，会在后台默认打开。

合同发起相关

问题1：测试环境下，账户余额为0.00，无法发起合同。

​ 测试环境下，可以联系客服同事进行充值。

问题2：发起合同时提示错误“用户认证信息与合同经办人信息不匹配：**”，是什么原因导致的？

​ 接收方手机号对应的账号已经实名认证通过，且认证的姓名与发起时填写的不相符，所以会提示上述错误，建议检查并确认接收方的名称是否有误之后，再重新发起合同。

问题3：如果要求接收方在签署合同的同时也提交相应的材料，如身份证正反面照片，毕业证照片等，应该怎么设置？

​ 可以在云平台的业务分类模块下，基础信息设置中配置签署方，勾选按预设方式添加签署方，可设置接收方的附件要求；或者调用发起合同接口时，可设置接收方附件（Attachment）的相关信息，这样接收方在签署时便会要求上传对应附件。

问题4：在契约锁云平台创建了一个业务分类，也配置了签署流程，如何在接口发起合同时使用该签署流程发起合同？

​ 调用创建合同草稿接口的时候，category参数指定该业务分类后发起，即可使用该业务分类中指定的签署流程，未指定使用默认业务分类的签署流程。

问题5：使用接口创建草稿状态的合同，为什么在云平台上看不到相关合同信息？

​ 草稿状态的合同只有创建人能查看，所以在接口创建的合同为草稿状态下，需要通过creator参数指定创建人，创建人登陆云平台后就可以看到相应的合同草稿信息了。

模板相关

问题1: 为什么在开放平台控制台维护好文件模板，通过调用使用模板创建合同接口时，提示没有使用模板的权限、或模板Id无效？

​ 开放平台控制台维护的文件模板与契约锁云平台维护的文件模板是两个隔离的文件模板种类，不可混用，新版接口使用的是契约锁云平台上维护的文件模板，请登录契约锁云平台：文件 –- 文件模板获取相应的模板Id。

问题2：为什么在云平台维护模板时，上传的包含参数的Word文档，系统未识别为参数模板，或部分参数未正确识别？

​ 请检查当前WORD文档中用于表示参数的符号“{”和”}”是否均为英文半角符号，文件中需用"{{参数名称}}"来标识参数。

问题3： 参数模板中相同的参数名称创建时，是如何替换的？

​ 云平台在上传参数模板时，若识别到存在多个相同参数，会提示是否自动重命名，若选择自动重命名，参数名称会自动在后面加数字标识，在其后发起合同时需要注意核对重命名后的参数名依次替换，若未重命名，则会所有相同的参数名的值均会替换为相同的值。

签署相关

问题1：如何跟进合同的进度状态，使业务系统能够知道合同的流转情况？

​ 合同支持状态回调，可以在业务分类中配置回调地址，文件在签署过程中，若发生签署、拒绝签署、撤回、退回等事件时，契约锁电子签署平台服务器会向应用的“回调地址”推送相应的事件消息。

问题2：为什么开启了签署短信通知，在签署时为什么没有收到短信提醒？ 请确认当前签署流程，如果发起合同为顺序签署，则签署是按照顺序执行的，前序节点未签署完成，后续节点不可签署，只有当当前节点可签署时，才会发送短信。如果发起合同为无序签署，则在合同发起后所有的接收方均会受到短信。

问题3：手机短信发送的签署链接会不会过期？

​ 链接不会过期，但是合同有过期时间，合同过期时间可以设置，合同没有在过期时间前完成所有签署就不能继续签署了。

问题4：每次签署前都希望签署方进行人脸识别校验，可以在哪里配置？

​ 在契约锁云平台相应的业务分类：基础信息设置--接收方-认证要求模块下勾选人脸识别即可。

问题5：签署的时候可以不允许接收方退回合同吗？

​ 可以，登陆契约锁云平台，在对应的业务分类下：基础信息设置--签署方模块下取消勾选“允许接收方退回文件”选项。

问题6：在发起合同时，作为发起方，添加了经办人签字节点，可以通过接口调用完成经办人签字吗？

​ 目前签署接口仅支持公章签署、法人章签署、审批和作废流程，经办人签字需对应经办人登录契约锁云平台，在页面上进行签署。

问题7：调用签署合同接口时，什么情况下可以不传签署位置参数？

​ 在合同相应的业务分类中，配置预设流程，指定了签署印章和签署位置后，在调用接口签署合同时，可以不传签署位置（stampers）参数。

问题8： 合同签署完成后，若有合同参与方以外的人想要在契约锁云平台查看和管理签署完成的合同，该怎么配置？

​ 若企业需要一位员工登录契约锁云平台便可以查看所有接口完成的合同 ，需要借助平台上的业务分类->签署流程设置->签署完成->查看中将该名员工加入到查看人中，并保证其需要查看的合同在发起时是以该业务分类发起的。

问题9： 调用公章以及法人章签署接口时均提示“this contract is not turn to sign or has bean signed”，是什么原因导致的？

​ 这种情况一般是合同未到公章或者法人章的签署节点导致的，一般会有如下情况会导致该问题：

​ 1. 合同未发起或者合同已经完成，可通过获取合同详情接口查看合同状态；

​ 2. 合同中不存在调用方的公章或法人章签署节点，请检查发起接口时接收方是否包含该签署节点；

​ 3. 若合同发起时存在调用方的公章或法人章签署节点，调用接口仍失败，请检查是否指定了经办人签署，目前经办人签署仅可登陆契约锁云平台进行签署，签署完成后即可正常调用接口。

印章相关

问题1： 对接方为什么不能在云平台上维护其他公司的印章？

​ 对接方调用接口签章的数字证书是颁发给对接方公司的，就算是维护了第三方公司的公章，在电子合同上，也是属于对接方的签章动作，并不能代表第三方公司签章，没有法律效力。

问题2：通过印章ID签署，印章的大小是印章图片原本的大小吗？印章显示大小是否可设置？

​ 印章大小在创建印章的时候可以设置 ，在签署的时候不能修改大小。

其他配置相关

问题1：为什么在登录契约锁云平台后无法查看文件模板、业务分类、以及印章等相关配置？

​ 如果该用户未认证或加入企业，请认证或加入企业后，将身份切换到公司即可查看，若已加入公司，则同样将身份切换至公司，并且保证该用户有相关查看权限后，即可查看。

问题2：都是对接方内部企业，两个公司可以使用同一个token调用接口吗？

​ 可以的，登陆云平台，将企业认证通过的子公司加入下级法人单位管理中，接口调用时相应的加上子公司名称（tenantName）参数即可。