跳到主要内容

通过自拍签署合同

通过自拍认证适用于使用 QI Tech 信用分析服务的合作方，自拍认证经过验证后会生成证明 ID。

通过 QI Tech 信用分析端点生成的此 ID 可用作合同签署方式。

请求​

ENDPOINT
/debt/DEBT-KEY/signed
MÉTODO
POST
请求体
{
    "type": "data-signature",
    "signatures": [
        {
            "signed_object": {
                "raw_text": "Lorem ipsum dolor sit amet, consectetur a....",
                "document_key": "79003de0-2590-455d-9b73-426b8ca284eb",
                "document_md5": "7521bd5621d97af26b2c1721fc4023a8"
            },
            "authenticity": {
                "timestamp": "1970-01-01 00:00:01",
                "facial_recognition_key": "79003de0-2590-455d-9b73-426b8ca284eb"
            },
            "signer": {
                "name": "IVANILDO DE SENA LIMA",
                "email": "ivanlima2604@gmail.com",
                "phone": {
                    "country_code": "055",
                    "area_code": "11",
                    "number": "999999999"
                },
                "document_number": "61766976204"
            },
            "authentication_type": "opt-in"
        }
    ]
}

路径参数​

字段类型描述字符数
debt_key *string创建信贷操作时返回的债务密钥。-

请求体参数​

字段类型描述字符数
type *string将要发送的签署类型。-
signatures *array of objects包含签署证明对象的列表——在签署类型为"data-signature"时发送。signatures 对象

signatures 对象​

字段类型描述字符数
signed_objectobject包含正在签署文件的对象。signed_object 对象
authenticityobject包含认证数据的对象。authenticity 对象
signerobject包含签署人数据的对象。signer 对象
authentication_type *string签署类型。-

signed_object 对象​

字段类型描述字符数
raw_textstring包含将要签署的合同数据的连续文本（opt-in 类型认证必填）。-
document_keystring通过 API 1.1 发送的已签署文件的 DOCUMENT_KEY（仅当未发送"raw_text"字段时必填）。-
document_md5string通过 API 1.1 发送的已签署文件的 DOCUMENT_MD5（仅当未发送"raw_text"字段时必填）。-

authenticity 对象​

字段类型描述字符数
timestamp *string签署日期。-
facial_recognition_key *string必须包含 QI Tech 人脸识别 API 返回的 facial_recognition_key——此字段仅适用于"selfie"认证类型，且排除其他证明文件的强制要求。-

signer 对象​

字段类型描述字符数
name *string签署人姓名。-
email *string签署人电子邮件。-
phonestring签署人电话对象。phone 对象
document_number *string签署人证件号码。-

phone 对象​

字段类型描述字符数
country_code *string电话国家代码（https://ddi.guiamais.com.br/）3
area_code *string电话区号（https://ddd.guiamais.com.br/）2
number *string电话号码（仅数字）10

响应​

STATUS
200
响应体
{
  "data": {},
  "event_datetime": "2022-11-07 15:24:47",
  "key": "\<DEBT-KEY\>",
  "status": "signature_received",
  "webhook_type": "debt"
}

STATUS
400
响应体
{
  "data": "{\"title\": \"Bad Request\", \"description\": \"Invalid request body.\", \"translation\": \"Corpo da requisição inválido.\", \"extra_fields\": {}, \"code\": \"LEG000069\"}"
}