# Corrections apportees au module Airtel

## Fichiers modifies
- config.php
- verify-client.php
- validate-amount.php
- payment.php
- transaction-status.php
- .htaccess

## Fichiers ajoutes
- .env.example  -> a copier en ".env" et remplir avant mise en prod
- logs/.htaccess -> bloque l'acces web direct au dossier de logs
- logs/          -> contiendra airtel.log + les compteurs de rate limit

## Etapes AVANT de deployer sur le serveur

1. Copier `.env.example` en `.env` dans le meme dossier `api/airtel/`.
2. Remplir dans `.env` :
   - AIRTEL_API_KEY : generer une NOUVELLE cle (l'ancienne a deja circule,
     ne pas la reutiliser). Exemple pour en generer une en local :
     php -r "echo bin2hex(random_bytes(32));"
   - DB_HOST / DB_NAME / DB_USER / DB_PASS : vos identifiants MySQL actuels.
   - AIRTEL_ALLOWED_IPS : laisser vide pour l'instant si vous n'avez pas
     encore la liste des IP officielles d'Airtel Money. A activer des que
     possible (demander la liste a votre contact Airtel / documentation
     d'integration marchand).
3. Uploader tout le dossier `api/airtel/` (y compris `.env` et `logs/`)
   sur le serveur, en remplacant l'ancien.
4. Verifier que `.env` n'est PAS accessible publiquement :
   https://tozzigreen.tuto-info.com/api/airtel/.env doit renvoyer une
   erreur 403 (grace au .htaccess ajoute).
5. Communiquer la NOUVELLE cle API a Airtel Money (l'ancienne doit etre
   consideree comme compromise puisqu'elle a circule dans un fichier zip).
6. Verifier que le certificat HTTPS est bien force sur le serveur (pas
   d'acces HTTP en clair) - a verifier cote hebergement.

## Ce qui a ete ajoute dans le code

- Cle API et identifiants DB lus depuis .env au lieu d'etre en dur.
- Whitelist IP optionnelle (checkAllowedIp) : desactivee tant que
  AIRTEL_ALLOWED_IPS est vide, a activer des que vous avez les IP d'Airtel.
- Limitation de debit (checkRateLimit) : 30 requetes/min par IP par defaut,
  reglable via .env.
- Validation du timestamp envoye par Airtel (validateTimestamp) : rejette
  les requetes dont le timestamp s'ecarte de plus de 5 min de l'heure
  serveur, pour limiter le rejeu.
- Journalisation (logEvent) : chaque appel important est ecrit dans
  logs/airtel.log (auth refusee, IP refusee, paiement recu/valide/refuse,
  rate limit atteint, etc.)
- transaction-status.php ne renvoie plus SELECT * mais uniquement les
  colonnes necessaires.

## Ce qui n'a PAS ete change

- Le contrat d'API (noms des champs, endpoints, formats de reponse) reste
  identique a ce qui a deja ete documente et envoye a l'equipe backend /
  Airtel, pour ne rien casser cote integration.
- validate-amount.php garde son comportement actuel (verification de la
  plage globale uniquement), car changer son contrat impliquerait de
  coordonner avec Airtel sur un nouveau champ (reference_client) - a
  discuter separement si vous voulez ce renforcement.
