Laravel SDK for integrating PawaPay Mobile Money payments (pay-ins, pay-outs, webhooks) across African markets.
# Laravel PawaPay SDK
**Laravel PawaPay SDK** est un package Laravel complet et type-safe pour intégrer les paiements mobile money PawaPay dans 21 marchés africains. Construit avec des pratiques PHP modernes, il fournit une interface fluide pour les pay-ins, pay-outs, la prédiction de fournisseurs, la gestion des webhooks et inclut une API REST complète prête à l'emploi.
## 🚀 Installation
### 1. Installation via Composer
```bash
composer require andydefer/laravel-pawapay
```
### 2. Installation Rapide (Recommandée)
Utilisez la commande d'installation pour publier toutes les ressources en une fois :
```bash
# Installez tout en une seule commande
php artisan pawapay:install
# Installation forcée (écrase les fichiers existants)
php artisan pawapay:install --force
```
### 3. Installation Manuelle (Optionnel)
Si vous préférez un contrôle manuel, publiez des composants spécifiques :
```bash
# Publier uniquement la configuration
php artisan vendor:publish --provider="Pawapay\\PawapayServiceProvider" --tag="pawapay-config"
# Publier les définitions de types TypeScript
php artisan vendor:publish --provider="Pawapay\\PawapayServiceProvider" --tag="pawapay-types"
# Publier le contrôleur API
php artisan vendor:publish --provider="Pawapay\\PawapayServiceProvider" --tag="pawapay-controller"
# Publier les routes personnalisées (optionnel - les routes fonctionnent automatiquement)
php artisan vendor:publish --provider="Pawapay\\PawapayServiceProvider" --tag="pawapay-routes"
# Générer les définitions TypeScript
php artisan pawapay:generate-types
```
### 4. Configuration des Variables d'Environnement
Ajoutez à votre fichier `.env` :
```env
# Environnement (sandbox/production)
PAWAPAY_ENVIRONMENT=sandbox
# Token API de PawaPay
PAWAPAY_API_TOKEN=votre_token_api_ici
# Optionnel : Personnaliser les timeouts et tentatives
PAWAPAY_TIMEOUT=30
PAWAPAY_RETRY_TIMES=3
PAWAPAY_RETRY_SLEEP=100
```
## 📡 Deux Manières d'Utiliser le Package
### Option 1 : Utilisation Di …