Download the PHP package filano/laravel-paygate-global without Composer

Laravel PayGateGlobal

Un package Laravel non-officiel pour l'intégration facile des paiements PayGateGlobal avec support pour FLOOZ et TMONEY.

📝 Package communautaire développé par Filano pour aider les développeurs à intégrer plus rapidement PayGateGlobal dans leurs applications Laravel.

PayGateGlobal est le premier intégrateur et leader de solutions monétiques au Togo, offrant la façon la plus rapide de recevoir des paiements en ligne via les portefeuilles mobiles africains.

🌍 À propos de PayGateGlobal

PayGateGlobal simplifie l'acceptation des paiements en ligne au Togo et en Afrique de l'Ouest :

• 🚀 Intégration rapide : API simple, intégration en 5 minutes
• 🔒 Sécurisé : Protection anti-fraude intégrée
• 💳 Paiements mobiles : FLOOZ (Moov Togo) et T-Money (Togocel)
• 📊 Tableau de bord : Interface pour voir les paiements et consulter les soldes
• 💰 Tarification transparente : 2.5% FLOOZ, 3% T-Money, sans frais cachés

Fonctionnalités

• ✅ Initiation de paiements via API ou redirection
• ✅ Vérification du statut des transactions
• ✅ Gestion des webhooks sécurisée
• ✅ Remboursements automatiques
• ✅ Consultation des soldes
• ✅ Support FLOOZ et TMONEY
• ✅ Tests complets inclus
• ✅ Laravel 8, 9, 10, 11, 12 compatible

📋 Prérequis

Ouverture d'un compte PayGateGlobal

1. Créer un compte sur PayGateGlobal (gratuit)
2. Fournir les documents requis pour l'activation :
   • Carte Formalités des Entreprises ou Carte d'Immatriculation Fiscale
   • Carte d'Identité du Promoteur
   • Descriptif du Projet
   • Contact et lien de retour
3. Récupérer votre clé API depuis le tableau de bord après activation

Paiements et reversements

• Solde FLOOZ : Accessible à J+1 via module de remboursement (partenariat MOOV TOGO, ECOBANK, BAT)
• Solde T-Money : Reversé tous les 10 jours par PayGate
• Frais : 2.5% sur FLOOZ, 3% sur T-Money (aucun frais caché)

Installation

Publication des fichiers

🚀 Comment ça marche ?

Étape 1 : Créer un compte PayGateGlobal

1. Remplissez le formulaire d'inscription PayGateGlobal (gratuit)
2. Recevez l'email de confirmation avec les instructions
3. Accédez à votre tableau de bord (compte inactif par défaut)

Étape 2 : Activer votre compte

1. Rendez-vous dans la page de profil de votre compte
2. Fournissez les documents requis :
   • Carte Formalités des Entreprises ou Carte d'Immatriculation Fiscale
   • Carte d'Identité du Promoteur
   • Descriptif du Projet
   • Contact
   • Lien de retour (callback URL)
3. Votre compte est activé après vérification

Étape 3 : Intégrer en 5 minutes

1. Installez ce package Laravel
2. Configurez votre clé API (disponible dans le tableau de bord)
3. Utilisez les méthodes du package pour accepter les paiements
4. Vos clients peuvent payer immédiatement via FLOOZ ou T-Money

Configuration

Ajoutez votre clé API PayGateGlobal dans votre fichier .env:

Utilisation

1. Initiation de paiement (API)

2. Génération d'URL de paiement

3. Vérification du statut

4. Consultation des soldes

5. Remboursements

Gestion des Webhooks

Configuration du webhook

PayGateGlobal enverra automatiquement les notifications de paiement à votre URL de callback.

URL de callback par défaut : https://votre-site.com/paygate-global/webhook

Écouter les paiements

Listener exemple

Codes de statut

Statuts de transaction (initiation)

• 0 : Transaction enregistrée avec succès
• 2 : Jeton d'authentification invalide
• 4 : Paramètres invalides
• 6 : Doublons détectés

Statuts de paiement

• 0 : Paiement réussi
• 2 : En cours
• 4 : Expiré
• 6 : Annulé

Migration de données (optionnel)

Le package inclut une migration pour stocker les transactions:

Helper methods

Tests

Sécurité

• ✅ Validation des signatures webhooks
• ✅ Middleware de sécurité inclus
• ✅ Gestion des erreurs et logs
• ✅ Validation des paramètres requis

Configuration avancée

Le fichier config/paygate-global.php permet de personnaliser:

• auth_token : Votre clé API PayGateGlobal (obligatoire)
• callback_url : URL où PayGateGlobal enverra les notifications (important)
• webhook_secret : Secret pour valider les webhooks (optionnel, recommandé)
• timeout : Délai d'expiration des requêtes HTTP (défaut: 30s)
• log_requests : Activer le logging des requêtes (défaut: true)
• verify_ssl : Vérification SSL pour les appels API (défaut: true, false pour développement local)

Endpoints API supportés

Le package utilise automatiquement les bons endpoints:

• API v1 (https://paygateglobal.com/api/v1) : Paiements, statut par tx_reference
• API v2 (https://paygateglobal.com/api/v2) : Statut par identifier personnalisé

Résolution des problèmes SSL

En développement local, si vous rencontrez des erreurs SSL (cURL error 60), ajoutez dans votre .env:

⚠️ Important : Ne jamais désactiver SSL en production !

Support

• Laravel : 8.x, 9.x, 10.x, 11.x, 12.x
• PHP : 8.0+
• PayGateGlobal : API v1 et v2

📞 Support PayGateGlobal

Contact PayGateGlobal

• Site web : https://paygateglobal.com/
• Email : [email protected]
• Téléphone 1 : +228 96 96 21 21
• Téléphone 2 : +228 92 60 50 32

Adresse

Intégration et support technique

• Documentation officielle : Disponible dans votre tableau de bord PayGateGlobal
• Guide d'intégration : Lien rouge "guide d'intégration" après activation du compte
• Support développeur : PayGateGlobal peut vous aider à finir l'intégration

FAQ PayGateGlobal

Différence entre URL de redirection et Callback URL

• URL de redirection (success_url) : Ramène le client sur votre site après paiement
• Callback URL : Endpoint pour recevoir les confirmations de paiement de PayGateGlobal (webhook)

Sécurité et fraude

PayGateGlobal protège contre les fraudes grâce à :

• Outils de prévention intégrés
• Équipe de gestion des risques dédiée
• Validation des signatures webhooks

Devises et moyens de paiement

• Devise : FCFA uniquement
• Moyens de paiement actuels : FLOOZ et T-Money
• Évolution : VISA et MasterCard prévus prochainement

Licence

MIT License. Voir le fichier LICENSE pour plus de détails.

👨‍💻 À propos du package

Ce package Laravel a été développé par Filano pour aider les développeurs à intégrer plus rapidement PayGateGlobal dans leurs applications Laravel.

Développeur du package

• Filano - Développeur indépendant
• Objectif : Simplifier l'intégration PayGateGlobal pour la communauté des développeurs

💝 Soutenir le développement

Si ce package vous a fait gagner du temps, vous pouvez soutenir le développement :

💰 Faire un don via FedaPay

Votre soutien aide à maintenir et améliorer ce package pour toute la communauté !

Note importante : Ce package est un projet communautaire indépendant créé pour faciliter l'intégration de PayGateGlobal. Pour toute question relative au service PayGateGlobal lui-même (activation de compte, paiements, etc.), veuillez contacter directement PayGateGlobal.

Changelog

Voir CHANGELOG.md pour l'historique des versions.

Package communautaire non-officiel développé par Filano pour faciliter l'intégration de PayGateGlobal dans les applications Laravel.

PayGateGlobal © 2016 BHK Konsulting SARL