Modifier un client
/v1/customers/{id}
Modifie un client et renvoie sa fiche complète après modification.
La modification est partielle : seuls les champs envoyés changent, tous les autres sont conservés tels quels. N'envoyez donc que ce que vous voulez modifier, pas la fiche entière. Pour vider un champ texte, envoyez-le avec une chaîne vide. La même règle vaut à l'intérieur de adresse : envoyer seulement adresse.ville ne touche pas au code postal.
Il faut l'identifiant exact du client : pour le trouver à partir d'une adresse mail, utilisez d'abord GET /v1/customers?email=…. Un client supprimé dans l'application est introuvable (404), il ne peut pas être modifié ni réactivé.
Remplacer l'adresse mail par une adresse déjà portée par un autre client actif est refusé avec l'erreur duplicate_email, sauf avec ?allow_duplicate_email=true. La fidélité (points, cumuls), les dates et l'identifiant ne s'écrivent pas par cette adresse : les points s'ajustent par POST /v1/customers/{id}/loyalty-points. Pour vérifier une requête sans rien enregistrer, ajoutez ?dry_run=true.
Paramètres
id |
Obligatoire | Identifiant du client (champ id). |
dry_run |
Facultatif | true pour tout vérifier sans rien enregistrer : la réponse est celle que vous auriez obtenue, avec meta.dry_run à true. L'identifiant renvoyé n'est alors pas réservé. |
allow_duplicate_email |
Facultatif | true pour enregistrer même si un autre client actif porte déjà cette adresse mail. À n'utiliser qu'après avoir vérifié qu'il s'agit bien de deux personnes différentes. |
Idempotency-Key |
Facultatif | Identifiant unique de votre choix (8 à 100 caractères). Si vous renvoyez la même requête avec le même identifiant, elle n'est pas exécutée deux fois : vous recevez la réponse d'origine. Recommandé pour toute création. |
Corps JSON à envoyer
| Champ | Type | Description |
|---|---|---|
civilite |
texte |
Civilité, parmi les valeurs exactes : chaîne vide, M., Mme, Mlle, Sct. À la création, si elle est absente : la civilité par défaut réglée par le commerçant. |
nom |
texte | Nom. 40 caractères au maximum. |
prenom |
texte | Prénom. 40 caractères au maximum. |
nom_2 |
texte | Nom secondaire, facultatif. Chaîne vide si non renseigné. 40 caractères au maximum. |
email |
texte | Adresse mail. Chaîne vide si non renseignée. Elle n'est pas unique : plusieurs clients peuvent porter la même. 50 caractères au maximum. |
tel |
texte | Téléphone fixe. 17 caractères au maximum. |
mobile |
texte | Téléphone mobile. 17 caractères au maximum. |
bc_ext |
texte | Code-barres associé au client (carte de fidélité par exemple). 32 caractères au maximum. |
remise_pc |
entier | Remise permanente accordée au client, en pourcentage. Entier de 0 à 100. |
notes |
texte | Notes libres saisies par le commerçant. 5 000 caractères au maximum. |
libre_1 |
texte |
Champ personnalisé texte n° 1. Son libellé est dans champs_personnalises. 50 caractères au maximum. |
libre_2 |
texte | Champ personnalisé texte n° 2. 50 caractères au maximum. |
libre_3 |
texte | Champ personnalisé texte n° 3. 50 caractères au maximum. |
custom_io_1 |
booléen | Champ personnalisé oui/non n° 1. |
custom_io_2 |
booléen | Champ personnalisé oui/non n° 2. |
custom_io_3 |
booléen | Champ personnalisé oui/non n° 3. |
custom_date_1 |
texte |
Champ personnalisé date n° 1 (AAAA-MM-JJ). Chaîne vide si non renseignée. Format AAAA-MM-JJ. Chaîne vide pour effacer la date. |
custom_date_2 |
texte |
Champ personnalisé date n° 2. Format AAAA-MM-JJ. Chaîne vide pour effacer la date. |
custom_date_3 |
texte |
Champ personnalisé date n° 3. Format AAAA-MM-JJ. Chaîne vide pour effacer la date. |
news_sms |
booléen |
Le client accepte de recevoir des SMS. À respecter avant tout envoi. false à la création si absent : n'envoyez true que si la personne a donné son accord. |
news_email |
booléen |
Le client accepte de recevoir des mails. À respecter avant tout envoi. false à la création si absent : n'envoyez true que si la personne a donné son accord. |
fidelite_active |
booléen |
Le client participe au programme de fidélité. true à la création si absent. |
id_shop_origin |
entier |
Identifiant du magasin d'origine du client, parmi ceux listés par GET /v1/me. À la création, si absent : le premier magasin du compte. |
adresse |
objet | Adresse postale. Seuls les champs envoyés sont enregistrés ou modifiés. |
adresse.ligne1 |
texte | Adresse. 50 caractères au maximum. |
adresse.ligne2 |
texte | Complément d'adresse. 50 caractères au maximum. |
adresse.cp |
texte | Code postal. 9 caractères au maximum. |
adresse.ville |
texte | Ville. 30 caractères au maximum. |
adresse.pays_code |
texte |
Code du pays à deux lettres (FR, BE, CH…). À la création, si absent : le pays du magasin d'origine. |
adresse.tva_intra |
texte | Numéro de TVA intracommunautaire. 32 caractères au maximum. |
Exemple d'appel
curl -X PATCH "https://api.wanapos.com/v1/customers/1842" \
-H "Authorization: Bearer VOTRE_CLE" \
-H "Content-Type: application/json" \
-d '{"mobile":"0611223344","news_sms":true,"adresse":{"ville":"Villeurbanne","cp":"69100"}}'
Réponse en cas de succès (statut 200)
Le client après modification, avec sa fiche complète.
| Champ | Type | Description |
|---|---|---|
data |
objet |
Un client du compte. Les noms de champs sont ceux des événements sortants client_create et client_update. Voir tous les champs
|
meta |
objet | |
meta.request_id |
texte | Identifiant de l'appel, à communiquer à l'assistance en cas de problème. |
{
"data": {
"id": 1842,
"civilite": "Mme",
"nom": "Martin",
"prenom": "Claire",
"nom_2": "",
"email": "claire.martin@exemple.com",
"tel": "",
"mobile": "0600000000",
"bc_ext": "",
"remise_pc": 0,
"notes": "",
"libre_1": "",
"libre_2": "",
"libre_3": "",
"custom_io_1": false,
"custom_io_2": false,
"custom_io_3": false,
"custom_date_1": "",
"custom_date_2": "",
"custom_date_3": "",
"news_sms": false,
"news_email": true,
"fidelite_active": true,
"actif": true,
"id_shop_origin": 1,
"date_creation": "2026-03-14T10:22:00+01:00",
"date_update": "2026-10-02T16:05:00+02:00",
"adresse": {
"ligne1": "12 rue des Lilas",
"ligne2": "",
"cp": "69003",
"ville": "Lyon",
"id_pays": 63,
"pays_code": "FR",
"pays": "France",
"tva_intra": "",
"archived": false
},
"fidelite": {
"points_actuels": 120,
"points_cumules": 340,
"nb_fois_pts_utilises": 2,
"last_pts_acquis": 15,
"total_ca": 412.5,
"total_qt": 17,
"total_pa": 9
},
"champs_personnalises": [
{
"cle": "libre_1",
"libelle": "Customisé 1",
"type": "texte",
"affiche": false,
"valeur": ""
},
{
"cle": "libre_2",
"libelle": "Customisé 2",
"type": "texte",
"affiche": false,
"valeur": ""
},
{
"cle": "libre_3",
"libelle": "Customisé 3",
"type": "texte",
"affiche": false,
"valeur": ""
},
{
"cle": "custom_io_1",
"libelle": "Customisé 1",
"type": "oui_non",
"affiche": false,
"valeur": false
},
{
"cle": "custom_io_2",
"libelle": "Customisé 2",
"type": "oui_non",
"affiche": false,
"valeur": false
},
{
"cle": "custom_io_3",
"libelle": "Customisé 3",
"type": "oui_non",
"affiche": false,
"valeur": false
},
{
"cle": "custom_date_1",
"libelle": "Customisé 1",
"type": "date",
"affiche": false,
"valeur": ""
},
{
"cle": "custom_date_2",
"libelle": "Customisé 2",
"type": "date",
"affiche": false,
"valeur": ""
},
{
"cle": "custom_date_3",
"libelle": "Customisé 3",
"type": "date",
"affiche": false,
"valeur": ""
}
]
},
"meta": {
"request_id": "3f9a1c0b7d2e4a61"
}
}
Erreurs possibles
-
401
Clé absente, inconnue ou révoquée. Codes :
missing_key,invalid_key. -
403
Appel refusé pour ce compte ou cette clé. Codes :
api_not_activated,account_not_eligible,access_blocked,missing_scope. -
404
L'élément demandé n'existe pas sur ce compte. Code :
resource_not_found. -
409
Un client actif porte déjà cette adresse mail. Code :
duplicate_email. Le message etdetailsdonnent les identifiants des clients existants. Rien n'a été enregistré. -
422
Données envoyées invalides. Code :
validation_failed. Le champdetailsliste chaque erreur. -
429
Quota dépassé. Codes :
rate_limited,daily_quota_exceeded,too_many_failed_attempts. L'en-têteRetry-Afterindique combien de secondes attendre. -
503
Une autre écriture est en cours sur ce compte. Code :
account_busy. Renvoyer la même requête après le délai de l'en-têteRetry-After.
Une question ? contact@wanapos.com
