ZapAssinaCentral de Ajuda

API: criar e usar tokens

Para quem envia documentos

Integrar o ZapAssina ao seu sistema.

A API permite criar documentos (com ou sem modelo), acompanhar assinaturas, alterar signatários e prazos e receber eventos. O formato segue o padrão usual das plataformas de assinatura, o que facilita migrar automações já existentes. Está disponível nos planos que incluem API.

  1. Em Integrações (administradores), crie um token de API com um nome que identifique o sistema.
  2. Copie o token na hora: ele não é mostrado de novo.
  3. Envie o token no cabeçalho Authorization: Bearer.

Token de teste (sandbox)

Marque Token de teste (sandbox) ao criar o token para desenvolver a integração sem custo. Ele começa com zpa_test_ e funciona mesmo em planos sem API. Os documentos criados com ele:

  • levam a marca TESTE - SEM VALIDADE JURÍDICA em todas as páginas e não recebem o selo da plataforma;
  • não contam na franquia do plano;
  • mandam convites e códigos só por e-mail (o WhatsApp vira e-mail);
  • aparecem como teste no painel e na verificação de autenticidade.

Documentação completa, com exemplos: Documentação da API.

Trate o token como uma senha. Se ele vazar, clique em Revogar e crie outro. Não use o token de teste para documentos de verdade: eles não têm validade jurídica.