---
title: API di compensazione TrimCarbon
description: >-
  Acquisti compensazioni di carbonio dai suoi sistemi e le paghi con un saldo
  prepagato.
sidebar:
  label: Introduzione
  order: 0
---
L’API di compensazione permette alla sua azienda di acquistare crediti di carbonio dai propri sistemi. Può usarla con un job notturno che compensa il carburante consumato il giorno prima, con uno script che compensa ogni spedizione o con un pulsante nei suoi strumenti interni.

## Come funziona [#how-it-works]

1. **Lei richiede l’accesso all’API** nella [pagina Sviluppatori](https://trimcarbon.com/developers/access). Esaminiamo ogni richiesta. L’API è destinata alle aziende che compensano le proprie emissioni.
2. **Lei ricarica un saldo prepagato in USD** tramite Stripe Checkout, a partire da 250 USD. Ogni ricarica include una fattura.
3. **Lei acquista compensazioni** con `POST /offsets`, per volume (`kg`) o per prezzo (`amount_cents`). Il costo viene detratto dal suo saldo in base alla sua tariffa per kg.
4. **Noi acquistiamo e ritiriamo i crediti** tramite il nostro fornitore, di solito in pochi minuti. A quel punto la compensazione risulta `placed`, con un link al relativo certificato pubblico.

## URL di base [#base-url]

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

Tutte le richieste e le risposte sono in JSON. Gli importi sono espressi in centesimi di dollaro USA e i volumi in kg interi di CO₂.

## Chiavi [#keys]

| Chiave | Spende | Ritira crediti |
| --- | --- | --- |
| `tc_live_…` | Il suo saldo reale | Sì |
| `tc_test_…` | Un saldo simulato | No |

Una chiave può essere di **sola lettura** o di **lettura e acquisto**. Consulti [Autenticazione](/docs/it/authentication).

## Passaggi successivi [#next-steps]

- [Guida rapida](/docs/it/quickstart): il suo primo acquisto con una chiave di test.
- [Idempotenza](/docs/it/idempotency): ripeta le richieste in sicurezza, senza mai acquistare due volte.
- [Riferimento API](/docs/it/reference): tutti gli endpoint, con un playground.