Chargement de vos clés API…

Créer un client

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

Ce que fait cet appel

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).

En-tête d'authentification

Authorization: Bearer sk_test_XXXX

Le pool est déduit du préfixe de la clé

Il n'y a pas d'interrupteur test et production sur cette page. sk_test_* ne traite aucun paiement réel, sk_live_* encaisse.

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.

Codes de retour

201

Client créé.

400

Paramètres invalides.

409

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

Langage

Requête cURLpostExemple

1curl --request POST \

2 --url https://api.mobupay.nc/api/v1/customers \

3 --header 'authorization: Bearer sk_test_XXXX' \

4 --header 'content-type: application/json' \

5 --data '{ "email": "alice@example.com", "firstName": "Alice", "lastName": "Dupont", "phone": "+687781234", "externalId": "CUST-001", "locale": "fr", "metadata": { "source": "site-web", "segment": "premium" } }'

Réponse

Cliquez sur Essayer pour lancer la requête et voir la réponse ici. Ou choisissez un exemple :

application/json