跳到主要内容

Modelos de Formalização

A QI Tech suporta 5 modelos de formalização da operação militar — escolha conforme a infraestrutura do parceiro (se já tem signature provider, se quer usar QI Sign, se vai usar biometria).

Modelos disponíveis​

ModeloQuando usar
QI Sign automático (default)Não precisa configurar nada — QI envia link de assinatura por email/SMS pro borrower
PDF assinado externamenteParceiro tem signature provider próprio; faz upload do PDF assinado
Data-signature: opt-inBorrower clica "concordo" em um portal do parceiro; parceiro envia evidência
Data-signature: zipParceiro envia zip com evidências (logs, IPs, timestamps)
Data-signature: selfieBiometria via CaaS (face match + liveness)

QI Sign Automático​

Não requer chamada adicional após /debt. QI envia URL de assinatura pro borrower (email/SMS). Quando o borrower assina, webhook debt fires com status: signature_finished e a esteira segue.

Pré-requisito: o RequesterConfiguration tem default_signature_method apontando pra QI Sign.

PDF assinado externamente​

POST /debt/{DEBT_KEY}/signed
{
  "signed_document_key": "<uuid retornado pelo upload do PDF assinado>"
}

Pré-requisito: fazer upload do PDF assinado via POST /upload antes de chamar /signed.

Data-signature: opt-in​

{
  "data_signature": {
    "type": "opt_in",
    "evidence": {
      "ip_address": "200.123.45.67",
      "user_agent": "Mozilla/5.0 ...",
      "timestamp": "2026-05-17T14:30:00Z"
    }
  }
}

Data-signature: zip​

Parceiro empacota evidências em .zip e envia via upload. O signed_document_key aponta pro zip.

Data-signature: selfie​

Requer integração com CaaS (face recognition + liveness). O signed_document_key aponta pra um image_key retornado pelo CaaS.

Webhook após formalização​

debt com status: signature_finished → indica que QI aceitou a formalização. Em seguida, a averbação é confirmada (se reservation_method: issuing) e o desembolso entra na fila.

Próximo passo​

Após o signature_finished, a operação segue automaticamente: averbação confirmada (se issuing) → desembolso PIX/TED → webhook debt (disbursed).

Para acompanhar via webhooks: Webhooks. Para cancelar a qualquer momento: Cancelamento.