# Ajouter un prix

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

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

Un prix par période proposée et par monnaie.

La période suit le type du produit. Un produit « open » n’a pas de prix : c’est le payeur qui décide.

## 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 | oui | Ce que le client lit : « Mensuel », « À l’unité ». |
| `amount` | entier | oui | Le prix. |
| `currency` | texte | — | Sans précision : la monnaie de l’espace. |
| `period` | « one_time » · « month » · « quarter » · « year » · « usage » | oui | Celle que le type du produit accepte : « one_time » pour « one_time », « month », « quarter » ou « year » pour « subscription », « usage » pour « usage ». |
| `unit` | texte | — | Requis à l’usage : ce qui se compte, « heure », « Go », « appel ». |
| `note` | texte | — | Une précision, pour vous ou pour le client. |
| `active` | vrai ou faux | — | En vente d’office. |

## Ce qu'on reçoit

`201` · 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 \
  -H "Authorization: Bearer sk_test_…" \
  -H "Idempotency-Key: catalogue-prix-01" \
  -H "Content-Type: application/json" \
  -d '{
    "label": "À l’unité",
    "amount": 10000,
    "currency": "XOF",
    "period": "one_time"
  }'
```

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