API para assinatura de documentos

Assinatura digital integrada ao seu sistema.

Conecte seus documentos a um fluxo de assinatura digital por API e acompanhe cada etapa em um só lugar.

Para empresas de software, plataformas SaaS, ERPs e equipes que precisam incorporar assinatura de documentos aos próprios sistemas.

solicitacao-assinatura / sr_8f21c4

Dados ilustrativos

Contrato de prestação de serviço

Organização: Exemplo Tecnologia · Signatário: Maria Exemplo

aguardando autorização
  1. 1. Documento recebido

    contrato-servico-2431.pdf · 412 KB

  2. 2. Autorização do signatário

    Solicitação enviada · aguardando confirmação

  3. 3. Documento assinado disponível

    Consulta por API e webhook de conclusão

Como funciona

Três etapas entre o documento gerado no seu sistema e o arquivo assinado de volta.

  1. 01

    Seu sistema envia o documento

    Uma chamada de API entrega o PDF pronto, o signatário e uma referência interna do seu sistema.

  2. 02

    O signatário autoriza a assinatura

    O signatário recebe um endereço próprio para confirmar a autorização do documento.

  3. 03

    Seu sistema acompanha o resultado

    Você consulta o status, recebe notificação de conclusão e obtém o documento assinado.

Recursos previstos

Distinguimos o que já existe na infraestrutura de assinatura que dá origem ao serviço e o que depende de adaptação para a assinatura.online.

Verificado na API da PrescriContrato proposto — ilustrativoDepende de implementação/validação

Envio de PDF por URL ou base64

O documento é produzido pelo seu sistema e enviado pronto para assinatura.

Verificado na API da Prescri

Autorização do signatário

Fluxo de autorização individual por documento, com endereço dedicado e prazo de validade.

Verificado na API da Prescri

Consulta de status

Estados de acompanhamento como aguardando autorização, autorizado, assinado, falha e cancelado.

Verificado na API da Prescri

Notificações por webhook

Notificação de conclusão com assinatura HMAC-SHA256 no cabeçalho e novas tentativas em caso de falha.

Verificado na API da Prescri

Acesso ao documento assinado

Download do arquivo assinado e link público do documento após a conclusão.

Verificado na API da Prescri

Signatários de qualquer segmento

A infraestrutura atual identifica o signatário como profissional de saúde habilitado. Atender outros segmentos depende de adaptação no serviço existente.

Depende de implementação/validação
Para desenvolvedores

Uma chamada para iniciar a assinatura

O exemplo ao lado usa conceitos genéricos: organização, documento, signatário e solicitação de assinatura. As credenciais ficam no seu servidor — nunca no navegador.

Contrato proposto — ilustrativoEndereço de produção a definir
criar-solicitacao.ts
// Contrato proposto — ilustrativo. Endpoint ainda não disponível em produção.
const resposta = await fetch("https://api.assinatura.online/v1/signature-requests", {
  method: "POST",
  headers: {
    "X-API-Key": process.env.ASSINATURA_API_KEY,
    "X-API-Secret": process.env.ASSINATURA_API_SECRET,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    document_name: "Contrato de prestação de serviço",
    document_url: "https://seusistema.com.br/contratos/2431.pdf",
    signer: {
      full_name: "Maria Exemplo",
      document_number: "00000000000",
      email: "maria@exemplo.com.br",
    },
    external_id: "pedido-2431",
    webhook_url: "https://seusistema.com.br/webhooks/assinatura",
  }),
});

const { signature_request_id, status, authorize_url } = await resposta.json();
// status: "pending_authorization" -> envie authorize_url ao signatário
Contrato proposto — ilustrativo. Nomes de campos e endereço podem mudar após a validação técnica.

Casos de uso

Aplicações previstas como contratos, propostas e termos de aceite, sujeitas à compatibilidade da integração.

Sistemas empresariais

ERPs e sistemas de gestão que precisam coletar assinatura em contratos e documentos gerados internamente.

  • Contratos
  • Termos de aceite
  • Autorizações internas

Plataformas de serviços

SaaS que quer oferecer assinatura de documentos aos próprios clientes sem construir a infraestrutura.

  • Propostas comerciais
  • Contratos de adesão
  • Renovações

Fluxos de documentos

Times que automatizam etapas de aprovação e precisam registrar o resultado de cada solicitação.

  • Onboarding
  • Aprovações
  • Arquivamento

Modelo comercial

Ainda não há tabela de preços publicada. Queremos entender o volume mensal de documentos, o fluxo pretendido e as necessidades de integração antes de propor um formato comercial.

Conte no formulário como funciona hoje o seu processo de assinatura — respondemos com o que é possível e o que ainda depende de desenvolvimento.

Perguntas frequentes

Solicitar acesso à API

Deixe seus dados e uma descrição do fluxo que você precisa automatizar. O pedido fica registrado e visível apenas para a administração do serviço.

Quer começar agora? Faça o cadastro de parceiro e receba API Key e API Secret com 30 dias de teste após confirmar o e-mail.

  • Descreva o tipo de documento e o volume estimado.
  • Informe em qual sistema a assinatura será integrada.
  • Não envie documentos reais nem dados sensíveis por este formulário.

Usamos estes dados apenas para responder ao seu pedido de acesso.