Créer un client

Crée un nouveau client. Un client représente un acheteur récurrent à qui vous pouvez associer des moyens de paiement tokenisés (paiements one-click), des paiements, et des sessions wallet. L'email est unique par marchand. `externalId` permet de mapper le client à votre identifiant interne (également unique par marchand).

Corps de la requête

application/json

emailstringRequis

Email du client. Format RFC 5322. Unique par marchand : un second appel avec le même email retourné `409 CONFLICT`.

externalIdstringOptionnel

Votre identifiant interne du client (ex: ID utilisateur de votre back-office). Unique par marchand. Max 255 caractères.

firstNamestringOptionnel

Prenom du client. Max 255 caractères.

lastNamestringOptionnel

Nom de famille. Max 255 caractères.

phonestringOptionnel

Numéro de telephone au format E.164 recommande (ex: `+687781234`). Max 50 caractères.

localestringOptionnel

Locale du client pour les emails et la page de paiement (ex: `fr`, `fr_FR`, `en`). 2 a 10 caractères.

metadataobjectOptionnel

Métadonnées libres (clé/valeur). Conservées telles quelles, retournées dans les webhooks et les readbacks.

Réponses

201Client créé.

400Paramètres invalides.

409Un client avec cet `email` ou cet `externalId` existe déjà pour ce marchand.

Exemple de requête

POSThttps://api.mobupay.nc/api/v1/customers

curl -X POST https://api.mobupay.nc/api/v1/customers \
  -H "Authorization: Bearer sk_test_XXXX" \
  -H "Content-Type: application/json" \
  -d '{ "email": "alice@example.com", "firstName": "Alice", "lastName": "Dupont", "phone": "+687781234", "externalId": "CUST-001", "locale": "fr", "metadata": { "source": "site-web", "segment": "premium" } }'