Assinatura eletrônica de documentos no Brasil. API REST, SDKs oficiais em nove linguagens e integrações prontas — com verificação por e-mail, WhatsApp ou certificado digital ICP-Brasil (A1/A3), trilha de atividades e verificação pública de documentos assinados.

Brazilian e-signature platform: REST API, official SDKs in nine languages and ready-made integrations. English version.

Site · Documentação da API · Sandbox

Todos autenticam por chave de API (X-Api-Key, recomendado para back-end), token bearer ou OAuth 2.1, e trazem paginação, tratamento de erros tipado e verificação de assinatura de webhook.

Definidos por signatário em signers[].verification_method ao criar o assignment:

¹ A verificação é gratuita; a notificação por WhatsApp custa 0,45 crédito e está disponível apenas em planos pagos.

Cada solicitação de assinatura usa um documento da franquia do plano; quando a franquia acaba, o documento extra custa 1 crédito.

O método de verificação e o de notificação são acoplados: envie um, os dois ou nenhum — o lado que faltar é inferido. Sem nenhum dos dois, ambos assumem Email.

DigitalCertificate exige o recurso Certificado Digital (planos Standard e Pro), CPF ou CNPJ em government_id, e que o signatário esteja sozinho no seu passo de assinatura. Um CPF exige o certificado daquela pessoa (e-CPF, ou e-CNPJ que a nomeie como representante legal); um CNPJ exige um e-CNPJ da empresa.

A assinatura em si é um handshake de dois passos com a extensão Web PKI, não um envio de campos:

POST /v1/signers/certificate/start     → data.token   (token da operação Web PKI)
        ↓  o navegador assina o token com o certificado do signatário
POST /v1/signers/certificate/complete  → data.signerName

Ambas as rotas são extensões implantadas somente em produção: o sandbox não as expõe e elas não constam do documento OpenAPI publicado.

• GET /v1/documents/{id}/activities — todos os eventos registrados do documento, cada um com um snapshot do payload do evento e a origin da requisição (ip, user-agent).
• Artefatos em GET /v1/documents/{id}/download/{artifactName}: original, certificated, certificate-page, pades e bundle (zip com todos). O artefato pades — assinaturas ICP-Brasil dos signatários mais a caixa de certificação da plataforma — existe apenas em documentos que tiveram signatários por certificado digital.
• Verificação pública — GET /v1/documents/{documentSignatureHash}/verify confere um documento assinado pelo hash da assinatura, sem autenticação.

Produção: https://api.assinafy.com.br · Sandbox: https://sandbox.assinafy.com.br

Cada conta registra 1 endpoint de webhook, ou até 3 nos planos pagos, cada um com URL, lista de eventos e assinatura próprias. Com signing_enabled, as entregas seguem o padrão Standard Webhooks: cabeçalhos webhook-id, webhook-timestamp e webhook-signature (HMAC-SHA256 com o segredo whsec_ do endpoint, que pode ser rotacionado).

Antes de disparar as assinaturas, POST /v1/documents/{id}/assignments/estimate-cost devolve o custo em créditos com o detalhamento por item — documento extra, notificação por WhatsApp, assinatura por certificado digital. Há o equivalente para templates em POST /v1/accounts/{accountId}/templates/{templateId}/documents/estimate-cost.

Assinafy is a Brazilian e-signature platform. A REST API, official SDKs in nine languages (TypeScript, Python, Go, Java, .NET, PHP, Ruby, Rust, Object Pascal) and mobile SDKs for Android and iOS.

Signer identity is verified by email OTP, WhatsApp OTP, or the signer's own ICP-Brasil A1/A3 digital certificate via the Web PKI browser extension — the last producing a qualified PAdES signature. Every document carries a full activity trail (each event with its payload snapshot and request origin), downloadable artifacts including the PAdES and certification-page PDFs, and public hash-based verification.

Authenticate with an X-Api-Key header (recommended for back-ends), a bearer JWT, or OAuth 2.1 with PKCE for apps and AI assistants acting in another user's workspace. Webhooks support up to 3 endpoints on paid plans, with Standard Webhooks signatures. A free sandbox at https://sandbox.assinafy.com.br supports integration testing. The signer certificate handshake endpoints are available only in production.

Start with the API documentation.

Os SDKs oficiais são distribuídos sob a licença MIT. Consulte a licença de cada integração no respectivo repositório; o plugin WordPress usa GPL-2.0-or-later.