---
title: API de compensation TrimCarbon
description: >-
  Achetez des compensations carbone depuis vos propres systèmes, payées à partir
  d’un solde prépayé.
sidebar:
  label: Introduction
  order: 0
---
L’API de compensation permet à votre entreprise d’acheter des crédits carbone depuis ses propres systèmes : une tâche nocturne qui compense la consommation de carburant de la veille, un script qui compense chaque expédition, ou un bouton dans vos outils internes.

## Fonctionnement [#how-it-works]

1. **Vous demandez un accès à l’API** sur la [page Développeurs](https://trimcarbon.com/developers/access). Nous examinons chaque demande ; l’API s’adresse aux entreprises qui compensent leurs propres émissions.
2. **Vous approvisionnez un solde prépayé en USD** via Stripe Checkout, à partir de 250 $. Chaque approvisionnement est accompagné d’une facture.
3. **Vous achetez des compensations** avec `POST /offsets`, par volume (`kg`) ou par montant (`amount_cents`). Le coût est prélevé sur votre solde, à votre tarif par kg.
4. **Nous achetons et retirons les crédits** auprès de notre fournisseur, généralement en quelques minutes. La compensation affiche alors le statut `placed` et un lien vers son certificat public.

## URL de base [#base-url]

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

Toutes les requêtes et les réponses sont au format JSON. Les montants sont exprimés en cents américains, les volumes en kg entiers de CO₂.

## Clés [#keys]

| Clé | Débite | Retire des crédits |
| --- | --- | --- |
| `tc_live_…` | Votre solde réel | Oui |
| `tc_test_…` | Un solde simulé | Non |

Une clé est soit en **Lecture seule**, soit en **Lecture et achat**. Consultez la page [Authentification](/docs/fr/authentication).

## Étapes suivantes [#next-steps]

- [Démarrage rapide](/docs/fr/quickstart) : votre premier achat avec une clé de test.
- [Idempotence](/docs/fr/idempotency) : réessayez en toute sécurité, sans jamais acheter deux fois.
- [Référence de l’API](/docs/fr/reference) : tous les points de terminaison, avec un espace d’essai interactif.