> ## Documentation Index
> Fetch the complete documentation index at: https://docs.truthlocks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Sistema de Faturamento

> Preços por uso, níveis de plano e gerenciamento de uso para sua organização Truthlocks.

Truthlocks usa um modelo de faturamento pay-per-use onde você paga apenas pelo que consome. Cada organização (inquilino) tem sua própria assinatura, contadores de uso e ciclo de faturamento. Recursos e cotas são aplicados com base no seu plano ativo.

## Níveis de plano

* **Centrado no Inquilino**: Cada inquilino (Organização) tem sua própria assinatura e ciclo de faturamento.
* **Direitos**: Recursos e cotas são impostos com base na chave do plano ativo (`plan_developer`, `plan_starter`, `plan_business`, `plan_institutional`, `plan_enterprise`).
* **Multi-Provedor**: Roteamos pagamentos através de diferentes gateways (Stripe, Paystack, Flutterwave) dependendo da jurisdição legal do inquilino.
* **Preços Regionais**: O checkout usa automaticamente o país da sua conta para aplicar as taxas e moedas regionais corretas. Veja [roteamento de provedor](https://docs.truthlocks.com/pt/billing/provider-routing.md) para detalhes.

## Níveis de Plano

> [card] Desenvolvedor
>
> Para entusiastas e projetos de prova de conceito. Inclui verificação online e suporte da comunidade sem custo.

> [card] Iniciante
>
> Para PMEs e startups com cargas de trabalho de produção. Cotas mais altas, até 3 endpoints de webhook e processamento prioritário.

> [card] Negócios
>
> Para equipes de médio porte com necessidades de conformidade. SAML SSO, provisionamento SCIM, RBAC completo e logs de auditoria, até 10 endpoints de webhook e um SLA de suporte de 4 horas.

> [card] Institucional
>
> Para grandes empresas com necessidades avançadas de segurança. Log de transparência privado, integração HSM e um SLA de suporte de 1 hora.

> [card] Empresarial
>
> Preços personalizados para governos e empresas da Fortune 500. SLA personalizado, opções de implantação on-premise, suporte 24/7 e integração personalizada.

## Conceitos essenciais

* **Direitos** — cada plano desbloqueia recursos e cotas específicas (limites de cunhagem, contagens de verificação, assentos, armazenamento, limites de taxa de API). O serviço de faturamento impõe esses limites na camada da API.
* **Contadores de uso** — os medidores disponíveis são relatados para o ciclo de faturamento selecionado. Você pode monitorar seu consumo no painel de uso do console ou na [API de uso](https://docs.truthlocks.com/pt/api-reference/billing/usage.md).
* **Roteamento multi-provedor** — os pagamentos são processados através do gateway ideal para sua região. Veja [roteamento de provedor](https://docs.truthlocks.com/pt/billing/provider-routing.md) para detalhes.

## Produtos medidos

Truthlocks mede 16 produtos organizados em quatro categorias. Você pode ver todos eles na [página de preços](https://www.truthlocks.com/pricing) e acompanhar seu consumo no console em **Configurações > Faturamento > Uso**.

### Core

| Produto | Descrição | Taxa padrão |
| :- | :- | :- |
| Cunhagens de atestado | Atestados criados via API ou SDK | \$0.25 por cunhagem |
| Verificações | Solicitações de verificação de atestado | \$0.10 por verificação |
| Armazenamento | Armazenamento total de arquivos e evidências consumido | Incluído por plano |
| Pacotes de prova | Pacotes de prova criptográfica gerados | Incluído por plano |
| Endpoints de webhook | Registros de endpoint de webhook ativos | Incluído por plano |
| Entregas de webhook | Tentativas de entrega de webhook individuais | Incluído por plano |
| Assentos | Assentos de membros da equipe em sua organização | Incluído por plano |

### MAIP (Identidade da Máquina)

| Produto | Descrição | Taxa padrão |
| :- | :- | :- |
| Agentes | Agentes de máquina registrados | Por nível de plano |
| Sessões | Sessões de agente criadas por mês | Por nível de plano |
| Cálculos de pontuação de confiança | Cálculos de pontuação de confiança sob demanda | Por nível de plano |
| Verificações de conformidade | Solicitações de verificação de conformidade | Por nível de plano |

### IA

| Produto | Descrição | Taxa padrão |
| :- | :- | :- |
| Atestações de conjunto de dados | Conjuntos de dados atestados para rastreamento de linhagem | Por nível de plano |
| Atestados de modelo | Modelos de ML atestados para proveniência | Por nível de plano |

### Antifraude

| Produto | Descrição | Taxa padrão |
| :- | :- | :- |
| Sinais de risco | Sinais de fraude ingeridos ou gerados | Por nível de plano |
| Varreduras de Deepfake | Solicitações de varredura de Deepfake e personificação | Por nível de plano |
| Registros de velocidade | Registros de ação de pontuação de velocidade | Por nível de plano |

> [!NOTE]
>
> Use a [página de preços](https://www.truthlocks.com/pricing) para preços publicados. A API de fatura projetada atualmente precifica as cunhagens e verificações; outros produtos precisam de seu acordo de preços aplicável.

## Cartões de tarifa

As taxas por uso para cunhagens e verificações são:

| Operação | Taxa |
| :- | :- |
| Cunhagem de atestado | \$0.25 por cunhagem |
| Verificação | \$0.10 por verificação |

As taxas são visíveis no console em **Configurações > Faturamento > Uso**.

> [!NOTE]
>
> As taxas foram reduzidas em 50% no lançamento de março de 2026. As taxas anteriores eram de US$ 0,50 por cunhagem e US$ 0,20 por verificação.

### Tabelas de preços personalizadas para parceiros

Os administradores da plataforma podem criar tabelas de preços personalizadas com preços por operação para locatários parceiros. Use isso para oferecer preços negociados a parceiros estratégicos ou clientes de volume sem alterar suas taxas de plano padrão.

Cada tabela de preços define preços unitários para cunhagens e verificações, e pode ser atribuída a um ou mais locatários com uma data efetiva.

As taxas negociadas se aplicam a cada operação de produção faturável enquanto o acordo estiver em vigor. Um limite de recursos não é uma permissão gratuita. As permissões gratuitas para desenvolvedores, assinaturas de consumidores, atividades de sandbox e pilotos aprovados sem custo são separadas dos preços comerciais negociados.

As faixas de volume são graduadas: se as primeiras 100 operações custam US$ 0,25 cada e as operações subsequentes custam US$ 0,20, 101 operações custam US\$ 25,20. Uma faixa posterior não reprecifica operações anteriores. As faixas devem cobrir a quantidade total sem lacunas ou sobreposições.

Uma tabela de preços de parceria com desconto não é um piloto gratuito. Um piloto aprovado tem um prazo de validade e limites de uso, sem conversão paga automática.

> [!NOTE]
>
> O uso aceito agora é registrado em um livro-razão imutável e separado por ambiente, com sua taxa, país e instantâneo do plano. Os preços são fixados na aceitação pelo serviço de faturamento, não fornecidos pelo carimbo de data/hora de preenchimento de um chamador. Novos preços não reprecificam registros aceitos. Contadores agregados antigos não são cobrados retroativamente.
>
> Meses UTC fechados produzem rascunhos de fatura automaticamente. Um rascunho não é pagável: sua emissão requer MFA da equipe, um contrato de fatura ativo na moeda correspondente, país de faturamento verificado, confirmação do acordo do cliente e revisão fiscal explícita. Este fluxo de trabalho não cobra métodos de pagamento salvos nem envia e-mail. Fundos verificados recebidos são registrados separadamente, com verificações de referência duplicada e saldo pendente.
>
> Planos gratuitos, planos de consumidor, atividade de sandbox e pilotos aprovados sem custo são excluídos do uso comercial tarifado. A falta de evidências de ambiente ou precificação para operações centrais mantém o mês afetado para revisão. A liquidação automática atualmente suporta o catálogo de tarifas denominado em USD, incluindo seus descontos regionais; outras moedas são mantidas para revisão.

### Projeções de uso

A página de uso do console mostra o consumo registrado e sua tabela de preços atual. A API de fatura projetada autenticada estima os custos de cunhagem e verificação usando a tabela de preços padrão; ela não resolve taxas negociadas privadas, impostos, subsídios gratuitos ou uma fatura emitida.

Navegue até **Configurações > Faturamento > Uso** para inspecionar o uso e as taxas. Leia as faturas emitidas separadamente.

## Cotas de direito

Seu plano determina as seguintes cotas:

| Cota | Desenvolvedor | Iniciante | Negócios | Institucional | Corporativo |
| :- | :- | :- | :- | :- | :- |
| Cunhagens de atestado | 500/mês | Superior | Personalizado | Personalizado | Personalizado |
| Verificações mensais | Dependente do plano | Dependente do plano | Dependente do plano | Dependente do plano | Dependente do plano |
| Emissores | 1 | Múltiplos | Personalizado | Personalizado | Dependente do plano |
| Assentos | 1 | Múltiplos | Personalizado | Personalizado | Personalizado |
| Chaves de assinatura | 1 | Múltiplas | Personalizado | Personalizado | Dependente do plano |
| Endpoints de webhook | 1 | 3 | 10 | 25 | 25+ |
| Armazenamento | 1 GB | Superior | Personalizado | Personalizado | Personalizado |
| Limite de taxa da API | 60 req/min | Superior | Personalizado | Personalizado | Personalizado |
| SSO e SCIM | — | — | Incluído | Incluído | Incluído |
| Log de transparência privado | — | — | — | Incluído | Opcional |
| Integração HSM | — | — | — | Incluído | Opcional |
| SLA de Suporte | Comunidade | E-mail em 48 horas | 4 horas | 1 hora | Personalizado |

## Complementos

Você pode adicionar complementos ao seu plano para recursos adicionais. Os complementos são cobrados separadamente e se acumulam sobre os direitos do seu plano base.

| Complemento | Chave | Preço base | O que desbloqueia |
| :- | :- | :- | :- |
| Assentos Extras | `addon_seat` | US\$ 25/assento/mês | +1 membro da equipe por unidade além do limite do seu plano. Suporta quantidade — defina o número de assentos extras que você precisa no checkout. |
| SLA de Prioridade | `addon_sla_priority` | \$199/mês | Atualização para SLA de tempo de resposta de 4 horas |
| Log Privado | `addon_private_log` | \$499/mês | Namespace de log de transparência dedicado |
| Pacote de Conformidade | `addon_compliance` | \$299/mês | Relatórios de conformidade SOC 2, GDPR e HIPAA |
| White-Label | `addon_whitelabel` | \$199/mês | Remover a marca Truthlocks das páginas de verificação |
| Aumento do Limite de Taxa | `addon_ratelimit` | US\$ 149/mês | 10x os limites de taxa de API padrão |
| Retenção Estendida | `addon_retention` | US\$ 99/mês | Retenção de log de auditoria de 10 anos (o padrão é 2 anos) |

Gerencie complementos no console em **Configurações > Faturamento > Complementos**. O marketplace de complementos mostra todos os complementos disponíveis com seu preço regional, uma descrição e um botão de anexar com um clique. Complementos que suportam quantidade (como Assentos Extras) permitem que você escolha o número de unidades antes de comprar.

Você também pode verificar seus complementos ativos e direitos resolvidos via API:

```bash theme={null}
curl https://api.truthlocks.com/v1/billing/entitlements \
  -H "X-API-Key: tl_live_..."
```

```json theme={null}
{
  "plan_key": "plan_starter",
  "features": {
    "online_verification": true,
    "offline_bundles": true,
    "custom_metadata": true,
    "sso_scim": false
  },
  "quotas": {
    "attestations.mint": 5000,
    "seats": 4,
    "api_rate_limit": 1200,
    "storage_bytes": 10737418240,
    "webhook_endpoints": 3
  }
}
```

> [!NOTE]
>
> Os preços dos complementos se ajustam automaticamente com base na sua região e provedor de pagamento. Complementos gratuitos (como Assentos Extras em planos Enterprise) são ativados imediatamente sem uma etapa de checkout.

### Preços de complemento regional

Os preços dos complementos são ajustados automaticamente com base no país da sua organização. O sistema de faturamento agrupa os países em níveis de preços e aplica um multiplicador ao preço base.

| Região | Multiplicador | Países |
| :- | :- | :- |
| Nível 1 | 1.0x (preço total) | EUA, GB, DE, FR, CA, AU, NL, CH, JP, SG, IE, IT, ES, SE, NO, DK, FI, NZ |
| LATAM | 0,7x | BR, MX, AR, CO, CL, PE |
| MENA | 0,8x | AE, SA, EG, IL, TR, ZA |
| Sudeste Asiático | 0,6x | ID, TH, VN, PH, MY |
| África | 0.5x | NG, KE, GH, TZ, UG, RW |
| Sul da Ásia | 0,5x | IN, PK, BD, LK |

Por exemplo, o complemento Compliance Pack com um preço base de $299/mês custa $149,50/mês para um inquilino na Nigéria (multiplicador de 0,5x).

Multiplicadores regionais também se aplicam às taxas por uso para emissões e verificações. Um locatário na Índia (0,5x) paga US$ 0,125 por emissão e US$ 0,05 por verificação em vez das taxas padrão de US$ 0,25 e US$ 0,10. Você pode verificar suas taxas efetivas com o [endpoint de taxas](https://docs.truthlocks.com/pt/api-reference/billing/rates.md).

> [!TIP]
>
> Use o seletor de país na página de complementos para visualizar os preços de uma região específica. O seletor não altera seu país de faturamento — ele apenas ajusta os preços exibidos.

## Faturamento de ordem de compra

Locatários empresariais podem pagar via ordem de compra como alternativa a cartão de crédito ou provedores de pagamento regionais.

**1. Enviar um pedido de compra**

Navegue até **Configurações > Faturamento** e selecione a opção de ordem de compra.
Faça o upload do seu documento de pedido de compra (PDF), insira o número do pedido, o valor e a data de expiração
data.

**2. Revisão e ativação**

A equipe de faturamento da Truthlocks revisa seu PO. Uma vez aprovado, sua conta
é ativado e as faturas são emitidas contra o saldo do pedido de compra.

**3. Rastrear status do pedido de compra**

Visualize o status do pedido de compra, o saldo restante e as faturas associadas do
página de configurações de faturamento.

> [!NOTE]
>
> O faturamento por ordem de compra está disponível no plano Enterprise. Entre em contato com seu
> gerente de contas se precisar de pagamento baseado em PO em um plano diferente.

## Exportação contábil

Locatários empresariais podem exportar seu histórico de faturas como CSV ou JSON para contabilidade e reconciliação. As exportações incluem número da fatura, status, datas de emissão e vencimento, valores, impostos, moeda e referências de PO. Se nenhum intervalo de datas for fornecido, a exportação padrão é para os últimos 30 dias.

```bash theme={null}
curl "https://api.truthlocks.com/v1/billing/exports/accounting?format=csv&from=2026-01-01&to=2026-06-30" \
  -H "X-API-Key: tl_live_..."
```

| Parâmetro | Tipo | Descrição |
| :- | :- | :- |
| `format` | string | Formato de exportação: `csv` ou `json`. O padrão é `csv`. |
| `from` | string | Data de início (`YYYY-MM-DD`, por exemplo, `2026-01-01`). O padrão é 30 dias atrás. |
| `to` | string | Data final (`YYYY-MM-DD`, por exemplo, `2026-06-30`). O padrão é hoje. |

A resposta transmite o arquivo diretamente. Para exportações CSV, o `Content-Type` é `text/csv` com um cabeçalho `Content-Disposition` para download.

Você também pode exportar faturas do console em **Configurações > Cobrança > Faturas > Exportar**.

> [!NOTE]
>
> A exportação contábil está disponível no plano Enterprise. A exportação inclui todos os
> faturas dentro do intervalo de datas especificado, incluindo faturas pagas, abertas e anuladas
> faturas.

## Falhas de pagamento e períodos de carência

Se um pagamento falhar, a Truthlocks segue um fluxo de trabalho de acesso gradual para que você tenha tempo de resolver o problema antes de perder o acesso. Você pode verificar seu status de faturamento atual a qualquer momento através do endpoint [`GET /v1/billing/status`](https://docs.truthlocks.com/pt/api-reference/billing/status).

```bash theme={null}
curl https://api.truthlocks.com/v1/billing/status \
  -H "X-API-Key: tl_live_..."
```

```json theme={null}
{
  "status": "ACTIVE",
  "feature_mode": "NORMAL",
  "grace_until": null,
  "banner": null
}
```

O status de faturamento progride por três estágios quando um pagamento falha:

| Estágio | `feature_mode` | Janela de carência padrão | O que acontece |
| :- | :- | :- | :- |
| **Degradado** | `DEGRADED` | 7 dias | Pagamento falhou. Um período de carência começa e um banner aparece no console. Todos os recursos permanecem disponíveis enquanto você atualiza seu método de pagamento. |
| **Restrito** | `RESTRICTED` | 14 dias | O período de carência está acabando. Operações de escrita (cunhagem, criação de chave) estão desabilitadas. Operações de leitura e verificação continuam funcionando. |
| **Suspenso** | `SUSPENDED` | — | Período de carência expirado. Todo o acesso à API está desativado até que o pagamento seja resolvido. |

O campo `grace_until` mostra o carimbo de data/hora ISO 8601 quando o período de carência atual termina. Resolva o pagamento antes desta data para restaurar o acesso total automaticamente. As janelas de carência acima se aplicam ao modo de contrato Padrão — os modos Empresarial e Governamental usam janelas mais longas. Consulte [modos de contrato](#contract-modes) para obter detalhes.

### Modos de contrato

Como o ciclo de vida de cobrança se comporta depende do modo de contrato do locatário. Por padrão, todos os locatários usam o modo Padrão, mas os administradores da plataforma podem mudar um locatário para um modo diferente no console de operações de faturamento.

| Modo | Tentativas | Período de carência | Quando usar |
| :- | :- | :- | :- |
| **Padrão (Automático)** | Retentativas automáticas em T+24h, T+48h, T+72h | 7 dias (Degradado) depois 14 dias (Restrito) antes da suspensão | Inquilinos de autoatendimento pagando com cartão de crédito ou provedor de pagamento regional |
| **Empresarial (Manual)** | Sem novas tentativas automáticas — o administrador de faturamento intervém | 21 dias (Degradado) depois 28 dias (Restrito) — janelas padrão mais 14 dias extras | Contas empresariais pagando por transferência bancária ou ordem de compra |
| **Governo (Sem Retentativa)** | Sem retentativas automáticas | Período de carência fixo de 90 dias; sem suspensão automática | Fluxos de trabalho de aquisição governamental onde os prazos de pagamento estão fora do seu controle |

O modo Padrão envia até três lembretes de pagamento em intervalos de 24, 48 e 72 horas após cada transição de estágio. Os modos Empresarial e Governamental ignoram completamente as novas tentativas automáticas — um administrador de faturamento deve resolver o pagamento manualmente.

> [!NOTE]
>
> As alterações no modo de contrato são registradas em auditoria e exigem um motivo. Entre em contato com o suporte para solicitar uma alteração no modo de contrato.

Ao usar o [endpoint de estimativa](https://docs.truthlocks.com/pt/api-reference/billing/estimate.md), você pode passar `contract_mode` como `ENTERPRISE_CONTRACT` ou `GOVERNMENT_PROCUREMENT` para obter uma recomendação de plano que leva em conta o tipo de contrato. Omitir este campo assume como padrão `STANDARD_SELF_SERVE`.

> [!TIP]
>
> Verifique `feature_mode` em sua integração para exibir avisos de atualização ou pagamento
> aos seus usuários antes que o acesso seja restrito. Uma mensagem `banner` é incluída quando
> ação é necessária. Consulte a [referência da API de status de faturamento](https://docs.truthlocks.com/pt/api-reference/billing/status.md) para detalhes completos da resposta e exemplos de uso.

## Gerenciando faturamento

Todas as configurações de faturamento são gerenciadas no console em **Configurações > Faturamento**. A partir daí, você pode:

* Visualizar seu plano atual e direitos
* Monitorar contadores de uso e consumo de taxa
* Atualizar ou fazer downgrade do seu plano
* Visualizar e baixar faturas
* Exportar faturas para contabilidade (Enterprise)
* Enviar pedidos de compra (para contas empresariais)
* Anexar ou desanexar complementos

## Verificando limites via API

Antes de realizar uma operação faturável, você pode verificar se sua cota atual permite:

```bash theme={null}
curl -X POST https://api.truthlocks.com/v1/billing/limits/check \
  -H "X-API-Key: tl_live_..." \
  -H "Content-Type: application/json" \
  -d '{"metric": "attestations.mint", "amount": 1}'
```

A resposta indica se a operação é permitida em seu plano atual:

```json theme={null}
{
  "allowed": true,
  "used": 158,
  "limit": 500,
  "delta": 1
}
```

### Extensões do período de carência nas verificações de limite

Se seu uso exceder o limite do seu plano, mas um administrador da plataforma concedeu um período de carência para essa métrica, a resposta inclui um objeto `grace` com os detalhes da permissão temporária:

```json theme={null}
{
  "allowed": true,
  "used": 510,
  "limit": 500,
  "grace": {
    "active": true,
    "amount": 100,
    "expires_at": "2026-04-15T12:00:00Z"
  },
  "delta": 1
}
```

## Relacionado

> [card] [Gerenciamento de assinaturas](https://docs.truthlocks.com/guides/subscription-management.md)
>
> Assine, atualize, anexe complementos e cancele via API.

> [card] [Roteamento do provedor](https://docs.truthlocks.com/billing/provider-routing.md)
>
> Como os pagamentos são roteados por região.

> [card] [Listar planos](https://docs.truthlocks.com/api-reference/billing/plans.md)
>
> Obtenha os níveis de plano disponíveis com preços e recursos.

> [card] [Obter taxas](https://docs.truthlocks.com/api-reference/billing/rates.md)
>
> Suas taxas efetivas por uso com ajustes regionais.

> [card] [Estimar custos](https://docs.truthlocks.com/api-reference/billing/estimate.md)
>
> Obtenha uma recomendação de plano com base no uso esperado.

> [card] [API de status de faturamento](https://docs.truthlocks.com/api-reference/billing/status.md)
>
> Verifique a saúde da sua faturação, modo de recurso e status do período de carência.

> [card] [Referência da API de faturamento](https://docs.truthlocks.com/api-reference/billing/config.md)
>
> Configuração, direitos, checkout, assinatura e endpoints de fatura.

> [card] [API de Uso](https://docs.truthlocks.com/api-reference/billing/usage.md)
>
> Verifique seus contadores de uso do ciclo de faturamento atual.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.