AssinAPI

Verificação de identidade

Além do e-mail/SMS e do CPF, você pode exigir foto do documento e selfie. Com aprovação manual, o documento só é concluído depois que você conferir as fotos.

Como ativar

  • requireDocumentPhoto: true — foto do RG/CNH (frente obrigatória, verso opcional).
  • requireSelfie: true — selfie tirada pela câmera do aparelho.
  • requireIdentityApproval — você aprova as fotos antes da conclusão. Padrão: true quando há foto do documento; false só com selfie (fica como evidência).

Por signatário (signers[]) ou como padrão para todos no POST /v1/signature-requests. No dashboard: Novo documento → Verificação extra.

Fluxo

  1. O signatário abre o link, vê o PDF, confirma CPF e código.
  2. O portal pede as fotos (câmera com moldura; no computador, também aceita arquivo). Elas são comprimidas no aparelho e enviadas cifradas.
  3. Ele assina. Com aprovação manual, o envelope fica em IN_PROGRESS, o signatário com identity.status = IN_REVIEW, e você recebe signer.identity_submitted.
  4. Você aprova (POST /v1/envelopes/{id}/signers/{signerId}/identity/approve) → se todos já assinaram, o documento é concluído e o PDF é gerado.
  5. Ou reprova com motivo (/identity/reject): por padrão o signatário recebe um link novo para reenviar só as fotos — a assinatura dele continua válida.

Para analisar: dashboard (botão “Analisar” no documento) ou GET /v1/envelopes/{id}/signers/{signerId}/identity, que lista os envios e as URLs das imagens (exigem a sua API key). Envelopes em que todos já assinaram e só falta a sua análise não expiram.

Segurança e LGPD

  • Imagens cifradas com AES-256-GCM no storage; o banco guarda apenas o SHA-256 de cada foto, que entra no hash da assinatura e no manifesto de evidências.
  • As fotos não aparecem no PDF nem na verificação pública — só o status (“aprovada manualmente”) e os hashes.
  • Não há reconhecimento facial automático: a comparação é feita por quem aprova. Formatos aceitos: JPEG, PNG ou WebP até 8 MB.