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.
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.
Do link à decisão
- 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. - 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.
- 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.
- 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.
- Resultado. A dívida passa para
signedou é 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:
| Campo | Valor |
|---|---|
cancel_reason_enumerator | rule_analysis_status |
cancel_reason | Operação cancelada por regra de assinatura do solicitante |
reason_description | O 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_enumerator | cancel_reason | Traz o dossiê |
|---|---|---|
rule_analysis_status | Operação cancelada por regra de assinatura do solicitante | Sim, no formato laas.credit_operation.status_change |
waiting_signature | Operação cancelada por falta de assinatura | Não |
fraud_base_flag | Fraude detectada na assinatura | Não |
face_validation_score | Validação facial não alcançou a pontuação mínima permitida | Não |
face_match_score | Similaridade entre a Selfie e o Documento insuficiente | Não |
liveness_result | Falhou na validação de prova de vida | Nã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 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
- Link de formalização: onde está o link na resposta da emissão e como a QI Tech o envia ao tomador.
- Webhooks de acompanhamento: link aberto, etapa concluída e jornada abandonada.
- Webhook de assinatura: a dívida assinada, com o dossiê.
- Webhook de cancelamento: a dívida cancelada por regra de assinatura, com o dossiê.
- Dossiê do signatário: os campos de
signers.
Glossário
| Termo | Significado |
|---|---|
| Jornada | A sequência de telas do QI Sign que o tomador percorre do link até a assinatura. |
| Etapa | Uma tela da jornada, como device_scan, face_recognition ou personal_document. |
| Regra de assinatura | Crité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ção | Análise manual do dossiê feita pelo originador antes de liberar o desembolso. |