Créer un client
Créer un client
Aperçu
Créer un client
Crée un client dans votre organisation. Il est automatiquement rattaché à votre organisation.
Quand l’utiliser
Utilisez lorsque vous avez une identité client stable et souhaitez carte enregistrée, abonnements ou un historique de transactions propre.
Voir aussi
Lister les clients · Mettre à jour un client
Authentification
Les routes marchandes nécessitent une clé API dans l’en-tête X-API-KEY (voir Vue d’ensemble). Utilisez une clé test avec https://sandbox.api.lomi.africa et une clé live avec https://api.lomi.africa.
Endpoint
POST /customers
URLs de base :
https://sandbox.api.lomi.africahttps://api.lomi.africa
Requête
Paramètres d’URL
Pas d’autre paramètre dans l’URL.
Paramètres de requête
Aucun paramètre de requête.
En-têtes
| Nom | Emplacement | Obligatoire | Schéma | Description |
|---|---|---|---|---|
Lomi-Account | header | Non | - | Optional lomi. Network account id (acct_...). When present, the API key acts as the Operator and the request targets the connected Member Account. |
Corps de la requête
Corps JSON.
Schéma: object
| Champ | Obligatoire | Type | Description |
|---|---|---|---|
name | Oui | string | - |
email | Non | string | - |
phone_number | Non | string | - |
whatsapp_number | Non | string | - |
country | Non | string | - |
city | Non | string | - |
address | Non | string | - |
postal_code | Non | string | - |
is_business | Non | boolean | - |
metadata | Non | object | - |
Exemple de corps :
{
"name": "Jane Doe"
}Réponses
| Statut | Description |
|---|---|
201 | Client créé avec succès |
400 | Données d'entrée invalides |
401 | Clé API invalide ou manquante |
Erreurs
Les erreurs suivent un format JSON standard. 401 : clé manquante ou invalide. 404 : ressource introuvable. 429 : trop de requêtes. Pour les créations, envoyez une clé d’idempotence si votre flux le permet.
Exemple
curl -sS -X POST "https://sandbox.api.lomi.africa/customers" \
-H "X-API-KEY: $LOMI_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Jane Doe"}'OpenAPI
- operationId:
CustomersController_create - Operation:
POST /customers
Schémas complets et Try it : référence API.