Créer une session wallet

Crée une session wallet temporaire permettant à un client d'enregistrer une carte dans son wallet Mobupay pour des paiements futurs en one-click. Mobupay réalise une autorisation de vérification de 1 EUR (sans capture, expire automatiquement) afin de tokeniser la carte. Le frontend redirige vers `walletSessionUrl` ; au retour, le client est redirigé vers `returnUrl` avec un paramètre `sessionId`. La carte enregistrée devient un `paymentMethod` lié au client (le wallet est créé au premier enregistrement).

Paramètres

1 en-tête

idstringRequispath

Identifiant du client (`cus_*`) ou utiliser la triple identification via `email`/`externalId` dans le body.

Corps de la requête

application/json

returnUrlstringRequis

URL HTTPS de redirection après l'enregistrement (succès ou échec). Mobupay y ajoute `?sessionId=ses_*` en query.

localestringOptionnel

Code langue de la page d'enregistrement (`fr`, `en`...). 2 a 5 caractères.

emailstringOptionnel

Identifie le client par email si `:id` n'est pas précis. Triple identification.

externalIdstringOptionnel

Identifie le client par identifiant externe. Triple identification.

Réponses

201Session wallet créée.

404Client introuvable.

Exemple de requête

POSThttps://api.mobupay.nc/api/v1/customers/{id}/sessions

curl -X POST https://api.mobupay.nc/api/v1/customers/{id}/sessions \
  -H "Authorization: Bearer sk_test_XXXX" \
  -H "Content-Type: application/json" \
  -d '{ "returnUrl": "https://example.com/wallet/return", "locale": "fr" }'