Para Desenvolvedores

1 Chamada. 1 Integração. Documentos Assinados.

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_..."
}

De 8+ chamadas para 1. Sem brincadeira.

A Assinatura Expressa abstrai o fluxo completo de transação, upload, signatários e autenticação em uma única requisição.

Transaction API (Tradicional)

  1. 1POST /v1/transactions (criar transação)
  2. 2PUT presigned URL (upload do documento)
  3. 3POST /signers (adicionar signatários)
  4. 4POST /authentication (configurar autenticação)
  5. 5POST /send (enviar para assinatura)
  6. 6GET /transactions/{id} (verificar status)
  7. 7GET /evidence-pack (baixar evidências)
  8. 8Error handling em cada etapa

8+ chamadas · 2-4 semanas de integração

Assinatura Expressa

  1. 1POST /v1/signing-sessions (cria tudo em 1 chamada)
  2. 2Redirecione ou embeba o widget
  3. 3Webhook SIGNING_SESSION.COMPLETED

Documento inline, autenticação, checkout, evidence pack — tudo resolvido automaticamente.

1 chamada · Horas a 2 dias de integração

3 Modos de Integração. Escolha o Seu.

Redirect hospedado, widget embarcado ou controle total via headless — a mesma API, três experiências.

Redirect Hospedado

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

Widget Embarcado

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

Headless / Programático

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

9 Perfis de Autenticação. 1 Parâmetro.

Mude o nível de segurança alterando apenas o campo "profile" na requisição.

CLICK_ONLY

Aceite com Clique

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

CLICK_PLUS_OTP

Clique + Código OTP

Clique seguido de verificação por código OTP enviado via e-mail.

"profile": "CLICK_PLUS_OTP"

Ideal para: Contratos de serviço, propostas

BIOMETRIC

Biometria Facial

Selfie com prova de vida comparada à referência biométrica cadastrada.

"profile": "BIOMETRIC"

Ideal para: Onboarding, crédito, abertura de conta

BIOMETRIC_PLUS_OTP

Biometria + OTP

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

DIGITAL_CERTIFICATE

Certificado Digital

Assinatura qualificada com certificado ICP-Brasil A1. Chave privada fica no cliente.

"profile": "DIGITAL_CERTIFICATE"

Ideal para: Documentos fiscais, atos societários

BIOMETRIC_SERPRO

Biometria + SERPRO

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_AUTO_FALLBACK

SERPRO com Fallback

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

DOCUMENT_FALLBACK

Biometria + Documento

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

CUSTOM

Fluxo Customizado

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 Oficiais — Em Breve

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

TypeScript

@signdocs-brasil/api

Python

signdocs-brasil

Go

signdocsbrasil-go

Java

signdocsbrasil-api

PHP

signdocs-brasil-php

C# (.NET)

SignDocsBrasil.Api

Todos os SDKs incluirão tipagem completa, tratamento de erros e exemplos prontos para uso.

Assinatura Expressa vs Transaction API

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.

Sua Marca, Sua Experiência

Personalize o checkout hospedado e o widget com a identidade visual da sua empresa.

  • Logo e cores da sua marca no checkout
  • Nome da empresa exibido ao signatário
  • URLs de retorno customizáveis (sucesso / cancelamento)
  • Suporte a pt-BR, en e es
{
  "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"
}

Webhooks + Evidence Packs

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..."
  }
}

Casos de Uso por Segmento

A Assinatura Expressa atende os requisitos específicos de cada setor

Fintechs e Bancos

Onboarding em 1 chamada com biometria SERPRO, CCBs, abertura de conta 100% express. Widget embarcado no app do banco.

Onboarding Crédito CCB

SaaS e Plataformas

Widget embarcado no seu produto. Seus clientes assinam sem sair da sua plataforma. Personalização completa com sua marca.

Widget White-label Multi-tenant

Saúde

Consentimento informado, prontuários e contratos de planos de saúde com perfil BIOMETRIC para conformidade LGPD.

Consentimento Prontuários LGPD

Jurídico e Governo

Certificado digital ICP-Brasil via Expressa. 1 chamada para assinatura qualificada em atos societários, licitações e contratos.

ICP-Brasil Licitações Contratos

Perguntas frequentes

Respostas para as dúvidas mais comuns sobre a Assinatura Expressa

Comece com a Assinatura Expressa

Solicite acesso ao sandbox ou fale com nosso time técnico

1 POST. 1 Integração. Comece Agora.

A maneira mais rápida de adicionar assinaturas digitais ao seu produto.