A Assinatura Expressa encapsula todo o fluxo de assinatura em um único POST. Crie a sessão, redirecione o signatário, receba o documento assinado.
9 perfis de autenticação · 3 modos de integração · SDKs em 6 linguagens
// Assinatura Expressa — 1 chamada
POST /v1/signing-sessions
Authorization: Bearer {token}
{
"purpose": "DOCUMENT_SIGNATURE",
"policy": {
"profile": "BIOMETRIC"
},
"signer": {
"name": "João da Silva",
"email": "joao@empresa.com",
"cpf": "12345678901"
},
"document": {
"content": "JVBERi0...",
"filename": "contrato.pdf"
},
"returnUrl": "https://app.empresa.com/sucesso"
}
// Response: 201 Created
{
"sessionId": "ss_01HWXYZ...",
"url": "https://sign.signdocs.com.br/s/...",
"clientSecret": "sds_secret_..."
}
A Assinatura Expressa abstrai o fluxo completo de transação, upload, signatários e autenticação em uma única requisição.
8+ chamadas · 2-4 semanas de integração
Documento inline, autenticação, checkout, evidence pack — tudo resolvido automaticamente.
1 chamada · Horas a 2 dias de integração
Redirect hospedado, widget embarcado ou controle total via headless — a mesma API, três experiências.
Redirecione o signatário para a página hospedada pelo SignDocs. Zero frontend. O signatário completa o fluxo e retorna para sua URL.
// Redireciona o signatário
window.location.href = session.url;
Ideal para: MVPs, integração rápida, sem frontend próprio
Incorpore o fluxo de assinatura diretamente na sua página com o SDK JavaScript. Sem sair do seu app.
SignDocs.mount('#container', {
clientSecret: session.clientSecret,
onComplete: (result) => { ... }
});
Ideal para: SaaS, plataformas, UX customizada
Controle total via API. Ideal para fluxos batch, automação e integração machine-to-machine sem UI interativa.
// Poll até completar
const result = await client
.signingSession.get(session.id);
Ideal para: Automação, batch, B2B headless
Mude o nível de segurança alterando apenas o campo "profile" na requisição.
Confirmação com um único clique. Rápido e sem fricção para documentos de baixo risco.
"profile": "CLICK_ONLY"
Ideal para: Termos de uso, avisos, confirmações
Clique seguido de verificação por código OTP enviado via e-mail.
"profile": "CLICK_PLUS_OTP"
Ideal para: Contratos de serviço, propostas
Selfie com prova de vida comparada à referência biométrica cadastrada.
"profile": "BIOMETRIC"
Ideal para: Onboarding, crédito, abertura de conta
Máxima segurança: biometria facial combinada com código OTP. Dupla verificação.
"profile": "BIOMETRIC_PLUS_OTP"
Ideal para: Operações financeiras de alto valor
Assinatura qualificada com certificado ICP-Brasil A1. Chave privada fica no cliente.
"profile": "DIGITAL_CERTIFICATE"
Ideal para: Documentos fiscais, atos societários
Validação de identidade contra a base governamental SERPRO DataValid em tempo real.
"profile": "BIOMETRIC_SERPRO"
Ideal para: Compliance regulatório, prevenção a fraudes
SERPRO DataValid com fallback automático para biometria local caso o serviço esteja indisponível.
"profile": "BIOMETRIC_SERPRO_AUTO_FALLBACK"
Ideal para: Alta disponibilidade, operações críticas
Prova de vida com fallback para comparação com foto de documento (CNH/RG/passaporte).
"profile": "BIOMETRIC_DOCUMENT_FALLBACK"
Ideal para: KYC, cadastro sem referência prévia
Crie fluxos sob medida combinando métodos e adicionando etapas específicas do seu negócio.
"profile": "CUSTOM"
Ideal para: Fluxos regulatórios, integrações complexas
SDKs tipados em desenvolvimento para acelerar sua integração
import { SignDocsBrasil } from '@signdocs-brasil/api';
const client = new SignDocsBrasil({ apiKey: 'sk_live_...' });
const session = await client.signingSession.create({
purpose: 'DOCUMENT_SIGNATURE',
policy: { profile: 'BIOMETRIC' },
signer: {
name: 'João da Silva',
email: 'joao@empresa.com',
cpf: '12345678901',
},
document: {
content: pdfBase64,
filename: 'contrato.pdf',
},
});
// Redirect ou embed
console.log(session.url); // URL do checkout hospedado
console.log(session.clientSecret); // Token para widget embed
@signdocs-brasil/api
signdocs-brasil
signdocsbrasil-go
signdocsbrasil-api
signdocs-brasil-php
SignDocsBrasil.Api
Todos os SDKs incluirão tipagem completa, tratamento de erros e exemplos prontos para uso.
Escolha a abordagem ideal para seu caso de uso
| Funcionalidade | Expressa | Transaction API |
|---|---|---|
| Chamadas para assinar 1 documento | 1 | 8+ |
| Tempo de integração | Horas a 2 dias | 2-4 semanas |
| Checkout hospedado | ||
| Widget embarcado (JS SDK) | ||
| Documento inline (base64) | Presigned URL | |
| Multi-signatários | Via Envelopes | |
| Perfis de autenticação | 9 perfis | 6 métodos |
| Webhooks | ||
| Evidence Packs criptográficos | ||
| Controle granular por etapa | Abstraído |
Para cenários que exigem controle granular de cada etapa — como fluxos condicionais ou pipelines de aprovação customizados — a Transaction API oferece a flexibilidade necessária. Para a maioria dos casos, a Assinatura Expressa resolve em minutos.
Personalize o checkout hospedado e o widget com a identidade visual da sua empresa.
{
"appearance": {
"brandColor": "#2563EB",
"companyName": "Acme Tecnologia",
"logoUrl": "https://acme.com/logo.png",
"headerStyle": "full"
},
"returnUrl": "https://app.acme.com/sucesso",
"cancelUrl": "https://app.acme.com/cancelado",
"locale": "pt-BR"
}
Receba notificações em tempo real quando o signatário completar, cancelar ou expirar a sessão.
Cada assinatura gera um evidence pack criptográfico (.p7m) com dupla camada de segurança — ECDSA para integridade e PKCS#7 para não-repúdio. Prova jurídica completa, gerada automaticamente.
// Webhook: SIGNING_SESSION.COMPLETED
{
"event": "SIGNING_SESSION.COMPLETED",
"data": {
"sessionId": "ss_01HWXYZ...",
"status": "COMPLETED",
"signedDocumentUrl": "...",
"evidencePackUrl": "...",
"completedAt": "2026-03-31T..."
}
}
A Assinatura Expressa atende os requisitos específicos de cada setor
Onboarding em 1 chamada com biometria SERPRO, CCBs, abertura de conta 100% express. Widget embarcado no app do banco.
Widget embarcado no seu produto. Seus clientes assinam sem sair da sua plataforma. Personalização completa com sua marca.
Consentimento informado, prontuários e contratos de planos de saúde com perfil BIOMETRIC para conformidade LGPD.
Certificado digital ICP-Brasil via Expressa. 1 chamada para assinatura qualificada em atos societários, licitações e contratos.
Respostas para as dúvidas mais comuns sobre a Assinatura Expressa
Solicite acesso ao sandbox ou fale com nosso time técnico
A maneira mais rápida de adicionar assinaturas digitais ao seu produto.