Skip to main content

Selfie Signatures

Selfie authentication is available to partners using QI Tech's credit analysis services, where selfie authentication is validated, and a proof ID is generated.

This ID, generated through QI Tech's credit analysis endpoints, can be used as a contract signature.

Request

ENDPOINT
/debt/DEBT-KEY/signed
METHOD
POST
Request Body
{
"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"
}
]
}

Path Params

CampoTipoDescriçãoCaracteres
debt_key *stringChave da divida devolvida no momento da criação da operação de crédito.-

Body Params

CampoTipoDescriçãoCaracteres
type *stringTipo de assinatura que será enviada.-
signatures *array of objectsLista contendo objetos de comprovação de assinatura - deve ser enviado no caso de assinatura "type": "data-signature".Objects signatures

Object signatures

CampoTipoDescriçãoCaracteres
signed_objectobjectObjeto contendo o documento que esta sendo assinado.Objects signed_object
authenticityobjectobjeto com dados de autenticação.Objects authenticity
signerobjectObjeto com os dados do signatário.Object signer
authentication_type *stringTipo de assinatura.-

Object signed_object

CampoTipoDescriçãoCaracteres
raw_textstringTexto corrido com os dados do contrato que será assinado (Obrigatório para autenticação tipo opt-in).-
document_keystringDOCUMENT_KEY do arquivo assinado enviado a partir da API 1.1 (obrigatório apenas caso o campo "raw_text" não seja enviado).-
document_md5stringDOCUMENT_MD5 do arquivo assinado enviado a partir da API 1.1 (obrigatório apenas caso o campo "raw_text" não seja enviado).-

Object authenticity

CampoTipoDescriçãoCaracteres
timestamp *stringData da assinatura.-
facial_recognition_key *stringDeve conter o facial_recognition_key devolvido pela API de face recognition QI Tech - Este campo só é disponível para o authentication_type "selfie" e exclui a obrigatoriedade do envio de outras comprovações.-

Object signer

CampoTipoDescriçãoCaracteres
name *stringNome do signatário.-
email *stringE-mail do signatário.-
phonestringObjeto de telefone do signatário.Object phone
document_number *stringNumero de documento do signatário.-

Object phone

CampoTipoDescriçãoCaracteres
country_code *stringCódigo DDI do telefone (https://ddi.guiamais.com.br/)3
area_code *stringCódigo DDD do telefone (https://ddd.guiamais.com.br/)2
number *stringNúmero de telefone (apenas números)10

Response

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

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