Aller au contenu principal

PIN — Business

Le PIN est obligatoire uniquement pour les opérations financières déclenchées depuis le dashboard (session humaine) — jamais requis pour un appel via clé API, où la clé elle-même est le seul credential.

POST /api/v1/business/dashboard/pin 🔒​

Body

{ "pin": "1234" }

4 chiffres exactement. 400 si un PIN existe déjà (utiliser pin/change).

POST /api/v1/business/dashboard/pin/change 🔒​

Body

{ "current_pin": "1234", "new_pin": "5678" }

401 si current_pin incorrect.

Comportement au dépôt/retrait​

CheminPIN requis ?
POST /business/mobile-money/deposits (clé API)Non
POST /business/dashboard/mobile-money/deposits (session)Oui

Si le PIN n'est pas encore configuré :

{ "message": "PIN not set. Please set a PIN first." }

→ 401

Mauvais PIN → 401, compteur décompté, verrouillage 15 min après 3 échecs.