README

Package Laravel pour l'intégration simplifiée de MoneyFusion - Solution de paiement mobile money (Orange Money, MTN, Wave, Moov) et cartes bancaires en Afrique.

✨ Fonctionnalités

• ✅ Installation en une commande
• ✅ Configuration automatique
• ✅ Facade Laravel intuitive
• ✅ Routes API et Web pré-configurées
• ✅ Controllers inclus
• ✅ Modèle Eloquent
• ✅ Migrations automatiques
• ✅ Gestion des webhooks
• ✅ Vues Blade incluses
• ✅ Commands Artisan
• ✅ Tests automatisés
• ✅ Support Laravel 10.x et 11.x

📦 Installation

composer require simonet85/laravel-moneyfusion

⚙️ Configuration

1. Publier la configuration

php artisan vendor:publish --tag=moneyfusion-config

2. Configurer .env

MONEYFUSION_API_URL=https://api.moneyfusion.net/api/create-payment
MONEYFUSION_APP_KEY=VotreApp/VotreCle
MONEYFUSION_WEBHOOK_URL=https://votre-domaine.com/api/moneyfusion/webhook
MONEYFUSION_RETURN_URL=https://votre-domaine.com/payment/callback

3. Exécuter les migrations

php artisan migrate

4. (Optionnel) Publier les vues

php artisan vendor:publish --tag=moneyfusion-views

🚀 Utilisation

Avec la Facade

use VotreVendor\LaravelMoneyFusion\Facades\MoneyFusion;

// Créer un paiement
$result = MoneyFusion::createPayment([
    'total_price' => 5000,
    'articles' => [
        [
            'name' => 'Produit A',
            'price' => 5000,
            'quantity' => 1
        ]
    ],
    'nom_client' => 'Jean Dupont',
    'numero_send' => '0707070707',
    'user_id' => auth()->id(),
]);

// Rediriger vers la page de paiement
return redirect($result['url']);

Vérifier le statut d'un paiement

$status = MoneyFusion::checkPaymentStatus($token);

if ($status['data']['statut'] === 'paid') {
    // Paiement réussi
}

Obtenir un paiement

$payment = MoneyFusion::getPaymentByToken($token);

if ($payment->isPaid()) {
    // Traiter la commande
}

Dans un Controller

use VotreVendor\LaravelMoneyFusion\MoneyFusionService;

class CheckoutController extends Controller
{
    public function __construct(
        protected MoneyFusionService $moneyFusion
    ) {}

    public function process(Request $request)
    {
        try {
            $result = $this->moneyFusion->createPayment([
                'total_price' => $request->total,
                'articles' => $request->articles,
                'nom_client' => $request->nom_client,
            ]);

            return redirect($result['url']);

        } catch (\Exception $e) {
            return back()->with('error', $e->getMessage());
        }
    }
}

🛣️ Routes automatiques

Le package enregistre automatiquement les routes suivantes:

API Routes

• POST /api/moneyfusion/payments/initiate - Créer un paiement
• GET /api/moneyfusion/payments/{token}/status - Vérifier le statut
• POST /api/moneyfusion/webhook - Recevoir les webhooks MoneyFusion

Web Routes

• GET /payment/callback - Redirection après paiement
• GET /payment/success/{token} - Page de succès
• GET /payment/failed - Page d'échec
• GET /payment/pending/{token} - Page en attente

🎮 Commands Artisan

Tester la création d'un paiement

php artisan moneyfusion:test-payment --amount=5000 --client="Jean Test"

Vérifier le statut d'un paiement

php artisan moneyfusion:check-payment {token}

📊 Modèle de données

Le package crée automatiquement la table moneyfusion_payments avec les champs suivants:

MoneyFusionPayment {
    id
    token_pay          // Token unique du paiement
    user_id            // ID de l'utilisateur (optionnel)
    order_id           // ID de la commande (optionnel)
    numero_send        // Numéro de téléphone
    nom_client         // Nom du client
    montant            // Montant en FCFA
    frais              // Frais de transaction
    numero_transaction // Numéro de transaction
    statut             // pending, paid, failed, cancelled
    moyen              // Moyen de paiement utilisé
    payment_url        // URL de paiement
    personal_info      // Données personnalisées (JSON)
    articles           // Liste des articles (JSON)
    raw_response       // Réponse brute de l'API (JSON)
    paid_at            // Date de paiement
    created_at
    updated_at
}

Méthodes disponibles

$payment = MoneyFusionPayment::find(1);

// Vérifier le statut
$payment->isPaid();      // bool
$payment->isPending();   // bool
$payment->isFailed();    // bool

// Marquer comme payé
$payment->markAsPaid([
    'numeroTransaction' => 'TRX123',
    'moyen' => 'orange_money',
    'frais' => 250,
]);

// Relations
$payment->user;    // Utilisateur
$payment->order;   // Commande (si configuré)

// Scopes
MoneyFusionPayment::paid()->get();      // Tous les paiements payés
MoneyFusionPayment::pending()->get();   // En attente
MoneyFusionPayment::today()->get();     // Paiements du jour

🔒 Sécurité

Webhooks

Les webhooks sont automatiquement protégés. Le package:

• ✅ Exclut automatiquement la route webhook du CSRF
• ✅ Valide les données reçues
• ✅ Prévient les duplications
• ✅ Log toutes les transactions

Configuration HTTPS

Important: En production, assurez-vous que:

• webhook_url utilise HTTPS
• return_url utilise HTTPS
• Votre domaine a un certificat SSL valide

🧪 Tests

# Exécuter tous les tests
composer test

# Tests avec couverture
composer test-coverage

📖 Documentation complète

Pour une documentation plus détaillée, consultez:

• Guide d'utilisation complet
• Configuration avancée
• Gestion des webhooks
• API Reference

🤝 Contribution

Les contributions sont les bienvenues! Consultez CONTRIBUTING.md pour plus de détails.

🐛 Signaler un bug

Si vous trouvez un bug, ouvrez une issue sur GitHub.

📄 Licence

Ce package est open-source sous licence MIT.

🙏 Remerciements

• MoneyFusion - Plateforme de paiement
• Laravel - Framework PHP

📞 Support

• GitHub Issues: issues
• Email: support@example.com
• Documentation MoneyFusion: docs.moneyfusion.net

🌟 Donnez une étoile!

Si ce package vous est utile, pensez à donner une ⭐ sur GitHub!

Made with ❤️ for the Laravel and African tech community