# Archiver un client

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

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

Il ne se propose plus ; ses paiements et ses factures restent. Son numéro et son adresse redeviennent libres.

## 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 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/archive \
  -H "Authorization: Bearer sk_test_…" \
  -X POST
```

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