# Régler un prix

`POST https://api.payiz.app/v1/products/{id}/prices/{price_id}`

Demande une clé secrète qui porte le geste « Catalogue · gérer ».

Son libellé, sa note, sa mise en vente.

Un montant ne se réécrit pas : ce qui a été vendu l’a été à ce prix-là. Retirez ce prix, et ajoutez-en un autre.

## Les en-têtes

| Champ | Type | Requis | Ce que c'est |
| --- | --- | --- | --- |
| `Idempotency-Key` | texte | — | Conseillée : rejouée, la même clé rend la première réponse au lieu de refaire le geste. |

## Ce qu'on envoie

Un corps JSON.

| Champ | Type | Requis | Ce que c'est |
| --- | --- | --- | --- |
| `label` | texte | — | Le nouveau libellé. |
| `note` | texte ou null | — | La nouvelle note ; null l’efface. |
| `active` | vrai ou faux | — | Le remettre en vente, ou l’en retirer. |

## Ce qu'on reçoit

`200` · un objet `price`

| Champ | Type | Requis | Ce que c'est |
| --- | --- | --- | --- |
| `object` | « price » | — | Le genre de l’objet rendu : il ne change jamais. |
| `id` | texte | — | Un identifiant préfixé « prx_ », par exemple prx_01j9xm3kq8v2tzr5wd7n. |
| `product` | texte | — | Le produit qu’il met en vente. |
| `label` | texte | — | Ce que le client lit : « Mensuel », « À l’unité ». |
| `amount` | entier | — | Le prix : d’une fois, d’une période, ou d’une unité à l’usage. |
| `currency` | texte | — | Le code ISO 4217, en majuscules. |
| `period` | « one_time » · « month » · « quarter » · « year » · « usage » | — | Ce que le prix paie : une fois (« one_time »), une période (« month », « quarter », « year »), ou une unité consommée (« usage »). |
| `unit` | texte ou null | — | À l’usage, ce qui se compte : « heure », « Go », « appel ». Null sinon. |
| `note` | texte ou null | — | Une précision, pour vous ou pour le client. |
| `active` | vrai ou faux | — | Faux : retiré de la vente, sans être retiré du produit. |
| `archived_at` | entier ou null | — | Quand il a été retiré du produit ; ce qui a été vendu à ce prix le désigne toujours. |
| `created` | entier ou null | — | Des secondes depuis 1970, ou null. |
| `livemode` | vrai ou faux | — | Faux en mode test : aucun argent ne circule. |

## La demande

```bash
curl https://api.payiz.app/v1/products/prd_01j9xm2hp7t4wzq6vc3k/prices/prx_01j9xm3kq8v2tzr5wd7n \
  -H "Authorization: Bearer sk_test_…" \
  -H "Idempotency-Key: catalogue-regler-01" \
  -H "Content-Type: application/json" \
  -d '{
    "active": false
  }'
```

## La réponse

```json
{
  "object": "price",
  "id": "prx_01j9xm3kq8v2tzr5wd7n",
  "product": "prd_01j9xm2hp7t4wzq6vc3k",
  "label": "À l’unité",
  "amount": 10000,
  "currency": "XOF",
  "period": "one_time",
  "unit": null,
  "note": null,
  "active": true,
  "archived_at": null,
  "created": 1789740092,
  "livemode": false
}
```