Mes publications LinkedIn
Intégrer PayTech dans une application Laravel
PayTech est une solution de paiement mobile très utilisée en Afrique de l'Ouest. J'ai rédigé une documentation open source pour l'intégrer facilement dans un projet Laravel, avec des exemples de code commentés ligne par ligne.
Note
Le dépôt complet est disponible sur GitHub : github.com/Phoenixe12/Paytech-Integration
Ce que couvre la documentation
- Guide d'installation pas à pas
- Configuration du contrôleur et des modèles
- Création des vues et des routes
- Gestion des notifications IPN
- Exemples de code commentés ligne par ligne
- Pages de succès et d'échec personnalisables
- Test des webhooks avec webhook.site, sans déployer l'application
Prérequis
- PHP 8.0 ou plus
- Laravel 9.0 ou plus
- Composer
- Un compte marchand PayTech
1. Configurer les clés d'API
Dans le fichier .env :
PAYTECH_API_KEY=votre_cle_api
PAYTECH_API_SECRET=votre_secret_api
Warning
Ne versionnez jamais vos clés d'API. Le fichier .env doit rester dans le .gitignore.
2. Enregistrer les notifications
On crée un modèle et une migration pour stocker les notifications envoyées par PayTech :
php artisan make:model Notification -m
La table conserve notamment le type d'événement, la référence de commande, le montant, la devise, l'environnement (test ou production) et le token de paiement.
3. Créer le contrôleur
php artisan make:controller PaytechController --resource
Le cœur de l'intégration est l'appel à l'API de demande de paiement :
$response = Http::withHeaders([
'Content-Type' => 'application/json',
'API_KEY' => env('PAYTECH_API_KEY'),
'API_SECRET' => env('PAYTECH_API_SECRET'),
'Accept' => 'application/json',
])->post('https://paytech.sn/api/payment/request-payment', $request->all());
Si la requête réussit, PayTech renvoie une URL de paiement vers laquelle on redirige le client.
4. Gérer l'IPN
L'IPN (Instant Payment Notification) est l'appel que PayTech envoie à votre serveur quand le statut d'un paiement change. C'est lui qui fait foi : on ne valide jamais une commande uniquement parce que le client est revenu sur la page de succès.
Tip
Pendant le développement, utilisez webhook.site comme URL d'IPN : vous voyez immédiatement le contenu exact envoyé par PayTech, sans avoir à déployer votre application.
5. Pages de succès et d'échec
La documentation fournit des vues prêtes à l'emploi, responsives et personnalisables, pour informer le client du résultat de son paiement.
Pour qui ?
Que vous soyez débutant ou expérimenté, cette documentation permet de mettre en place une solution de paiement robuste et sécurisée en quelques heures. N'hésitez pas à la partager, à contribuer ou à me faire vos retours.