PHPackages combindma/cmi-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. combindma/cmi-payment AbandonedArchivedLibrary[Payment Processing](/categories/payments) combindma/cmi-payment ===================== Laravel package to communicate with the CMI payment plateform 1.1.0(2y ago)92.7k↓66.7%5[1 PRs](https://github.com/combindma/cmi-payment/pulls)MITPHPPHP ^8.1 Since Jan 29Pushed 2y ago1 watchersCompare [ Source](https://github.com/combindma/cmi-payment)[ Packagist](https://packagist.org/packages/combindma/cmi-payment)[ Docs](https://github.com/combindma/cmi-payment)[ RSS](/packages/combindma-cmi-payment/feed)WikiDiscussions main Synced 3w ago READMEChangelog (3)Dependencies (11)Versions (4)Used By (0) Package Laravel pour communiquer avec la plateforme de paiement CMI =================================================================== [](#package-laravel-pour-communiquer-avec-la-plateforme-de-paiement-cmi) [![Latest Version on Packagist](https://camo.githubusercontent.com/6705377a64186782f7728dfcca1154c475934bec95d23402e2de0f0ab4dafc95/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f636f6d62696e646d612f636d692d7061796d656e742e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/combindma/cmi-payment)[![GitHub Tests Action Status](https://camo.githubusercontent.com/57b3725fd3ccc32cdad72567393f4613badb8b07bb96988b7604dc90bb22f916/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f636f6d62696e646d612f636d692d7061796d656e742f72756e2d74657374732e796d6c3f6272616e63683d6d61696e266c6162656c3d7465737473267374796c653d666c61742d737175617265)](https://github.com/combindma/cmi-payment/actions?query=workflow%3Arun-tests+branch%3Amain)[![GitHub Code Style Action Status](https://camo.githubusercontent.com/ed93e03bccd47816dafffe3a1ce03dcc990dc0d510af3a741e08c1eb8dad4a1f/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f636f6d62696e646d612f636d692d7061796d656e742f6669782d7068702d636f64652d7374796c652d6973737565732e796d6c3f6272616e63683d6d61696e266c6162656c3d636f64652532307374796c65267374796c653d666c61742d737175617265)](https://github.com/combindma/cmi-payment/actions?query=workflow%3A%22Fix+PHP+code+style+issues%22+branch%3Amain)[![Total Downloads](https://camo.githubusercontent.com/a36619ed9c3bb94f5aec34b856c4a1b9ad57fa76e01c3873f6e536a9fefb4694/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f636f6d62696e646d612f636d692d7061796d656e742e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/combindma/cmi-payment) Installation ------------ [](#installation) Vous pouvez installer le package via composer : ``` composer require combindma/cmi-payment ``` En option, vous pouvez publier le fichier de configuration avec : ``` php artisan vendor:publish --tag="cmi-payment-config" ``` Optionnellement, vous pouvez publier les vues en utilisant : ``` php artisan vendor:publish --tag="cmi-payment-views" ``` Configuration ------------- [](#configuration) Vous devez fournir toutes les informations d'identification requises dans votre fichier .env : ``` CMI_CLIENT_ID= //Identifiant du marchand (attribué par le CMI) CMI_STORE_KEY= //clé du magasin (configurée dans votre espace back office de la plate-forme CMI) CMI_BASE_URI= //Gateway de paiement en mode web (attribué par le CMI). Exemple de test: https://testpayment.cmi.co.ma/fim/est3Dgate CMI_OK_URL= //L’URL utilisée pour rediriger le client vers le site marchand en cas d’autorisation de paiement acceptée. CMI_FAIL_URL= //L’URL utilisée pour rediriger le client vers le site marchand en cas d’autorisation de paiement échouée. CMI_SHOP_URL= //L'URL de retour vers laquelle le client est redirigé lorsqu'il clique sur le bouton "Annuler" affiché sur la page de paiement. CMI_CALLBACK_URL= //L’URL utilisée dans la requête de confirmation de paiement en mode server to server ``` Voir ci-dessous comment vous pouvez récupérer les okUrl, failUrl, shopUrl et callbackUrl. Utilisation ----------- [](#utilisation) Par exemple, imaginez que vous avez un site de commerce électronique, et dans votre CheckoutController, vous voulez ajouter CMI Gateway. Vous devez donc ajouter la trait CmiGateway à ce contrôleur : ``` class CheckoutController extends Controller { use \Combindma\Cmi\Traits\CmiGateway; /* * utilisez ceci comme exemple de test de paiement * */ public function testCmiPayment() { $cmiClient = new Cmi(); $cmiClient->setOid(date('dmY').rand(10, 1000)); $cmiClient->setAmount(10.25); $cmiClient->setBillToName('name'); $cmiClient->setEmail('email@domaine.com'); $cmiClient->setTel('0021201020304'); $cmiClient->setCurrency('504'); $cmiClient->setDescription('ceci est un exemple à utiliser'); $cmiClient->disableCallbackRespense(); //Désactivez les réponses de rappel, si vous ne voulez pas traiter la callbackResponse. $otherData = [ 'billToStreet1' => 'Street Fighter', 'billToCity' => 'Casanegra', 'billToCountry' => 'Morocco', //etc... ]; return $this->requestPayment($cmiClient, $otherData); } } ``` Dans votre fichier de routes, listez les routes nécessaires à CMI comme ceci : ``` Route::post('/cmi/callback', [CheckoutController::class, 'callback'])->withoutMiddleware(\App\Http\Middleware\VerifyCsrfToken::class); //notez que vous pouvez utiliser le chemin que vous voulez, mais vous devez utiliser la méthode de rappel (callback) implémentée dans la trait CmiGateway Route::post('/cmi/okUrl', [CheckoutController::class, 'okUrl'])->withoutMiddleware(\App\Http\Middleware\VerifyCsrfToken::class);// dans la trait CmiGateway, cette méthode est vide pour que vous puissiez implémenter votre propre processus après un paiement réussi Route::post('/cmi/failUrl', [CheckoutController::class, 'failUrl'])->withoutMiddleware(\App\Http\Middleware\VerifyCsrfToken::class);// la fail url redirigera l'utilisateur vers shopUrl avec une erreur pour que l'utilisateur puisse essayer de payer à nouveau Route::get('/url-of-checkout', [CheckoutController::class, 'yourMethod']);// Par exemple, c'est la route où l'utilisateur cliquera sur "Payer maintenant. "( Nous recommandons de l'utiliser comme shopUrl, afin de pouvoir rediriger l'utilisateur en cas d'échec du paiement) ``` Maintenant, vous pouvez spécifier correctement le fichier de configuration : ``` CMI_OK_URL=https://www.domain.com/cmi/okurl CMI_FAIL_URL=https://www.domain.com/cmi/failurl CMI_SHOP_URL=https://www.domain.com/url-of-checkout CMI_CALLBACK_URL=https://www.domain.com/cmi/callback ``` Dans votre CheckoutController, vous devez implémenter votre propre processus une fois que le paiement a été traité avec succès : ``` class CheckoutController extends Controller { public function okUrl(Request $request) { // Cherchez dans la base de données des commandes pour l'enregistrement identifié par la valeur du paramètre "oid" envoyé par la plateforme CMI dans la requête. Traitez votre commande comme vous le souhaitez. } } ``` Après cela, vous êtes prêt à accepter les paiements. Voici les méthodes disponibles : ``` $cmiClient = new Cmi(); // Dans Cmi, vous devez fournir un identifiant de la commande, sauf que dans la plupart des cas la commande est créée après le paiement de l'utilisateur // donc à la place, vous pouvez utiliser soit un identifiant de transaction ou l'identifiant du panier et ajouter 3 nombres aléatoires, et récupérer le panier actuel dans le callback en supprimant les 3 derniers chiffres. // La valeur de oid doit être unique pour chaque transaction. Parce que si l'utilisateur clique sur revenir en arrière sans payer. Vous ne pouvez pas utiliser le même identifiant de transaction (Allez comprendre) $cmiClient->setOid($cart->id.rand(100,900)); //ajouter email client $cmiClient->setEmail('email@domain.com'); //ajouter nom client $cmiClient->setBillToName('Nom client'); //ajouter tel client $cmiClient->setTel('0021201020304'); //La langue utilisée lors de l’affichage des pages de paiement. Valeurs possibles : ar, fr, en. $cmiClient->setLang('fr'); //Code ISO de la devise par défaut de la transaction $cmiClient->setCurrency('504'); //Utilisé pour afficher (ou non) la liste des devises de change dans les pages de paiement. (Voir documentation CMI) $cmiClient->enableCurrenciesList(); //La conversion du montant dans une devise étrangère, à montrer au client dans la page de paiement. (Voir documentation CMI) $cmiClient->setAmountCur(10.25); //Symbole de la devise de conversion à afficher dans la page de paiement avec la valeur du paramètre "amountCur". (Voir documentation CMI) $cmiClient->setSymbolCur('EUR'); //Description envoyée à l’MPI $cmiClient->setDescription('add your description'); //Remplacer L’URL par défaut utilisée pour rediriger le client vers le site marchand en cas d’autorisation de paiement acceptée. $cmiClient->setOkUrl('https://domain.com/cmi/okurl'); //Remplacer L’URL par défaut utilisée pour rediriger le client vers le site marchand en cas d’autorisation de paiement échouée. $cmiClient->setFailUrl('https://domain.com/cmi/failurl'); //Remplacer L’URL par défaut de retour vers laquelle le client est redirigé lorsqu'il clique sur le bouton "Annuler" affiché sur la page de paiement. $cmiClient->setShopUrl('https://domain.com/cmi/shopurl'); //Remplacer L’URL utilisée dans la requête de confirmation de paiement en mode server-to-server $cmiClient->setCallbackUrl('https://domain.com/callback'); //Activer la redirection automatiquement du client vers le site marchand lorsque la transaction de paiement en ligne est traitée. (par défaut activé) $cmiClient->enableAutoRedirect(); //Désactiver la redirection automatiquement du client vers le site marchand lorsque la transaction de paiement en ligne est traitée. (par défaut activé) $cmiClient->disableAutoRedirect(); //Activer la requête de confirmation de paiement en mode server-to-server (par défaut activé) $cmiClient->enableCallbackRespense(); //Désactiver la requête de confirmation de paiement en mode server-to-server (par défaut activé) $cmiClient->disableCallbackRespense(); //Permet de définir le délai d'expiration de la session de la page de paiement (en secondes). La valeur minimale autorisée est 30 secondes et la valeur maximale est 2700 secondes. $cmiClient->setSessionTimeout(1800); ``` Testing ------- [](#testing) ``` composer test ``` Contributing ------------ [](#contributing) Please see [CONTRIBUTING](.github/CONTRIBUTING.md) for details. Security Vulnerabilities ------------------------ [](#security-vulnerabilities) Please review [our security policy](../../security/policy) on how to report security vulnerabilities. Credits ------- [](#credits) - [Combind](https://github.com/combindma) - [All Contributors](../../contributors) License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. ### Health Score 33 — LowBetter than 72% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity27 Limited adoption so far Community10 Small or concentrated contributor base Maturity60 Established project with proven stability 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 Every ~388 days Total 3 Last Release 830d ago Major Versions 0.0.1 → 1.0.02023-03-18 PHP version history (2 changes)0.0.1PHP ^8.0 1.1.0PHP ^8.1 ### Community Maintainers ![](https://avatars.githubusercontent.com/u/81177530?v=4)[Combind](/maintainers/combindma)[@combindma](https://github.com/combindma) --- Top Contributors [![omarherri](https://avatars.githubusercontent.com/u/12627384?v=4)](https://github.com/omarherri "omarherri (1 commits)") --- Tags laravelcombindmacmi payment ### Code Quality TestsPest Code StyleLaravel Pint ### Embed Badge ![Health badge](/badges/combindma-cmi-payment/health.svg) ``` [![Health](https://phpackages.com/badges/combindma-cmi-payment/health.svg)](https://phpackages.com/packages/combindma-cmi-payment) ``` ### Alternatives [spatie/laravel-pdf Create PDFs in Laravel apps 1.0k4.3M42](/packages/spatie-laravel-pdf)[spatie/laravel-health Monitor the health of a Laravel application 87411.3M152](/packages/spatie-laravel-health)[rawilk/profile-filament-plugin Profile & MFA starter kit for filament. 3913.7k](/packages/rawilk-profile-filament-plugin)[danestves/laravel-polar A package to easily integrate your Laravel application with Polar.sh 8118.0k](/packages/danestves-laravel-polar)[harris21/laravel-fuse Circuit breaker for Laravel queue jobs. Protect your workers from cascading failures. 43140.3k](/packages/harris21-laravel-fuse)[vormkracht10/laravel-mails Laravel Mails can collect everything you might want to track about the mails that has been sent by your Laravel app. 24855.3k](/packages/vormkracht10-laravel-mails) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)