---
title: API de compensação da TrimCarbon
description: >-
  Compre compensações de carbono a partir dos seus próprios sistemas, pagas com
  um saldo pré-pago.
sidebar:
  label: Introdução
  order: 0
---
A API de compensação permite que sua empresa compre créditos de carbono a partir dos próprios sistemas. Por exemplo, um job noturno pode compensar o consumo de combustível do dia anterior. Um script pode compensar cada remessa, ou um botão nas suas ferramentas internas pode fazer a compra.

## Como funciona [#how-it-works]

1. **Você solicita acesso à API** na [página Desenvolvedores](https://trimcarbon.com/developers/access). Analisamos cada solicitação. A API é para empresas que compensam as próprias emissões.
2. **Você adiciona saldo pré-pago em USD** pelo Stripe Checkout, a partir de US$ 250. Cada recarga vem com uma fatura.
3. **Você compra compensações** com `POST /offsets`, por volume (`kg`) ou por preço (`amount_cents`). O custo é descontado do seu saldo de acordo com a sua tarifa por kg.
4. **Nós compramos e aposentamos os créditos** por meio do nosso fornecedor, normalmente em poucos minutos. Depois disso, a compensação aparece como `placed`, com um link para o certificado público.

## URL base [#base-url]

```txt
https://trimcarbon.com/api/v1
```

Todas as requisições e respostas usam JSON. Os valores são em centavos de dólar americano, e os volumes são em kg inteiros de CO₂.

## Chaves [#keys]

| Chave | Usa | Aposenta créditos |
| --- | --- | --- |
| `tc_live_…` | Seu saldo real | Sim |
| `tc_test_…` | Um saldo simulado | Não |

Cada chave é de **somente leitura** ou de **leitura e compra**. Consulte [Autenticação](/docs/pt/authentication).

## Próximos passos [#next-steps]

- [Início rápido](/docs/pt/quickstart): sua primeira compra com uma chave de teste.
- [Idempotência](/docs/pt/idempotency): repita requisições com segurança e nunca compre duas vezes.
- [Referência da API](/docs/pt/reference): todos os endpoints, com um playground.
