MonCashConnect vs Fruitsbytes/php-moncash — quelle solution choisir ?

TL;DR — choisissez en 30 secondes

Tableau comparatif

Quand php-moncash est meilleur

La librairie reste un excellent choix dans plusieurs scénarios :

• Vous avez déjà un compte marchand Digicel et vous voulez utiliser exactement ses tarifs négociés.
• Vous voulez le contrôle total du code, sans dépendance à un service hébergé tiers.
• Votre projet est un prototype ou un projet académique : la simplicité d'un composer require l'emporte sur la richesse fonctionnelle.
• Vous êtes développeur PHP avancé et vous savez implémenter proprement la signature de webhook, l'idempotence et la réconciliation.
• Vous voulez auditer chaque ligne de code qui touche un paiement.

Quand MonCashConnect est meilleur

MCC apporte de la valeur quand le coût de votre temps dépasse le gain marginal d'une intégration directe :

• Vous n'avez pas — ou ne voulez pas négocier — un contrat marchand Digicel direct.
• Vous voulez tester votre code sans passer par de vraies transactions, via une sandbox isolée.
• Vous voulez des webhooks signés HMAC-SHA256, avec replay et retries gérés.
• Vous voulez un dashboard pour vos collègues non-développeurs (commerce, finance, support).
• Vous gérez plusieurs projets ou plusieurs clients sous des clés distinctes.
• Vous voulez un audit log côté plateforme, pas seulement dans vos propres logs applicatifs.

Migration de php-moncash vers MCC

La migration est généralement faisable en quelques heures car la forme des appels est similaire (créer un paiement, recevoir un événement, vérifier un statut).

1. Installez notre SDK PHP via Composer : composer require moncashconnect/php-sdk.
2. Remplacez l'initialisation du client. Exemple ci-dessous.
3. Remplacez votre handler webhook par un appel à Webhook::constructEvent() (signature vérifiée automatiquement).
4. Désactivez votre propre listener Digicel et pointez l'URL webhook vers votre nouvelle route MCC depuis le dashboard.

Exemple de remplacement du client :

<?php

// Avant — Fruitsbytes/php-moncash
// $client = new \MonCash\Client($clientId, $clientSecret, 'live');
// $payment = $client->createPayment($orderId, $amount);

// Après — MonCashConnect SDK
use MonCashConnect\Client;

$client = new Client(getenv('MCC_SECRET_KEY')); // sk_proj_… ou sk_test_proj_…
$payment = $client->createPayment($amount, $orderId, [
    'returnUrl' => 'https://votre-site.com/return',
]);

// $payment['paymentUrl'] — redirigez l'utilisateur ici

FAQ