REST API

API de assinatura digital
pronta para produção

REST API documentada, autenticação Bearer, webhooks, suporte nativo a fluxos complexos de assinatura — quórum, ordem, multi-signatário.

Ver documentação

endpoint para iniciar fluxo

<30s

do POST ao documento assinado

x509

certificado embutido no PDF

Início rápido

3 passos do zero ao funcionando

Crie sua conta

Acesse o painel e obtenha suas credenciais de API. Bearer token disponível imediatamente.

Faça o primeiro POST

Envie documento (base64) + lista de signatários em uma única chamada para /flow/init.

Receba o webhook

Quando todos assinarem, o PDF com certificados embutidos é entregue no seu endpoint via POST.

POST https://api.websigner.com.br/v1/flow/init

Exemplo mínimo

// Headers
Authorization: Bearer wsk_live_sua_chave_aqui
Content-Type: application/json

// Body
{
  "fileName": "contrato.pdf",
  "document": "JVBERi0xLjQK...",     // PDF em base64
  "webhook": "https://api.suaempresa.com/cb",
  "pools": [
    {
      "priority": 1,
      "signers": [
        { "email": "usuario@empresa.com", "document": "12345678900" }
      ]
    }
  ]
}

// Response 200
{
  "flowId": "wsf_3kR9mNpQxL",
  "signingUrl": "https://sign.websigner.com.br/s/3kR9mNpQxL",
  "x509_embedded": true,
  "status": "pending"
}

Módulos

4 módulos. Um SDK.

Cada módulo resolve um caso de uso específico. Use individualmente ou combine no mesmo fluxo.

Flow

/flow

Orquestração de múltiplos signatários com ordem de prioridade, quórum mínimo, pools de signatários e notificações automáticas por email.

POST/flow/init

GET/flow/status/{id}

POST/flow/sign

Direct Sign

/sign

Assinatura imediata sem criar fluxo persistente. Para integrações on-demand onde o signatário já está presente no momento da integração.

POST/provider/init

GET/sign/ready

POST/sign

Verify

/verify

Valida integridade e conformidade de assinaturas em PDF e XML. Detecta certificados ICP-Brasil, certificados efêmeros via Pix e algoritmos pós-quânticos (ML-DSA).

POST/verify

Pix Signature

/pix

Emite certificado efêmero via pagamento Pix. O signatário autentica sua identidade pelo app do banco, sem cadastro ou certificado próprio.

GET/pix/init/{id}

GET/pix/copiaCola/{id}

Referência

Todos os endpoints

Base URL: https://api.websigner.com.br/v1

Método	Endpoint	Descrição	Módulo
POST	/flow/init	Iniciar fluxo de assinatura com pools e signatários	Flow
GET	/flow/status/{id}	Consultar status do fluxo e signatários pendentes	Flow
POST	/flow/sign	Aplicar assinatura em fluxo ativo	Flow
POST	/provider/init	Descobrir provedores de certificado disponíveis	Direct
GET	/sign/ready	Verificar se sessão de assinatura está pronta	Direct
POST	/sign	Assinar documento diretamente (sem fluxo)	Direct
POST	/verify	Verificar assinaturas em PDF ou XML	Verify
GET	/pix/init/{id}	Gerar cobrança Pix para autenticação do signatário	Pix
GET	/pix/copiaCola/{id}	Obter código Pix Copia e Cola para o signatário	Pix

Webhook payload

POST https://api.suaempresa.com/callback

Fluxo concluído

{
  "event": "flow.completed",
  "flowId": "wsf_3kR9mNpQxL",
  "status": "completed",
  "completedAt": "2025-07-15T14:32:01Z",
  "document": {
    "fileName": "contrato_assinado.pdf",
    "base64": "JVBERi0xLjQK...",   // PDF com certificados x509 embutidos
    "hash": "sha256:3f2a9b1c..."
  },
  "signers": [{
    "email": "usuario@empresa.com",
    "signedAt": "2025-07-15T14:32:01Z",
    "method": "pix",
    "certificateSerial": "A1B2C3D4E5F6..."
  }]
}

Automação

Sem time de dev?
Conecte via N8N ou Make.

Automação completa de fluxos de assinatura sem escrever uma linha de código.

N8N

Use o nó HTTP do N8N para conectar WebSigner ao seu CRM, ERP ou qualquer sistema. Templates prontos disponíveis.

Make (Integromat)

Conecte WebSigner via Make em minutos. Dispare fluxos de assinatura a partir de Google Sheets, Airtable, Pipedrive e outros.

API de assinatura digitalpronta para produção