Skip to main content

​
URL de base

Toutes les requêtes et réponses sont en JSON (Content-Type: application/json), sauf les exports de fichiers.

​
Authentification

Le JWT s’obtient via POST /user/login-merchant et se passe sans préfixe Bearer. Détails : Authentification.

​
Conventions

  • Montants : entiers en FCFA. Le solde est renvoyé en chaîne décimale ("125000.00").
  • Dates : ISO 8601 en UTC (2026-09-18T08:00:00.000Z).
  • Identifiants : merchant_reference (votre référence), payment_reference (référence PAY… du paiement), id (UUID des ressources).
  • Erreurs : { "statusCode": 400, "message": "…", "error": "Bad Request" }. Voir Gestion des erreurs.
  • Codes de succès : 200 pour les lectures et mises à jour, 201 pour les créations (convention NestJS — les POST renvoient 201 même sans création de ressource).

​
Endpoints

​
Spécification OpenAPI

La spécification complète est disponible au format OpenAPI 3.1 : openapi.yaml. Importez-la dans Postman, Insomnia ou un générateur de client.