Types de clients

Tous vos porteurs ne se valent pas : un client VIP, un professionnel, un salarié, un client standard. Les types de clients rangent vos porteurs dans des segments que vous définissez.

À quoi ça sert

• Afficher un statut sur la carte : « Gold », « Pro », « Abonné ». L’en-tête iOS peut afficher le type (iosHeader à TYPE, voir PATCH/store-cards).
• Cibler un segment : envoyez coupons et notifications à ses clients (liste de destinataires, target: SPECIFIC pour les notifications).
• Faire évoluer un client : il passe Silver → Gold, vous changez son type, sa carte se met à jour.

Les endpoints

Besoin	Endpoint
Lister les types	GET/client-types
Créer un type (et en faire le type par défaut avec isDefault)	POST/client-types
Lire, modifier, supprimer un type	GET/client-types/{id}, PATCH/client-types/{id}, DELETE/client-types/{id}
Affecter un type à un client	champ clientType de POST/clients ou PATCH/clients/{id}

POST/client-typesEssayer →

• curl
• SDK Node.js
• nodejs
• php
• python
• java
• csharp
• go
• ruby

• CURL

curl -L 'https://api-v2.test.eldowallet.fr/client-types' \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-H 'x-lang: fr' \
-H 'Authorization: Bearer <token>' \
-d '{
  "name": "Gold",
  "isDefault": false
}'

Le type par défaut

Un wallet qui utilise les types a toujours un type par défaut. Un client créé sans type le reçoit. Vous ne pouvez pas retirer le seul type par défaut : l’API renvoie DEFAULT_CLIENT_TYPE_REQUIRED. Désignez d’abord un autre type par défaut.

Erreur d’affectation

Un type inconnu ou mal formé à la création d’un client renvoie ERROR_CUSTOMER_TYPE_ASSIGNMENT. Récupérez les identifiants avec GET/client-types.

Pour aller plus loin

• Importer une base clients
• Cas d’usage Auto & garages : particuliers et professionnels sur le même programme