PHPackages                             gopay-libs/gopay-ui - 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. gopay-libs/gopay-ui

ActiveLibrary[Payment Processing](/categories/payments)

gopay-libs/gopay-ui
===================

Official GoPay payment UI SDK for Laravel. Easily embed Mobile Money payment forms, process transactions and automate post-payment actions.

v1.0.1(1mo ago)01MITPHP ^8.2

Since Jun 21Compare

[ Source](https://github.com/gopay-sdk/gopay-ui)[ Packagist](https://packagist.org/packages/gopay-libs/gopay-ui)[ Docs](https://gopay.gooomart.com)[ RSS](/packages/gopay-libs-gopay-ui/feed)WikiDiscussions Synced 2w ago

READMEChangelogDependencies (6)Versions (3)Used By (0)

GoPay UI SDK pour Laravel
=========================

[](#gopay-ui-sdk-pour-laravel)

SDK officiel GoPay permettant d'intégrer facilement les paiements Mobile Money dans vos applications Laravel.

---

Fonctionnalités
---------------

[](#fonctionnalités)

- Formulaire de paiement prêt à l'emploi
- Intégration Mobile Money
- Validation cryptographique des paiements
- Traitement automatique après paiement
- Insertion automatique de données après paiement
- Mise à jour automatique de données après paiement
- Redirection ou rafraîchissement automatique
- Mode Sandbox pour les tests
- Traitement des paiements en arrière-plan
- Compatible Laravel 12+

---

Installation
------------

[](#installation)

```
composer require gopay-libs/gopay-ui
```

Puis :

```
php artisan gopay:install
```

Cette commande :

- publie la configuration
- publie les migrations
- exécute les migrations

---

Configuration
-------------

[](#configuration)

Ajoutez dans votre fichier `.env` :

```
GOPAY_API_KEY=
GOPAY_PAYOUT_API_KEY=
GOPAY_SECRET_KEY=
GOPAY_ENV=sandbox
```

Valeurs possibles :

```
GOPAY_ENV=sandbox
```

ou

```
GOPAY_ENV=production
```

---

Exemple complet
---------------

[](#exemple-complet)

```
use App\Models\Order;
use Gopay\GopayUi\DTO\PaymentFormData;
use Gopay\GopayUi\DTO\PaymentInsertAction;
use Gopay\GopayUi\DTO\PaymentUpdateAction;
use Gopay\GopayUi\Enums\PaymentSuccessAction;
use Gopay\GopayUi\GopayUI;

$form = new PaymentFormData(

    amount: 10,

    currency: 'USD',

    phone: '991234567',

    onSuccess: PaymentSuccessAction::GO_TO_URL,

    redirectUrl: '/payment/success?reference={reference}&amount={amount}&currency={currency}',

    formColor: '#262626',

    payBtnLabel: 'Payer maintenant',

    insertActions: [

        new PaymentInsertAction(
            model: Order::class,
            data: [
                'reference' => '{reference}',
                'amount' => '{amount}',
                'currency' => '{currency}',
                'name' => 'Paiement GoPay'
            ]
        )

    ],

    updateActions: [

        new PaymentUpdateAction(
            model: Order::class,
            where: [
                'reference' => '{reference}'
            ],
            data: [
                'status' => 'PAID'
            ]
        )

    ]

);

echo GoPayUI::renderForm($form);
```

---

Propriétés de PaymentFormData
-----------------------------

[](#propriétés-de-paymentformdata)

PropriétéDescriptionamountMontant à payercurrencyUSD ou CDFphoneNuméro pré-rempli (9 chiffres)onSuccessAction après paiementredirectUrlURL de redirectionformColorCouleur principale du formulairepayBtnLabelTexte du bouton payerinsertActionsInsertion automatiqueupdateActionsMise à jour automatique---

Placeholders disponibles
------------------------

[](#placeholders-disponibles)

Les placeholders suivants peuvent être utilisés dans :

- redirectUrl
- insertActions
- updateActions

```
{reference}
{amount}
{currency}

```

Exemple :

```
redirectUrl: '/success?ref={reference}&amount={amount}'
```

---

Montants minimums
-----------------

[](#montants-minimums)

DeviseMontant minimumUSD1CDF500---

Mode Sandbox
------------

[](#mode-sandbox)

Pour tester votre intégration sans effectuer de véritables paiements :

```
GOPAY_ENV=sandbox
```

Le formulaire affichera un badge indiquant que vous êtes en environnement de test.

Résultats simulables :

- success
- failed

Pour passer en production :

```
GOPAY_ENV=production
```

---

Traitement automatique des paiements en attente
-----------------------------------------------

[](#traitement-automatique-des-paiements-en-attente)

Exécution manuelle :

```
php artisan gopay:process-pending
```

Planification recommandée :

```
Schedule::command('gopay:process-pending')
    ->everyMinute();
```

Cette commande :

- vérifie les transactions en attente
- consulte leur état chez GoPay
- exécute automatiquement les insertions et mises à jour prévues

---

Désinstallation
---------------

[](#désinstallation)

```
php artisan gopay:uninstall
```

Cette commande :

- annule les migrations du package
- supprime les ressources publiées

---

Sécurité
--------

[](#sécurité)

Le SDK signe cryptographiquement les informations sensibles du formulaire.

Toute tentative de modification du montant ou de la devise côté client entraîne le rejet de la transaction.

Seuls les paiements validés par GoPay sont traités.

---

Politique du SDK officiel
-------------------------

[](#politique-du-sdk-officiel)

Le SDK GoPay est open-source et peut être utilisé, modifié, forké ou redistribué conformément à sa licence.

Toutefois, seules les versions publiées et distribuées par GoPay sont considérées comme des versions officielles.

Les versions modifiées ou redistribuées par des tiers ne sont ni certifiées, ni auditées, ni maintenues par GoPay.

GoPay ne pourra être tenu responsable d'éventuels dysfonctionnements, pertes de données, failles de sécurité ou dommages résultant de l'utilisation de versions modifiées du SDK.

Pour garantir la sécurité et la compatibilité, il est recommandé d'utiliser exclusivement les versions officielles publiées par GoPay.

---

Support
-------

[](#support)

---

Tests
-----

[](#tests)

Le SDK inclut des tests automatisés basés sur Pest.

### Installation des dépendances de test

[](#installation-des-dépendances-de-test)

```
composer install
```

Installer Pest :

```
composer require pestphp/pest --dev
```

Puis :

```
php artisan pest:install
```

### Exécuter tous les tests

[](#exécuter-tous-les-tests)

```
./vendor/bin/pest
```

ou

```
php artisan test
```

### Structure recommandée

[](#structure-recommandée)

```
tests/
├── PaymentFormDataTest.php

```

### Couverture recommandée

[](#couverture-recommandée)

Les tests doivent couvrir au minimum :

- Validation de PaymentFormData
- Montants minimums (USD / CDF)
- Validation des numéros de téléphone

### Contribution

[](#contribution)

Toute nouvelle fonctionnalité importante devrait être accompagnée de tests afin de garantir la stabilité du SDK.

---

Licence
-------

[](#licence)

MIT License

###  Health Score

37

—

LowBetter than 81% of packages

Maintenance90

Actively maintained with recent releases

Popularity1

Limited adoption so far

Community2

Small or concentrated contributor base

Maturity47

Maturing project, gaining track record

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 ~0 days

Total

2

Last Release

45d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/d622325c4d65cb9a6dfdea6463aa052ce2df7dc8f4086be6f7c3815bf67ef3f4?d=identicon)[MadiPatrick](/maintainers/MadiPatrick)

---

Tags

laravelsdkpaymentpaymentscheckoutmobile-moneyfintechgopayrdccongo

###  Code Quality

TestsPest

### Embed Badge

![Health badge](/badges/gopay-libs-gopay-ui/health.svg)

```
[![Health](https://phpackages.com/badges/gopay-libs-gopay-ui/health.svg)](https://phpackages.com/packages/gopay-libs-gopay-ui)
```

###  Alternatives

[duncanmcclean/statamic-cargo

Comprehensive e-commerce addon for Statamic. Build bespoke e-commerce sites without the complexity.

3618.3k](/packages/duncanmcclean-statamic-cargo)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
