2. Se connecter (WhatsApp)

La connexion du particulier se fait en deux appels : le numéro de téléphone, puis le code à 6 chiffres reçu par WhatsApp.

Demander le code WhatsApp

POST/auth/login/phonePublic

Envoie un code à 6 chiffres par WhatsApp au numéro du compte. Réservée aux comptes particuliers.

Corps de la requête

{
  "phone": "696246686"
}

Réponse 200

{
  "success": true,
  "data": {
    "requires_whatsapp_otp": true,
    "challenge_token": "550e8400-e29b-41d4-a716-446655440000"
  },
  "meta": {
    "request_id": "...",
    "timestamp": "..."
  }
}

Code	Quand
422	Numéro inconnu, compte entreprise (utiliser la connexion par e-mail), compte désactivé, ou envoi WhatsApp en échec.

Valider le code et recevoir le jeton

POST/auth/whatsapp-otp/challengePublic

Valide le code reçu. Le challenge_token est à usage unique et expire après 5 minutes.

Corps de la requête

{
  "challenge_token": "550e8400-e29b-41d4-a716-446655440000",
  "code": "123456"
}

Réponse 200

{
  "success": true,
  "data": {
    "merchant": {
      "id": 1,
      "name": "Nom Prénom",
      "merchant_type": "individual",
      "kyc_status": "none"
    },
    "token": "<jeton-de-session>",
    "token_type": "Bearer"
  },
  "meta": {
    "request_id": "...",
    "timestamp": "..."
  }
}

Code	Quand
422	Code invalide, challenge expiré ou déjà consommé : relancer l'étape précédente.

Conservez token : c'est le jeton de session des étapes suivantes (Authorization: Bearer {token}).
Déconnexion : POST /auth/logout.