通过文件发起合同
准备工作
1、下载 SDK
2、下载 DEMO
您的第一个合同
1、打开根目录下的 config.php 修改第 7、8、11 行，设置 SecretId 、 SecretKey、UserId；
2、打开 byfile 目录下的 quick-start.php 修改 personName、personMobile，设置姓名和手机号为自己的信息；
3、在项目根目录下执行以下命令启动脚本：
php byfile/quick-start.php
此时，给自己发起的第一个合同已经成功，控制台输出：
您创建的合同id为：
yDRxxxxxxxxxx
签署链接（请在手机浏览器中打开）为：
https://res.ess.tencent.cn/xxxx
请访问以下地址下载您的合同：
https://file.test.ess.tencent.cn/file/xxx
您可以查收短信或直接到 DEMO 小程序登录进行签署。Demo 小程序码如下:
三步完成正式环境接入
第一步：配置接入信息
打开根目录下的 config.php 修改第 7、8、11 行，设置 SecretId 、 SecretKey、UserId 为您正式环境下的信息；
第二步：通过文件发起合同
打开 byfile 目录下的 quick-start.php ，根据您的实际业务需求修改：
● $filePath：
发起文件所在的实际路径，可以使用类似于下面的方式声明路径：
$filePath = __DIR__ . '../file/xxx.pdf'; // 相对路径
$filePath = 'https://xxx.pdf' // 从网络获取文件
您也可以直接获取文件的 base64 内容，配置在 $fileBase64 变量中，而不使用本地文件！
● $flowName：
合同名称，根据您的实际业务场景来自行定义，名称为不超过 200 个字符的中英文均可；
● $approvers：
approvers 指定了合同的签署方信息、合同签署方的签署控件等内容；
✈ 快速学习：关于签署人信息、签署控件的拼接
参数配置完成后，即可：
在项目根目录下执行以下命令启动脚本，在正式环境一键发起合同！
php byfile/quick-start.php
第三步：下载合同文件
第二步调用发起合同得到的 FlowId，会自动传入 DescribeFileUrls 函数用于获取合同链接，在浏览器中访问控制台打印出的链接即可下载合同文件。
至此，恭喜，您已完成腾讯电子签集成版正式环境的全部接入工作，您可以继续：
- 将接入代码修改为接口并部署在服务端，提供给客户使用
- 继续探索更高级的特性
正式接入
准备工作
3、修改配置文件 设置 SecretId 、 SecretKey、UserId 为您正式环境下的信息
服务端正式环境接入
通过文件发起合同
服务端如果要集成文件发起合同功能，需要在接口（客户入参）、本地环境获取发起合同的相关参数，例如：
根据您的实际业务场景，封装通过文件发起合同函数（可以直接参考“第一个合同”中的代码）；
例如：
function CreateFlowByFiles($operatorUserId, $filePath,
$flowName, ...)
{
// 根据您的实际业务逻辑构造签署人
$approvers = BuildApprovers();
...
// 发起合同
›
// 获取：FlowId：$resp['FlowId']；签署链接：$resp['SchemeUrl']
// 您的其他业务逻辑
...
}
签署回调
签署回调简介：
通过签署回调，您可以在合同状态产生变化接受到来自电子签的通知，通知包含合同、签署人的信息等内容。
如您需要开通此功能，需提供一个能接受 HTTP POST 请求的回调地址，请确保该地址提供的服务可公网访问并正常处理回调通知。
电子签推送的回调内容有进行加密处理，在接受到回调通知后需用配置好的 key 进行解密。
设置签署回调：
1、下载回调接收文件，于 ess-php-kit/callback 目录中
2、在项目根目录下执行 php callback/CallbackUrlKey.php 生成属于您的 key：
修改 CallbackServer.php 第 5 行，设置回调 key，可于 34 行加入相关业务处理逻辑
3、将 CallbackServer.php 放到服务器 web 目录下，打开 https://域名/CallbackServer.php 查看是否成功
4、在电子签控制台-应用管理配置回调地址和 key(正式接入时)