# Modifier un produit

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

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

Son nom, sa description, sa mise en vente.

Ce qui n’est pas envoyé ne change pas. Son type ne change jamais, et un produit archivé ne se modifie plus.

## 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 |
| --- | --- | --- | --- |
| `name` | texte | — | Le nouveau nom. |
| `description` | texte ou null | — | La nouvelle description ; null l’efface. |
| `active` | vrai ou faux | — | Le remettre en vente, ou l’en retirer. |

## Ce qu'on reçoit

`200` · un objet `product`

| Champ | Type | Requis | Ce que c'est |
| --- | --- | --- | --- |
| `object` | « product » | — | Le genre de l’objet rendu : il ne change jamais. |
| `id` | texte | — | Un identifiant préfixé « prd_ », par exemple prd_01j9xm2hp7t4wzq6vc3k. |
| `name` | texte | — | Le nom du produit, tel que le client le lit. |
| `description` | texte ou null | — | Ce que vous en dites. |
| `type` | « one_time » · « open » · « subscription » · « usage » | — | Comment il se paie : « one_time » une fois, « open » au prix que le payeur choisit, « subscription » par période, « usage » selon ce qui est consommé. Il ne change plus : ses prix et ses ventes en dépendent. |
| `active` | vrai ou faux | — | En vente, ou retiré de la vente. |
| `archived_at` | entier ou null | — | Quand il a été archivé ; null tant qu’il ne l’est pas. |
| `prices` | liste de objet | — | Ses prix, du plus ancien au plus récent. Un produit « open » n’en a aucun. |
| `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 \
  -H "Authorization: Bearer sk_test_…" \
  -H "Idempotency-Key: catalogue-modifier-01" \
  -H "Content-Type: application/json" \
  -d '{
    "description": "Coton imprimé, bleu indigo. Six yards."
  }'
```

## La réponse

```json
{
  "object": "product",
  "id": "prd_01j9xm2hp7t4wzq6vc3k",
  "name": "Pagne wax 6 yards",
  "description": "Coton imprimé, bleu indigo.",
  "type": "one_time",
  "active": true,
  "archived_at": null,
  "prices": [
    {
      "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
    }
  ],
  "created": 1789740092,
  "livemode": false
}
```