Documentation - Passerelle de Paiement

📖 Guide d'Intégration & Spécifications

Spécifications techniques de la passerelle de paiement Mobile Money et intégration Webhook.

🚀 Démarrage rapide

›

Pour lancer l'application en environnement local :

# Lancement des conteneurs BDD (MySQL & Adminer)

docker compose up -d

# Lancement du serveur de dev Laravel

php artisan serve

L'application est immédiatement accessible sur http://localhost:8000.

💻 Commandes Artisan (CLI)

›

Simuler un webhook en ligne de commande :

php artisan payment:simulate --order=CMD-001 --status=SUCCESS

php artisan payment:simulate --order=CMD-001 --bad-signature

Vérifier l'état d'une commande en BDD :

php artisan order:check CMD-001

🧪 Scénarios de test disponibles

›

1. Paiement réussi (SUCCESS)

Signature HMAC valide. La commande passe à l'état paid.

2. Échec de paiement (FAILED)

Signature HMAC valide, statut d'échec. La commande passe à l'état failed.

3. Attaque signature altérée (Bad Signature)

Signature falsifiée. Le middleware VerifyHmacSignature bloque avec HTTP 401 Unauthorized.

4. Attaque DoS Payload > 10 Ko (Oversized)

Corps supérieur à 10240 octets. Rejeté immédiatement avec HTTP 413 Payload Too Large.

🏗️ Architecture du projet

›

• Contrôleur Webhook API : Traitement des requêtes entrantes et application des règles métier.
• Middleware de sécurité HMAC : Contrôle d'intégrité et validation de la signature (VerifyHmacSignature).
• Modèles & Données : Persistance transactionnelle des commandes et journal d'audit (Order, PaymentEvent).
• Moteur de Simulation & Monitoring : Dispatcher d'événements, passerelle opérateur et console d'administration.

🛡️ Environnement Sandbox & Sécurité

›

Cette passerelle fonctionne en environnement Sandbox sécurisé pour tester et valider l'intégration des flux de paiement Mobile Money (Orange Money et MTN MoMo).

Toutes les transactions sont isolées dans le périmètre de test. Aucun débit réel n'est effectué sur les comptes d'utilisateurs.