PHPackages consolidis/tara-payment - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Payment Processing](/categories/payments) 4. / 5. consolidis/tara-payment ActiveLibrary[Payment Processing](/categories/payments) consolidis/tara-payment ======================= Ce SDK permet de simplifier l'adoption et l'utiisation du processeurs de paiement TaraMoney v1.0.0(3mo ago)10MITPHP Since Mar 10Pushed 3mo agoCompare [ Source](https://github.com/Consolidis/tara-payment)[ Packagist](https://packagist.org/packages/consolidis/tara-payment)[ RSS](/packages/consolidis-tara-payment/feed)WikiDiscussions main Synced 3w ago READMEChangelog (1)Dependencies (1)Versions (2)Used By (0) 🚀 Taramoney PHP SDK (Non Officiel) ================================== [](#-taramoney-php-sdk-non-officiel) Un SDK PHP simple, élégant et pensé pour la *Developer Experience* (DX) afin d'intégrer facilement l'API de paiement **Taramoney** dans vos projets PHP, Laravel ou Symfony. Ce package a été conçu pour masquer les complexités de l'API originale et vous faire gagner du temps. --- ✨ Pourquoi utiliser ce SDK ? ---------------------------- [](#-pourquoi-utiliser-ce-sdk-) Si vous avez déjà utilisé l'API Taramoney, vous connaissez ces "irritants". Ce SDK les gère automatiquement pour vous : - **Unicité des Product IDs :** Plus besoin de générer des `productId` uniques à chaque requête, le SDK le gère en arrière-plan. - **Formatage des numéros de téléphone :** Que l'utilisateur tape `+237 655 251 245`, `655 25 12 45` ou `655251245`, le SDK nettoie tout et ajoute l'indicatif du pays automatiquement. - **Gestion simplifiée des Webhooks :** Une méthode prête à l'emploi pour décoder les notifications de paiement. --- 📦 Installation -------------- [](#-installation) Vous pouvez installer ce package via [Composer](https://getcomposer.org/). ``` composer require consolidis/tara-payment ``` > **Prérequis :** PHP 8.0+ et l'extension JSON activée. --- 🛠️ Configuration initiale ------------------------- [](#️-configuration-initiale) Pour commencer, instanciez le client avec vos clés API (disponibles sur votre tableau de bord Taramoney). ``` use TaraPayment\TaraClient; // Initialisation simple $tara = new TaraClient( 'VOTRE_API_KEY', 'VOTRE_BUSINESS_ID', 'https://votre-site.com/api/webhook/tara', // URL de webhook par défaut '237' // Indicatif pays par défaut (Ex: Cameroun) ); ``` --- 💳 Lancer un paiement (Mobile Money) ----------------------------------- [](#-lancer-un-paiement-mobile-money) Rien de plus simple. Passez le nom du produit, le prix et le numéro du client. Le SDK s'occupe du reste. ``` try { $resultat = $tara->initPayment([ 'productName' => 'Abonnement Premium 1 Mois', 'price' => 2000, 'phoneNumber' => '655251245', // Le SDK ajoutera automatiquement le 237 ! // 'network' => 'wave' // Optionnel : décommentez pour le Sénégal/Côte d'Ivoire ]); // Retourne l'objet contenant le code USSD à composer ou l'URL de redirection echo "Paiement initié ! Veuillez taper ce code : " . $resultat['message']; } catch (\Exception $e) { echo "Erreur lors du paiement : " . $e->getMessage(); } ``` --- 🔄 Gérer les Webhooks (Notifications de paiement) ------------------------------------------------ [](#-gérer-les-webhooks-notifications-de-paiement) Lorsque l'utilisateur valide le paiement sur son téléphone, Taramoney envoie une requête POST (Webhook) à votre serveur pour vous informer du succès ou de l'échec. Voici comment lire cette réponse de manière sécurisée : ``` // Récupération du JSON brut envoyé par Taramoney $payload = file_get_contents('php://input'); try { $donneesWebhook = $tara->parseWebhook($payload); if ($donneesWebhook['status'] === 'SUCCESS') { $numero = $donneesWebhook['phoneNumber']; // ✅ Paiement réussi : mettez à jour votre base de données, livrez le produit... error_log("Paiement validé pour le numéro : $numero"); } else { // ❌ Le paiement a échoué error_log("Échec du paiement."); } } catch (\Exception $e) { error_log("Erreur Webhook : " . $e->getMessage()); } ``` --- ⚠️ Conseil CRUCIAL pour les Webhooks (Éviter les Timeouts) ---------------------------------------------------------- [](#️-conseil-crucial-pour-les-webhooks-éviter-les-timeouts) L'API Taramoney exige que votre serveur réponde rapidement à la requête de Webhook. Si votre code (envoi d'email, mise à jour de la BDD) prend trop de temps, Taramoney considèrera que le Webhook a échoué et ne réessaiera pas. **Répondez toujours `200 OK` avant d'exécuter votre logique lourde.** ### Exemple en PHP pur [](#exemple-en-php-pur) ``` if (function_exists('fastcgi_finish_request')) { echo json_encode(['status' => 'OK']); fastcgi_finish_request(); // Ferme la connexion avec Taramoney immédiatement } // Mettez votre code de base de données ici... ``` ### Exemple sur Laravel [](#exemple-sur-laravel) Utilisez le système de [Queues (Jobs)](https://laravel.com/docs/queues) de Laravel. ``` public function handleWebhook(Request $request) { $donnees = $tara->parseWebhook($request->getContent()); // On envoie le traitement en arrière-plan ProcessPaymentJob::dispatch($donnees); // On répond tout de suite "Tout va bien" à Taramoney return response()->json(['status' => 'OK'], 200); } ``` --- 🤝 Contribution -------------- [](#-contribution) Les Pull Requests sont les bienvenues ! Si vous trouvez un bug ou souhaitez ajouter une fonctionnalité (comme l'intégration de nouvelles méthodes de l'API), n'hésitez pas à ouvrir une issue ou une PR. --- 📄 Licence --------- [](#-licence) Ce projet est sous licence MIT. N'hésitez pas à l'utiliser et à le modifier pour vos projets personnels comme commerciaux. ### Health Score 32 — LowBetter than 69% of packages Maintenance80 Actively maintained with recent releases Popularity2 Limited adoption so far Community6 Small or concentrated contributor base Maturity34 Early-stage or recently created project Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Unknown Total 1 Last Release 105d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/7ccfed1bea89cb7a1eceb818f1055c482f4a287b49ba6d90e17805f91f9b17b5?d=identicon)[Tatsumi02](/maintainers/Tatsumi02) --- Top Contributors [![Tatsumi02](https://avatars.githubusercontent.com/u/57715006?v=4)](https://github.com/Tatsumi02 "Tatsumi02 (1 commits)") ### Embed Badge ![Health badge](/badges/consolidis-tara-payment/health.svg) ``` [![Health](https://phpackages.com/badges/consolidis-tara-payment/health.svg)](https://phpackages.com/packages/consolidis-tara-payment) ``` ### Alternatives [aws/aws-sdk-php AWS SDK for PHP - Use Amazon Web Services in your PHP project 6.2k532.1M2.5k](/packages/aws-aws-sdk-php)[neuron-core/neuron-ai The PHP Agentic Framework. 2.0k496.1k33](/packages/neuron-core-neuron-ai)[tencentcloud/tencentcloud-sdk-php TencentCloudApi php sdk 3661.2M46](/packages/tencentcloud-tencentcloud-sdk-php)[chargebee/chargebee-php ChargeBee API client implementation for PHP 758.3M9](/packages/chargebee-chargebee-php)[tempest/framework The PHP framework that gets out of your way. 2.2k31.1k12](/packages/tempest-framework)[imdhemy/google-play-billing Google Play Billing 491.4M5](/packages/imdhemy-google-play-billing) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)