> ## 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.

# Système de facturation

> Tarification à l'usage, niveaux de plan et gestion de l'utilisation pour votre organisation Truthlocks.

Truthlocks utilise un modèle de facturation à l'usage où vous ne payez que ce que vous consommez. Chaque organisation (locataire) a son propre abonnement, ses compteurs d'utilisation et son cycle de facturation. Les fonctionnalités et les quotas sont appliqués en fonction de votre plan actif.

## Niveaux de plan

* **Centré sur le locataire** : Chaque locataire (Organisation) a son propre abonnement et cycle de facturation.
* **Droits** : Les fonctionnalités et les quotas sont appliqués en fonction de la clé de plan active (`plan_developer`, `plan_starter`, `plan_business`, `plan_institutional`, `plan_enterprise`).
* **Multi-fournisseurs**: Nous acheminons les paiements via différentes passerelles (Stripe, Paystack, Flutterwave) en fonction de la juridiction légale du locataire.
* **Tarification régionale**: Le paiement utilise automatiquement le pays de votre compte pour appliquer les tarifs régionaux et la devise corrects. Voir [routage des fournisseurs](https://docs.truthlocks.com/fr/billing/provider-routing.md) pour plus de détails.

## Niveaux de plan

> [card] Développeur
>
> Pour les amateurs et les projets de preuve de concept. Inclut la vérification en ligne et le support communautaire sans frais.

> [card] Débutant
>
> Pour les PME et les startups avec des charges de travail de production. Quotas plus élevés, jusqu'à 3 points de terminaison de webhook et traitement prioritaire.

> [card] Entreprise
>
> Pour les équipes de taille moyenne ayant des besoins de conformité. SAML SSO, provisionnement SCIM, RBAC complet et journaux d'audit, jusqu'à 10 points de terminaison de webhook et un SLA de support de 4 heures.

> [card] Institutionnel
>
> Pour les grandes entreprises ayant des besoins de sécurité avancés. Journal de transparence privé, intégration HSM et un SLA de support d'une heure.

> [card] Entreprise
>
> Tarification personnalisée pour les gouvernements et les entreprises du Fortune 500. SLA personnalisé, options de déploiement sur site, support 24/7 et intégration sur mesure.

## Concepts fondamentaux

* **Droits** — chaque plan débloque des fonctionnalités et des quotas spécifiques (limites de frappe, nombres de vérifications, sièges, stockage, limites de débit API). Le service de facturation applique ces limites au niveau de l'API.
* **Compteurs d'utilisation** — les compteurs disponibles sont signalés pour le cycle de facturation sélectionné. Vous pouvez surveiller votre consommation depuis le tableau de bord d'utilisation de la console ou l'[API d'utilisation](https://docs.truthlocks.com/fr/api-reference/billing/usage.md).
* **Routage multi-fournisseurs** — les paiements sont traités via la passerelle optimale pour votre région. Voir [routage des fournisseurs](https://docs.truthlocks.com/fr/billing/provider-routing.md) pour plus de détails.

## Produits mesurés

Truthlocks mesure 16 produits organisés en quatre catégories. Vous pouvez tous les consulter sur la [page de tarification](https://www.truthlocks.com/pricing) et suivre votre consommation dans la console sous **Paramètres > Facturation > Utilisation**.

### Cœur

| Produit | Description | Taux par défaut |
| :- | :- | :- |
| Frappes d'attestation | Attestations créées via l'API ou le SDK | 0,25 \$ par frappe |
| Vérifications | Demandes de vérification d'attestation | 0,10 \$ par vérification |
| Stockage | Stockage total de fichiers et de preuves consommé | Inclus par plan |
| Lots de preuves | Lots de preuves cryptographiques générés | Inclus par plan |
| Points de terminaison de webhook | Enregistrements de points de terminaison de webhook actifs | Inclus par plan |
| Livraisons de webhook | Tentatives de livraison de webhook individuelles | Inclus par plan |
| Sièges | Sièges de membres d'équipe dans votre organisation | Inclus par plan |

### MAIP (Identité Machine)

| Produit | Description | Taux par défaut |
| :- | :- | :- |
| Agents | Agents machine enregistrés | Par niveau de plan |
| Sessions | Sessions d'agent créées par mois | Par niveau de plan |
| Calcul des scores de confiance | Calculs de scores de confiance à la demande | Par niveau de plan |
| Vérifications de conformité | Demandes de vérification de conformité | Par niveau de plan |

### IA

| Produit | Description | Taux par défaut |
| :- | :- | :- |
| Attestations de jeu de données | Jeux de données attestés pour le suivi de la lignée | Par niveau de plan |
| Attestations de modèle | Modèles ML attestés pour la provenance | Par niveau de plan |

### Anti-fraude

| Produit | Description | Taux par défaut |
| :- | :- | :- |
| Signaux de risque | Signaux de fraude ingérés ou générés | Par niveau de plan |
| Scans Deepfake | Demandes de scan Deepfake et d'usurpation d'identité | Par niveau de plan |
| Enregistrements de vélocité | Enregistrements d'action de score de vélocité | Par niveau de plan |

> [!NOTE]
>
> Utilisez la [page de tarification](https://www.truthlocks.com/pricing) pour les prix publiés. L'API de facture projetée tarifie actuellement les mints et les vérifications ; les autres produits nécessitent leur accord de tarification applicable.

## Grilles tarifaires

Les tarifs à l'utilisation pour les frappes et les vérifications sont :

| Opération | Taux |
| :- | :- |
| Frappe d'attestation | 0,25 \$ par frappe |
| Vérification | 0,10 \$ par vérification |

Les tarifs sont visibles dans la console sous **Paramètres > Facturation > Utilisation**.

> [!NOTE]
>
> Les tarifs ont été réduits de 50 % lors de la publication de mars 2026. Les tarifs précédents étaient de 0,50 $par frappe et de 0,20$ par vérification.

### Tarifs personnalisés pour les partenaires

Les administrateurs de plateforme peuvent créer des grilles tarifaires personnalisées avec une tarification par opération pour les locataires partenaires. Utilisez ceci pour offrir des prix négociés à des partenaires stratégiques ou à des clients à volume sans modifier vos tarifs de plan standard.

Chaque grille tarifaire définit les prix unitaires pour les créations et les vérifications, et peut être attribuée à un ou plusieurs locataires avec une date d'effet.

Les tarifs négociés s'appliquent à chaque opération de production facturable tant que l'accord est en vigueur. Un plafond de ressources n'est pas une allocation gratuite. Les allocations gratuites pour les développeurs, les abonnements consommateurs, l'activité de bac à sable et les pilotes approuvés sans frais sont distincts des prix commerciaux négociés.

Les tranches de volume sont graduées : si les 100 premières opérations coûtent 0,25 $chacune et les opérations suivantes 0,20$, 101 opérations coûtent 25,20 \$. Une tranche ultérieure ne modifie pas le prix des opérations antérieures. Les tranches doivent couvrir la quantité totale sans lacunes ni chevauchements.

Un tarif de partenariat réduit n'est pas un pilote gratuit. Un pilote approuvé a une date d'expiration et des plafonds d'utilisation, sans conversion payante automatique.

> [!NOTE]
>
> L'utilisation acceptée est désormais enregistrée dans un registre immuable, séparé par environnement, avec son taux, son pays et son instantané de plan. Les prix sont fixés lors de l'acceptation par le service de facturation, et non fournis par l'horodatage de remplissage d'un appelant. Les nouveaux prix ne reprixent pas les enregistrements acceptés. Les anciens compteurs agrégés ne sont pas refacturés.
>
> Les mois UTC clos produisent automatiquement des brouillons de facture. Un brouillon n'est pas payable : son émission nécessite une MFA du personnel, un contrat de facture actif dans la devise correspondante, un pays de facturation vérifié, la confirmation de l'accord du client et un examen fiscal explicite. Ce flux de travail ne débite pas les méthodes de paiement enregistrées et n'envoie pas d'e-mail. Les fonds vérifiés reçus sont enregistrés séparément, avec des vérifications de référence en double et de solde impayé.
>
> Les plans gratuits, les plans grand public, l'activité de bac à sable et les pilotes approuvés sans frais sont exclus de l'utilisation commerciale tarifée. L'absence d'environnement ou de preuve de tarification pour les opérations de base met le mois concerné en revue. Le règlement automatique prend actuellement en charge le catalogue de tarifs libellés en USD, y compris ses remises régionales ; les autres devises sont mises en revue.

### Projections d'utilisation

La page d'utilisation de la console affiche la consommation enregistrée et votre grille tarifaire actuelle. L'API de facture projetée authentifiée estime les coûts de frappe et de vérification en utilisant la grille tarifaire standard ; elle ne résout pas les tarifs négociés privés, les taxes, les allocations gratuites ou une facture émise.

Naviguez vers **Paramètres > Facturation > Utilisation** pour inspecter l'utilisation et les tarifs. Lisez les factures émises séparément.

## Quotas d'autorisation

Votre plan détermine les quotas suivants :

| Quota | Développeur | Starter | Business | Institutionnel | Entreprise |
| :- | :- | :- | :- | :- | :- |
| Frappes d'attestation | 500/mois | Plus élevé | Personnalisé | Personnalisé | Personnalisé |
| Vérifications mensuelles | Dépend du plan | Dépend du plan | Dépend du plan | Dépend du plan | Dépend du plan |
| Émetteurs | 1 | Multiple | Personnalisé | Personnalisé | Dépend du plan |
| Sièges | 1 | Plusieurs | Personnalisé | Personnalisé | Personnalisé |
| Clés de signature | 1 | Plusieurs | Personnalisé | Personnalisé | Dépend du plan |
| Points de terminaison de webhook | 1 | 3 | 10 | 25 | 25+ |
| Stockage | 1 Go | Supérieur | Personnalisé | Personnalisé | Personnalisé |
| Limite de débit API | 60 req/min | Plus élevé | Personnalisé | Personnalisé | Personnalisé |
| SSO & SCIM | — | — | Inclus | Inclus | Inclus |
| Journal de transparence privé | — | — | — | Inclus | Facultatif |
| Intégration HSM | — | — | — | Inclus | Facultatif |
| SLA de support | Communauté | E-mail sous 48h | 4h | 1h | Personnalisé |

## Modules complémentaires

Vous pouvez ajouter des modules complémentaires à votre plan pour des fonctionnalités supplémentaires. Les modules complémentaires sont facturés séparément et s'ajoutent aux droits de votre plan de base.

| Add-on | Clé | Prix de base | Ce qu'il débloque |
| :- | :- | :- | :- |
| Sièges supplémentaires | `addon_seat` | 25 \$/siège/mois | +1 membre d'équipe par unité au-delà de la limite de votre plan. Prend en charge la quantité — définissez le nombre de sièges supplémentaires dont vous avez besoin au moment du paiement. |
| SLA prioritaire | `addon_sla_priority` | 199 \$/mois | Mise à niveau vers un SLA avec temps de réponse de 4 heures |
| Journal privé | `addon_private_log` | 499 \$/mois | Espace de noms de journal de transparence dédié |
| Pack de conformité | `addon_compliance` | 299 \$/mois | Rapports de conformité SOC 2, GDPR et HIPAA |
| Marque blanche | `addon_whitelabel` | 199 \$/mois | Supprimer la marque Truthlocks des pages de vérification |
| Boost de limite de débit | `addon_ratelimit` | 149 \$/mois | 10x les limites de débit API par défaut |
| Rétention étendue | `addon_retention` | 99 \$/mois | Rétention du journal d'audit de 10 ans (par défaut 2 ans) |

Gérez les modules complémentaires dans la console sous **Paramètres > Facturation > Modules complémentaires**. Le marché des modules complémentaires affiche tous les modules complémentaires disponibles avec votre prix régional, une description et un bouton d'attache en un clic. Les modules complémentaires qui prennent en charge la quantité (comme les sièges supplémentaires) vous permettent de choisir le nombre d'unités avant d'acheter.

Vous pouvez également vérifier vos modules complémentaires actifs et vos droits résolus via l'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]
>
> La tarification des modules complémentaires s'ajuste automatiquement en fonction de votre région et de votre fournisseur de paiement. Les modules complémentaires gratuits (comme les sièges supplémentaires sur les plans Entreprise) s'activent immédiatement sans étape de paiement.

### Tarification régionale des modules complémentaires

Les prix des modules complémentaires sont ajustés automatiquement en fonction du pays de votre organisation. Le système de facturation regroupe les pays en niveaux de prix et applique un multiplicateur au prix de base.

| Région | Multiplicateur | Pays |
| :- | :- | :- |
| Niveau 1 | 1.0x (prix plein) | US, 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 |
| Asie du Sud-Est | 0.6x | ID, TH, VN, PH, MY |
| Afrique | 0.5x | NG, KE, GH, TZ, UG, RW |
| Asie du Sud | 0.5x | IN, PK, BD, LK |

Par exemple, le module complémentaire Compliance Pack, au prix de base de 299 $/mois, coûte 149,50 $/mois pour un locataire au Nigeria (multiplicateur de 0,5x).

Des multiplicateurs régionaux s'appliquent également aux tarifs à l'utilisation pour les créations et les vérifications. Un locataire en Inde (0,5x) paie 0,125 $par création et 0,05$ par vérification au lieu des tarifs standard de 0,25 $et 0,10$. Vous pouvez vérifier vos tarifs effectifs avec le [point de terminaison des tarifs](https://docs.truthlocks.com/fr/api-reference/billing/rates.md).

> [!TIP]
>
> Utilisez le sélecteur de pays sur la page des modules complémentaires pour prévisualiser les prix pour une région spécifique. Le sélecteur ne modifie pas votre pays de facturation — il ajuste uniquement les prix affichés.

## Facturation par bon de commande

Les locataires d'entreprise peuvent payer par bon de commande comme alternative à la carte de crédit ou aux fournisseurs de paiement régionaux.

**1. Soumettre un bon de commande**

Naviguez vers **Paramètres > Facturation** et sélectionnez l'option bon de commande.
Téléchargez votre document de commande (PDF), saisissez le numéro de commande, le montant et la date d'expiration
date.

**2. Examen et activation**

L'équipe de facturation de Truthlocks examine votre bon de commande. Une fois approuvé, votre compte
est activé et les factures sont émises par rapport au solde du bon de commande.

**3. Suivre le statut du bon de commande**

Affichez le statut de la commande, le solde restant et les factures associées depuis le
page des paramètres de facturation.

> [!NOTE]
>
> La facturation par bon de commande est disponible avec le plan Entreprise. Contactez votre
> gestionnaire de compte si vous avez besoin d'un paiement basé sur un bon de commande pour un plan différent.

## Exportation comptable

Les locataires d'entreprise peuvent exporter l'historique de leurs factures au format CSV ou JSON pour la comptabilité et la réconciliation. Les exportations incluent le numéro de facture, le statut, les dates d'émission et d'échéance, les montants, les taxes, la devise et les références de commande. Si aucune plage de dates n'est fournie, l'exportation par défaut est les 30 derniers jours.

```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_..."
```

| Paramètre | Type | Description |
| :- | :- | :- |
| `format` | string | Format d'exportation : `csv` ou `json`. Par défaut `csv`. |
| `from` | chaîne | Date de début (`YYYY-MM-DD`, par exemple `2026-01-01`). Par défaut, il y a 30 jours. |
| `to` | string | Date de fin (`YYYY-MM-DD`, par exemple `2026-06-30`). Par défaut, aujourd'hui. |

La réponse diffuse le fichier directement. Pour les exportations CSV, le `Content-Type` est `text/csv` avec un en-tête `Content-Disposition` pour le téléchargement.

Vous pouvez également exporter les factures depuis la console dans **Paramètres > Facturation > Factures > Exporter**.

> [!NOTE]
>
> L'exportation comptable est disponible avec le plan Entreprise. L'exportation comprend tous les
> factures dans la plage de dates spécifiée, y compris les factures payées, ouvertes et annulées
> factures.

## Échecs de paiement et périodes de grâce

Si un paiement échoue, Truthlocks suit un flux de travail d'accès progressif afin que vous ayez le temps de résoudre le problème avant de perdre l'accès. Vous pouvez vérifier votre statut de facturation actuel à tout moment via le point de terminaison [`GET /v1/billing/status`](https://docs.truthlocks.com/fr/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
}
```

Le statut de facturation passe par trois étapes lorsqu'un paiement échoue :

| Étape | `feature_mode` | Fenêtre de grâce par défaut | Ce qui se passe |
| :- | :- | :- | :- |
| **Dégradé** | `DEGRADED` | 7 jours | Le paiement a échoué. Une période de grâce commence et une bannière apparaît dans la console. Toutes les fonctionnalités restent disponibles pendant que vous mettez à jour votre méthode de paiement. |
| **Restreint** | `RESTRICTED` | 14 jours | La période de grâce touche à sa fin. Les opérations d'écriture (création d'attestations, création de clés) sont désactivées. Les opérations de lecture et la vérification continuent de fonctionner. |
| **Suspendu** | `SUSPENDED` | — | Période de grâce expirée. Tout accès API est désactivé jusqu'à ce que le paiement soit réglé. |

Le champ `grace_until` affiche l'horodatage ISO 8601 de fin de la période de grâce actuelle. Réglez le paiement avant cette date pour restaurer automatiquement l'accès complet. Les fenêtres de grâce ci-dessus s'appliquent au mode de contrat Standard — les modes Entreprise et Gouvernement utilisent des fenêtres plus longues. Voir [modes de contrat](#contract-modes) pour plus de détails.

### Modes de contrat

Le comportement du cycle de relance dépend du mode de contrat du locataire. Par défaut, tous les locataires utilisent le mode Standard, mais les administrateurs de plateforme peuvent basculer un locataire vers un mode différent depuis la console des opérations de facturation.

| Mode | Nouvelles tentatives | Période de grâce | Quand utiliser |
| :- | :- | :- | :- |
| **Standard (Auto)** | Retries automatiques à T+24h, T+48h, T+72h | 7 jours (Dégradé) puis 14 jours (Restreint) avant suspension | Locataires en libre-service payant par carte de crédit ou fournisseur de paiement régional |
| **Entreprise (Manuel)** | Pas de tentatives automatiques — l'administrateur de la facturation intervient | 21 jours (Dégradé) puis 28 jours (Restreint) — fenêtres standard plus 14 jours supplémentaires | Comptes d'entreprise payant par virement bancaire ou bon de commande |
| **Gouvernement (Pas de nouvelle tentative)** | Pas de tentatives automatiques | Période de grâce fixe de 90 jours ; pas de suspension automatique | Flux de travail d'approvisionnement gouvernemental où les délais de paiement sont hors de votre contrôle |

Le mode Standard envoie jusqu'à trois rappels de paiement à des intervalles de 24, 48 et 72 heures après chaque transition d'étape. Les modes Entreprise et Gouvernement ignorent entièrement les tentatives automatiques — un administrateur de facturation doit résoudre le paiement manuellement.

> [!NOTE]
>
> Les modifications du mode de contrat sont enregistrées dans l'audit et nécessitent une raison. Contactez le support pour demander un changement de mode de contrat.

Lorsque vous utilisez le [point de terminaison d'estimation](https://docs.truthlocks.com/fr/api-reference/billing/estimate.md), vous pouvez passer `contract_mode` comme `ENTERPRISE_CONTRACT` ou `GOVERNMENT_PROCUREMENT` pour obtenir une recommandation de plan qui tient compte du type de contrat. L'omission de ce champ utilise par défaut `STANDARD_SELF_SERVE`.

> [!TIP]
>
> Vérifiez `feature_mode` dans votre intégration pour afficher les invites de mise à niveau ou de paiement
> à vos utilisateurs avant que l'accès ne soit restreint. Un message `banner` est inclus lorsque
> action est nécessaire. Voir la [référence de l'API de statut de facturation](https://docs.truthlocks.com/fr/api-reference/billing/status.md) pour les détails complets de la réponse et des exemples d'utilisation.

## Gestion de la facturation

Tous les paramètres de facturation sont gérés dans la console sous **Paramètres > Facturation**. De là, vous pouvez :

* Afficher votre plan actuel et vos droits
* Surveiller les compteurs d'utilisation et la consommation de débit
* Mettre à niveau ou rétrograder votre plan
* Afficher et télécharger les factures
* Exporter les factures pour la comptabilité (Entreprise)
* Soumettre des bons de commande (pour les comptes d'entreprise)
* Attacher ou détacher des modules complémentaires

## Vérification des limites via l'API

Avant d'effectuer une opération facturable, vous pouvez vérifier si votre quota actuel le permet :

```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}'
```

La réponse indique si l'opération est autorisée dans le cadre de votre plan actuel :

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

### Extensions de période de grâce dans les vérifications de limites

Si votre utilisation dépasse la limite de votre plan mais qu'un administrateur de la plateforme a accordé une période de grâce pour cette métrique, la réponse inclut un objet `grace` avec les détails de l'allocation temporaire :

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

## Lié

> [card] [Gestion des abonnements](https://docs.truthlocks.com/guides/subscription-management.md)
>
> Abonnez-vous, mettez à niveau, ajoutez des modules complémentaires et annulez via l'API.

> [card] [Routage du fournisseur](https://docs.truthlocks.com/billing/provider-routing.md)
>
> Comment les paiements sont acheminés par région.

> [card] [Lister les plans](https://docs.truthlocks.com/api-reference/billing/plans.md)
>
> Récupérer les niveaux de plan disponibles avec les prix et les fonctionnalités.

> [card] [Obtenir les tarifs](https://docs.truthlocks.com/api-reference/billing/rates.md)
>
> Vos tarifs effectifs par utilisation avec ajustements régionaux.

> [card] [Estimer les coûts](https://docs.truthlocks.com/api-reference/billing/estimate.md)
>
> Obtenez une recommandation de plan basée sur l'utilisation prévue.

> [card] [API de statut de facturation](https://docs.truthlocks.com/api-reference/billing/status.md)
>
> Vérifiez l'état de votre facturation, le mode de vos fonctionnalités et la période de grâce.

> [card] [Référence de l'API de facturation](https://docs.truthlocks.com/api-reference/billing/config.md)
>
> Configuration, droits, paiement, abonnement et points de terminaison de facture.

> [card] [API d'utilisation](https://docs.truthlocks.com/api-reference/billing/usage.md)
>
> Vérifiez vos compteurs d'utilisation du cycle de facturation actuel.


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