电子签章（腾讯） · 公司对自然人签署

公司与自然人在线签合同:你发起后拿到一个签署链接发给本人, 链接里自动安排好一切——没实名的先人脸实名,然后手写签名(平台写字板,识别校验防代签), 最后输短信验证码完成签署;签完企业自动盖章,成品 PDF 带 CA 数字证书与时间戳,平台归档代持。鉴权与全站一致:X-App-Key + X-Timestamp + X-Sign 三个请求头。计费点只有一个:发起合同成功计一次,失败不计。

流程总览

开通(每家签约公司一次,由平台后台操作,无接口):
  企业认证授权 → 建印章 → 经办人授权/实名 → 设签署密码 → 平台自检盖章 → 就绪

每份合同(你的系统只需要这四步里的前两步):
  ① contract/create 发起 → 返回 contractNo + signUrl(发给自然人,微信/短信都行)
  ② 自然人打开 signUrl:实名(首次)→ 写字板手写签名 → 短信验证码签署
  ③ 平台自动:企业盖章 → 下载归档 → 回调通知你(可选)
  ④ contract/download 取回成品 PDF

① 发起合同 POST /api/v1/txcontract/contract/create

参数	必填	说明
taxNo	是	签约公司统一社会信用代码(须已在平台完成开通)
flowName	是	合同名称,签署人会看到
fileBase64	是	合同 PDF 的 base64(≤60M)。PDF 里要有两处定位关键字(见下)
signerName	是	自然人姓名(实名与手写校验都按它)
signerIdcard	是	自然人身份证号
signerMobile	是	自然人手机号(接短信验证码)
entKeyword	否	企业盖章位置关键字,默认「甲方盖章」,章盖在关键字下方
personKeyword	否	个人签名位置关键字,默认「乙方签字」
deadlineDays	否	签署截止天数,默认 30
callbackUrl	否	合同到终态(完成/过期/撤销)时平台 POST 通知你

返回 data:
{
  "contractNo": "TXC20261009065007E19F",   // 平台合同号,后续接口都用它
  "flowId": "yDIx...",                      // 腾讯流程号(对账用)
  "signUrl": "https://openapi.kailingteck.com/sign/xxxx"  // 发给自然人,一个链接管全程
}

② 查状态 POST /api/v1/txcontract/contract/status

参数	必填	说明
contractNo	是	平台合同号

字段	说明
status	`signing` 待自然人签 / `person_signed` 已签待盖章 / `completed` 完成 / `cancelled` 撤销 / `expired` 过期
statusText	上面状态的中文说法
archived	成品是否已归档(完成后平台自动归档)

③ 下载成品 POST /api/v1/txcontract/contract/download

参数	必填	说明
contractNo	是	平台合同号(须已完成)

字段	说明
fileBase64	成品 PDF 的 base64,带双方签章、CA 证书与时间戳
fileName	文件名

④ 撤销 POST /api/v1/txcontract/contract/cancel

参数	必填	说明
contractNo	是	平台合同号(已完成的合同不能撤)

回调通知(可选)

发起时传了 callbackUrl,合同到终态时平台 POST 一次:

{ "contractNo": "TXC...", "flowId": "yDIx...", "status": "completed",
  "signerName": "张三", "flowName": "xx合同", "completedAt": "2026-10-09T..." }

收到回 HTTP 200 即可;没收到也不要紧,随时可用「查状态」主动查,两边结果一致。

注意事项

合同 PDF 必须包含两处定位关键字(默认「甲方盖章」「乙方签字」),章和签名盖在关键字下方;没有关键字发起会失败。
签署链接长期有效、可反复打开:没实名时引导实名,实名完接着签,签完显示完成——本人只需要这一个链接。
手写签名有识别校验:必须一格一字、正楷书写本人姓名,写错或连笔会被要求重写,防止代签。
签署意愿为本人手机短信验证码;请确保 signerMobile 填本人实际在用的手机号。
成品 PDF 由平台归档代持,随时可下载;不要依赖腾讯的临时下载链接(仅 5 分钟有效)。