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

Campo	Tipo	Descrição	Caracteres
debt_key *	string	Chave da divida devolvida no momento da criação da operação de crédito.	-

Body Params

Campo	Tipo	Descrição	Caracteres
type *	string	Tipo de assinatura que será enviada.	-
signatures *	array of objects	Lista contendo objetos de comprovação de assinatura - deve ser enviado no caso de assinatura "type": "data-signature".	Objects signatures

Object signatures

Campo	Tipo	Descrição	Caracteres
signed_object	object	Objeto contendo o documento que esta sendo assinado.	Objects signed_object
authenticity	object	objeto com dados de autenticação.	Objects authenticity
signer	object	Objeto com os dados do signatário.	Object signer
authentication_type *	string	Tipo de assinatura.	-

Object signed_object

Campo	Tipo	Descrição	Caracteres
raw_text	string	Texto corrido com os dados do contrato que será assinado (Obrigatório para autenticação tipo opt-in).	-
document_key	string	DOCUMENT_KEY do arquivo assinado enviado a partir da API 1.1 (obrigatório apenas caso o campo "raw_text" não seja enviado).	-
document_md5	string	DOCUMENT_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

Campo	Tipo	Descrição	Caracteres
timestamp *	string	Data da assinatura.	-
facial_recognition_key *	string	Deve 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

Campo	Tipo	Descrição	Caracteres
name *	string	Nome do signatário.	-
email *	string	E-mail do signatário.	-
phone	string	Objeto de telefone do signatário.	Object phone
document_number *	string	Numero de documento do signatário.	-

Object phone

Campo	Tipo	Descrição	Caracteres
country_code *	string	Código DDI do telefone (https://ddi.guiamais.com.br/)	3
area_code *	string	Código DDD do telefone (https://ddd.guiamais.com.br/)	2
number *	string	Nú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\"}"
}