Skip to main content

Formalização pelo QI Sign - regras de negócio

O QI Sign é a plataforma de assinatura eletrônica da QI Tech. Quando a sua integração formaliza dívidas (CCB) pelo QI Sign, o tomador assina o contrato numa jornada própria: abre o link, passa pelas etapas configuradas (prova de vida, selfie, documento de identificação, dados pessoais) e assina. A QI Tech avalia as evidências coletadas e decide se a dívida segue para o desembolso ou é cancelada.

Esta seção cobre o ciclo inteiro: o link que você recebe na emissão, os webhooks que acompanham o tomador durante a jornada e os webhooks que encerram a formalização, com o dossiê do tomador.

Outras formas de assinatura

Esta seção não cobre a coleta de assinatura feita pelo parceiro (envio do PDF assinado, opt-in, selfie própria). Para essas, veja Formalização de dívida.

  1. Emissão. Você emite a dívida pelo POST /debt. A resposta já traz o link de formalização de cada signatário. Ver Link de formalização.
  2. Envio do link. A QI Tech envia o link ao tomador por WhatsApp, SMS ou e-mail. Se a sua integração for configurada para não enviar, você entrega o link ao tomador pelo seu próprio canal.
  3. Jornada. O tomador abre o link e percorre as etapas. Se o webhook de acompanhamento estiver habilitado, você recebe um evento quando o tomador abre o link, quando conclui uma etapa e quando abandona a jornada. Ver Webhooks de acompanhamento.
  4. Análise. Ao final da jornada, o QI Sign avalia as evidências contra as regras de assinatura configuradas para você. Ver Quem decide a assinatura.
  5. Resultado. A dívida passa para signed ou é cancelada, e você recebe o webhook correspondente. O webhook de assinatura e o de cancelamento por regra de assinatura trazem o dossiê do tomador. Ver Webhook de assinatura e Webhook de cancelamento.

Se o tomador não assina dentro do prazo, a dívida é cancelada com o motivo waiting_signature (Operação cancelada por falta de assinatura). Esse cancelamento não traz dossiê, porque a jornada não terminou.

Quem decide a assinatura​

As regras de assinatura são avaliadas pelo QI Sign, com a configuração do originador. Elas incluem as regras obrigatórias da QI Tech: base de fraude, validação facial, similaridade entre a selfie e o documento e prova de vida. Também podem incluir regras sobre o documento de identificação lido na jornada, como sinais de adulteração.

Quando uma regra reprova a assinatura, a dívida é cancelada com:

CampoValor
cancel_reason_enumeratorrule_analysis_status
cancel_reasonOperação cancelada por regra de assinatura do solicitante
reason_descriptionO nome da regra que reprovou. Ex.: face_validation.

Esse é o motivo esperado para toda reprovação de assinatura. O webhook de cancelamento traz o dossiê completo do tomador, para que você entenda a reprovação sem abrir um chamado. Hoje o dossiê no cancelamento vem só no formato laas.credit_operation.status_change; veja Webhook de cancelamento — Os dois formatos.

Regras mais brandas com mesa de aprovação​

Alguns originadores configuram no QI Sign regras mais brandas e analisam o dossiê numa mesa de aprovação própria. Nesse modelo, menos assinaturas são reprovadas na jornada, e o originador decide com base no dossiê que chega no webhook de assinatura. Se a decisão for recusar, o originador cancela a dívida antes do desembolso. Ver Cancelamento de dívida antes do desembolso.

Motivos de cancelamento ligados à assinatura​

cancel_reason_enumeratorcancel_reasonTraz o dossiê
rule_analysis_statusOperação cancelada por regra de assinatura do solicitanteSim, no formato laas.credit_operation.status_change
waiting_signatureOperação cancelada por falta de assinaturaNão
fraud_base_flagFraude detectada na assinaturaNão
face_validation_scoreValidação facial não alcançou a pontuação mínima permitidaNão
face_match_scoreSimilaridade entre a Selfie e o Documento insuficienteNão
liveness_resultFalhou na validação de prova de vidaNão

Os quatro últimos motivos são da validação que a QI Tech faz quando a integração não usa as regras de assinatura do QI Sign. Essas regras já estão configuradas no QI Sign, então numa integração atual a reprovação chega como rule_analysis_status.

O dossiê do tomador​

O dossiê é a lista signers do webhook: um objeto por signatário com os dados informados, as imagens da selfie e do documento, os resultados de biometria e prova de vida, os dados do dispositivo e o horário da assinatura. A estrutura é a mesma na assinatura e no cancelamento. Ver Dossiê do signatário.

As URLs das imagens expiram

As URLs de signers[].images são temporárias e expiram cerca de 24 horas depois do envio do webhook. Baixe e guarde os arquivos ao receber o webhook.

Dados extras da jornada​

Uma configuração do QI Sign acrescenta ao dossiê os dados extras coletados na jornada:

  • document.ocr: os dados lidos do documento de identificação (nome, CPF, filiação, datas) e os indicadores de autenticidade do documento.
  • liveness.flags: os indicadores da prova de vida.

Esta documentação descreve o dossiê com os dados extras, que é a configuração que a QI Tech está levando para todos os originadores. Para habilitá-la na sua integração, fale com o time de suporte da QI Tech.

Conteúdo desta seção​

  1. Link de formalização: onde está o link na resposta da emissão e como a QI Tech o envia ao tomador.
  2. Webhooks de acompanhamento: link aberto, etapa concluída e jornada abandonada.
  3. Webhook de assinatura: a dívida assinada, com o dossiê.
  4. Webhook de cancelamento: a dívida cancelada por regra de assinatura, com o dossiê.
  5. Dossiê do signatário: os campos de signers.

Glossário​

TermoSignificado
JornadaA sequência de telas do QI Sign que o tomador percorre do link até a assinatura.
EtapaUma tela da jornada, como device_scan, face_recognition ou personal_document.
Regra de assinaturaCritério avaliado pelo QI Sign sobre as evidências da jornada. Uma regra reprovada cancela a dívida.
DossiêAs evidências de um signatário, entregues em signers nos webhooks de assinatura e de cancelamento.
Mesa de aprovaçãoAnálise manual do dossiê feita pelo originador antes de liberar o desembolso.