# Facturation

> Ce que vous payez, et quand : 0,005 € par enrichissement réussi hors taxes, ce qui n'est jamais facturé, et comment lire l'usage d'un appel sans le compter deux fois.

**0,005 € par enrichissement réussi, hors taxes applicables.** Aucun minimum mensuel, aucuns frais d'abonnement, aucun forfait inclus : vous payez ce qui a résolu, et rien d'autre. Le Sandbox est gratuit et ne facture jamais rien.

## Ce qui est facturable

Un enrichissement est facturable quand il a **résolu**.

| Résultat | Facturable |
|---|---|
| `resolved` | oui, 1 unité |
| `refresh_recalculated` | oui, 1 unité |
| `partial` | non |
| `not_found` | non |
| Rejeu d'un appel déjà réglé (même `Idempotency-Key`, ou même `external_transaction_id`) | non |
| `engine_error`, `rate_limited`, tout `4xx` | non |
| Une lecture `GET` | non, jamais |

## Lire l'usage d'un appel

Chaque réponse `POST` réussie porte un objet `usage` qui dit ce que l'appel a coûté :

```json
"usage": { "billable": true, "units": 1, "deduplicated": false, "deduplicated_by": null }
```

| Champ | Signification |
|---|---|
| `billable` | L'appel est facturé. Toujours `false` en Sandbox. |
| `units` | Les unités portées par l'appel : 1 pour `resolved` et `refresh_recalculated`, 0 sinon. |
| `deduplicated` | `true` quand la réponse vient de la déduplication économique (même `external_transaction_id`, même entrée). |
| `deduplicated_by` | `external_transaction_id` quand `deduplicated` vaut `true`, `null` sinon. |

Un rejeu par `external_transaction_id` se reconnaît dans le corps : `deduplicated: true`, `billable: false`, `units: 0`.

> **Attention** Un rejeu par `Idempotency-Key` rend le corps **mémorisé** de la première réponse, `usage` compris. Si la première réponse était facturée, le rejeu affiche encore `billable: true`, alors que rien de nouveau n'a été facturé. Ce cas se reconnaît à l'en-tête `Noryo-Idempotency-Replayed: true` : si vous tenez votre propre compte de consommation, ignorez `usage` sur ces réponses.

Une lecture `GET` ne porte pas d'objet `usage` mais deux objets distincts : `retrieval` (ce que coûte cette lecture, toujours `billable: false` et `units: 0`) et `original` (ce qu'a coûté l'enrichissement quand il a eu lieu). Voir [Relire un enrichissement](https://developer.noryo.app/fr-FR/merchant/enrichments/read).

## Passer en Production

La Production n'est pas en libre-service. Vous déposez un dossier, une personne chez Noryo l'examine, et la décision lui appartient. Avant cette revue, vous devez avoir enregistré un moyen de paiement : Noryo n'ouvre pas une Production qu'il ne pourrait pas encaisser.

Une fois approuvé, l'usage est compté au fil de vos appels, chaque mois civil est clôturé automatiquement, et la facture est prélevée sur le moyen de paiement enregistré. Platform ne crée pas de clé de Production : elle n'émet que des clés Sandbox. Voir [Passage en production](https://developer.noryo.app/fr-FR/merchant/going-live).

## Une petite facture peut apparaître réglée sans prélèvement

Les très petits montants ne sont pas prélevés immédiatement : notre prestataire de paiement les reporte et les encaisse avec la première facture qui dépasse son propre minimum. Une facture peut donc apparaître réglée un mois où rien n'a quitté votre compte. Le total finalement prélevé est exactement la somme de vos consommations, jamais davantage.

## Suivre sa consommation

La page [Usage](https://platform.noryo.app/usage) de Platform montre, pour les trente derniers jours, le nombre d'appels réglés et les unités par jour, ventilés par statut. Voir [Observabilité](https://developer.noryo.app/fr-FR/merchant/operations/observability).

---

Page canonique : https://developer.noryo.app/fr-FR/merchant/billing