Logo XALISEl-Anewar
GitHub

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

Schéma : le parcours d'un paiement PayTech dans une application Laravel

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

Attention

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.

Astuce

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.

Plateforme réalisée parEl-Anewar Damala