# Preços para uso via API

O uso via API segue os mesmos planos do uso normal via aplicação, porém o valor pago pelos planos funciona como um comprometimento de uso e incidem custos adicionais caso a soma do uso total via API exceda o valor do plano. O plano grátis não possui cobrança, porém **não poderá exceder 20 documentos por mês**.

Você pode conferir o consumo atual de API na seção de [Planos e Pagamento da sua conta](https://painel.autentique.com.br/perfil/planos#api).

### Preços por documentos e solicitação de assinatura

{% tabs %}
{% tab title="BRL" %}

<table><thead><tr><th width="472">Ação</th><th>Preço (BRL)</th></tr></thead><tbody><tr><td>Criar documento</td><td>R$ 0,06</td></tr><tr><td>Solicitação de assinatura por email</td><td>R$ 0,013</td></tr><tr><td>Solicitação de assinatura por Whatsapp</td><td>R$ 0,12</td></tr><tr><td>Solicitação de assinatura por SMS</td><td>R$ 0,16</td></tr><tr><td>Solicitação de assinatura por link assinado por email</td><td>R$ 0,013</td></tr><tr><td>Solicitação de assinatura por link assinado por SMS</td><td>R$ 0,16</td></tr><tr><td>Solicitação de assinatura por link assinado por Whatsapp</td><td>R$ 0,12</td></tr><tr><td>Assinatura com validação adicional por SMS</td><td>R$ 0,16</td></tr></tbody></table>
{% endtab %}

{% tab title="USD" %}

<table><thead><tr><th width="472">Action</th><th>Price (USD)</th></tr></thead><tbody><tr><td>Criar documento</td><td>$ 0,01</td></tr><tr><td>Solicitação de assinatura por email</td><td>$ 0,002</td></tr><tr><td>Solicitação de assinatura por Whatsapp</td><td>$ 0,02</td></tr><tr><td>Solicitação de assinatura por SMS</td><td>$ 0,03</td></tr><tr><td>Solicitação de assinatura por link assinado por email</td><td>$ 0,002</td></tr><tr><td>Solicitação de assinatura por link assinado por SMS</td><td>$ 0,03</td></tr><tr><td>Solicitação de assinatura por link assinado por Whatsapp</td><td>$ 0,02</td></tr><tr><td>Assinatura com validação adicional por SMS</td><td>$ 0,03</td></tr></tbody></table>
{% endtab %}
{% endtabs %}

Os preços são acumulativos, considerando o número de signatários e os métodos utilizados.&#x20;

{% hint style="info" %}
**Exemplo:** Documento criado com 2 signatários (um via email e outro via whatsapp):

* Criar documento: R$ 0,06
* Signatário 1 - Solicitação de assinatura por email: R$ 0,013
* Signatário 2 - Solicitação de assinatura por WhatsApp: R$ 0,12

**Custo total do documento: R$ 0,193**
{% endhint %}

Os signatários adicionados por link de assinatura possuem uma cobrança com base no método utilizado pelo signatário ao assinar o documento. Assinaturas via login com Google, Microsoft e Facebook não possuem custo.

{% hint style="info" %}
E**xemplo:** Documento criado com 2 signatários (ambos via link de assinatura):

* Criar documento: R$ 0,06
* Signatário 1 - Assina via login Google (Grátis)
* Signatário 2 - Assina via link no WhatsApp (R$ 0,12)

**Custo total do documento: R$ 0,18**
{% endhint %}

O custo de assinatura por whatsapp via link é diferente do custo de solicitação de assinatura por whatsapp devido às categorias de envio da API do Whatsapp. No caso da assinatura por link, é enviado um token OTP para o whatsapp do signatário, incidindo em um custo maior pelas categorias de envio da API do Whatsapp. Tenha isso em mente ao criar o seu fluxo de assinatura para aproveitar da melhor forma possível os custos de envio.

{% hint style="success" %}
Caso você possua um caso de uso interessante que seja inviabilizado por estes preços, entre em contato com nosso time comercial. É possível negociar condições personalizadas por volume dentro do plano corporativo.
{% endhint %}

### Preços por query

Algumas queries têm custo para sua execução, esta cobrança tem o objetivo principal de evitar implementações que requisitem dados em excesso (todos nós já fizemos algo assim, mas a conta das gambiarras que pessoal fez começou a ficar bem cara do nosso lado, por favor não nos use como o seu backend =P).&#x20;

{% tabs %}
{% tab title="BRL" %}

<table><thead><tr><th width="307">Query</th><th>Preço (BRL)</th></tr></thead><tbody><tr><td>Resgatar dados de um documento</td><td>R$ 0,001</td></tr><tr><td>Envio de Webhook</td><td>R$ 0,0002</td></tr></tbody></table>
{% endtab %}

{% tab title="USD" %}

<table><thead><tr><th width="307">Query</th><th>Price (USD)</th></tr></thead><tbody><tr><td>Resgatar dados de um documento</td><td>$ 0,0002</td></tr><tr><td>Envio de Webhook</td><td>$ 0,00004</td></tr></tbody></table>
{% endtab %}
{% endtabs %}

A cobrança não é por query, mas por cada documento resgatado. Então se você solicitar 10 documentos em uma query, será cobrado R$ 0,001 \* 10.

{% hint style="warning" %}
Você normalmente não precisa se preocupar com o custo por query, a não ser que esteja fazendo algo MUITO errado. Caso você observe uma cobrança significativa por queries, recomendamos sentar no chuveiro em posição fetal e repensar a sua escolha de carreira.
{% endhint %}

### Preços por Webhook

Para a atualização de informações na plataforma de forma eficiente, é diponibilizado o cadastro de endpoints para recebimentos de webhooks. É a forma sem gambiarras, para atualizar seus sistemas com a informação mais recente de um documento. Acesse a [documentação](/api/2/integracao/webhooks.md) e caso tenha dúvidas entre em contato com nosso suporte.

{% hint style="info" %}
Todos os envios de webhooks possuem custo de processamento e por isso todos serão contabilizados na cobrança.
{% endhint %}

Em nossa implementação, os eventos de webhooks que falharem são exibidos em uma listagem no painel, para que o usuário visualize e reenvie. O evento é que falham também são contabilizados, mas quando reenviados não.

{% hint style="warning" %}
Eventos dos [webhooks (deprecado)](/api/2/integracao/webhooks-1.md) também são contabilizados, mas não são listados na página de webhooks que falharam.&#x20;
{% endhint %}

### Limites de requisições

Cada plano possui um limite padrão de requisições por minuto (rate limit) por token de API. Se precisar de mais, é só nos chamar para ajustarmos conforme sua necessidade.

<table><thead><tr><th width="157">Plano</th><th>Limite padrão</th></tr></thead><tbody><tr><td>Grátis</td><td>10 por minuto</td></tr><tr><td>Profissional</td><td>60 por minuto</td></tr><tr><td>Corporativo</td><td>200 por minuto</td></tr></tbody></table>

### Cobrança e comprometimento de uso

O valor pago pelo plano funciona como um compromisso mínimo mensal. Caso o consumo da API ultrapasse esse valor, o excedente será cobrado em uma fatura mensal extra, referente ao uso do mês anterior.

{% hint style="info" %}
**Exemplo:** Organização com plano profissional (R$ 99,00/mês) criando 1.000 Documentos via API com 2 signatários cada por email:

* Criar documento: R$ 0,06 × 1.000 = R$ 60,00
* Dois signatários via email por documento: R$ 0,013 × 1.000 × 2 = R$ 26,00

Consumo total: R$ 86,00 (abaixo do valor do plano).

**Cobrança final: Apenas o valor do plano R$ 99,00.**
{% endhint %}

{% hint style="info" %}
**Exemplo:** Organização com plano profissional (R$ 99,00/mês) criando 1.000 Documentos via API com 2 signatários cada por Whatsapp:

* Criar documento: R$ 0,06 × 1.000 = R$ 60,00
* Dois signatários via Whatsapp por documento: R$ 0,12 × 1.000 × 2 = R$ 240,00

Consumo total: R$ 300,00 (acima do valor do plano).

**Cobrança final: R$ 99,00 (plano) + R$ 201,00 (excedente) = R$ 300,00.**
{% endhint %}

***

**Importante:** O uso normal da aplicação web não gera custos adicionais e não interfere na cobrança do uso via API.

{% hint style="info" %}
Você cria 1.000 documentos via API com signatários por email (R$ 86,00).

Em seguida, cria 2.000 documentos via app.

O valor total cobrado será apenas o do plano (R$ 99,00).Sandbox e testes
{% endhint %}

### Sandbox e testes

Documentos criados com o parâmetro `sandbox: true` não são cobrados em sua criação e resgatado. Porém eles servem exclusivamente para testes e são excluídos automaticamente em alguns dias.

{% hint style="danger" %}
**Não use documentos reais em Sandbox**, ela serve exclusivamente para testes. Os documentos de sandbox são automaticamente excluídos e não geram registros de auditoria. Não é possível auditar as assinaturas nem autenticar os documentos de sandbox.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.autentique.com.br/api/2/precos-para-uso-via-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
