# Modifier un client

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

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

Ce qui n’est pas envoyé ne change pas ; ce qui vaut null s’efface.

Un client garde un numéro ou une adresse. Le numéro qu’il garde ne se relit pas en clair pour autant. Un client 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. |
| `email` | texte ou null | — | La nouvelle adresse ; null l’efface. |
| `phone` | texte ou null | — | Le nouveau numéro ; null l’efface. Sans lui, le numéro gardé ne bouge pas. |
| `country` | texte | — | Le pays du nouveau numéro, quand il est écrit sans indicatif. |
| `note` | texte ou null | — | La nouvelle note ; null l’efface. |

## Ce qu'on reçoit

`200` · un objet `customer`

| Champ | Type | Requis | Ce que c'est |
| --- | --- | --- | --- |
| `object` | « customer » | — | Le genre de l’objet rendu : il ne change jamais. |
| `id` | texte | — | Un identifiant préfixé « cli_ », par exemple cli_01j9xn4rt6m8wqv2hc5d. |
| `name` | texte | — | Le nom du client. |
| `email` | texte ou null | — | Son adresse, en minuscules : ses factures y partent. |
| `phone` | texte ou null | — | Son numéro, masqué. En clair, il se demande à part (POST /v1/customers/{id}/phone), et le geste va au journal. |
| `country` | texte ou null | — | Le pays de son numéro, en ISO 3166-1 alpha-3. |
| `note` | texte ou null | — | Ce que vous en notez ; jamais montré au client. |
| `archived_at` | entier ou null | — | Quand il a été archivé ; null tant qu’il ne l’est pas. |
| `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/customers/cli_01j9xn4rt6m8wqv2hc5d \
  -H "Authorization: Bearer sk_test_…" \
  -H "Idempotency-Key: clients-modifier-01" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "awa.houenou@exemple.bj"
  }'
```

## La réponse

```json
{
  "object": "customer",
  "id": "cli_01j9xn4rt6m8wqv2hc5d",
  "name": "Awa Houénou",
  "email": "awa.h@exemple.bj",
  "phone": "+229 01 •• •• 21 07",
  "country": "BEN",
  "note": "Cliente depuis juin.",
  "archived_at": null,
  "created": 1789826492,
  "livemode": false
}
```