Skip to main content

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). Adicionalmente, pra agrupar várias operações num único envelope (recomendado em compra de dívida), use Assinatura em Lote.

Várias operações no mesmo envelope

Em compra de dívida com N duplas debt_purchase + refinancing (+ refin/refin consolidador), use Assinatura em Lote (POST /document/document_batch com type: military_payroll_external_batch) — o militar assina tudo de uma vez só.

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
QI Sign em loteVárias operações num único envelope; ver Assinatura em Lote
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.