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

Modelo	Quando usar
QI Sign automático (default)	Não precisa configurar nada — QI envia link de assinatura por email/SMS pro borrower
QI Sign em lote	Várias operações num único envelope; ver Assinatura em Lote
PDF assinado externamente	Parceiro tem signature provider próprio; faz upload do PDF assinado
Data-signature: opt-in	Borrower clica "concordo" em um portal do parceiro; parceiro envia evidência
Data-signature: zip	Parceiro envia zip com evidências (logs, IPs, timestamps)
Data-signature: selfie	Biometria 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.