mecxer713/gopay-php

Un package PHP universel (Laravel & Symfony) pour intégrer l'API GoPAY

v1.0.1 2026-06-12 06:17 UTC

Requires

• php: ^8.0
• guzzlehttp/guzzle: ^7.2

Requires (Dev)

• illuminate/support: ^9.0|^10.0|^11.0
• symfony/config: ^5.4|^6.0|^7.0
• symfony/dependency-injection: ^5.4|^6.0|^7.0
• symfony/http-kernel: ^5.4|^6.0|^7.0

MIT

• Mecxer713

• symfony
• api
• payment
• gopay
• laravel
• payout
• fintech
• mobile-money

README

Ce package permet une intégration rapide et facile de l'API GoPAY (Paiement et Payout) pour vos projets PHP, avec un support natif pour Laravel et Symfony.

Installation

Installez le package via Composer :

composer require mecxer713/gopay-php

Intégration Laravel

1. Configuration

Publiez le fichier de configuration :

php artisan vendor:publish --provider="Mecxer713\GoPay\GoPayServiceProvider" --tag="config"

Ajoutez vos clés dans le fichier .env :

GOPAY_BASE_URL="https://gopay.gooomart.com"
GOPAY_API_KEY="votre_cle_api_standard"
GOPAY_SECRET_KEY="votre_cle_secrete_standard"
GOPAY_PAYOUT_API_KEY="votre_cle_api_payout"
GOPAY_PAYOUT_SECRET_KEY="votre_cle_secrete_payout"

2. Utilisation

Vous pouvez utiliser la Facade GoPay ou l'injection de dépendances :

use Mecxer713\GoPay\Facades\GoPay;

// Paiement
$response = GoPay::initPayment(500, 'CDF', '[phone]', 'ref-1234');
echo $response->status; // "success"
echo $response->transId;

// Payout
$balanceResponse = GoPay::getPayoutBalance();
echo $balanceResponse->balance;

Intégration Symfony

1. Configuration

Activez le Bundle dans votre fichier config/bundles.php (si Flex ne l'a pas fait automatiquement) :

return [
    // ...
    Mecxer713\GoPay\Symfony\GoPayBundle::class => ['all' => true],
];

Créez le fichier de configuration config/packages/go_pay.yaml :

go_pay:
    base_url: '%env(GOPAY_BASE_URL)%'
    api_key: '%env(GOPAY_API_KEY)%'
    secret_key: '%env(GOPAY_SECRET_KEY)%'
    payout_api_key: '%env(GOPAY_PAYOUT_API_KEY)%'
    payout_secret_key: '%env(GOPAY_PAYOUT_SECRET_KEY)%'

Ajoutez vos clés dans votre .env :

GOPAY_BASE_URL="https://gopay.gooomart.com"
GOPAY_API_KEY="votre_cle_api_standard"
GOPAY_SECRET_KEY="votre_cle_secrete_standard"
GOPAY_PAYOUT_API_KEY="votre_cle_api_payout"
GOPAY_PAYOUT_SECRET_KEY="votre_cle_secrete_payout"

2. Utilisation

Utilisez l'injection de dépendances (Mecxer713\GoPay\GoPayService) dans vos contrôleurs ou services :

namespace App\Controller;

use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
use Mecxer713\GoPay\GoPayServiceInterface;

class PaymentController extends AbstractController
{
    public function index(GoPayServiceInterface $goPayService)
    {
        // Paiement
        $response = $goPayService->initPayment(500, 'CDF', '[phone]', 'ref-1234');
        $transId = $response->transId;

        // Payout
        $balanceResponse = $goPayService->getPayoutBalance();
        $balance = $balanceResponse->balance;
    }
}

PHP Natif (Framework Agnostic)

Vous pouvez également utiliser le SDK sans framework :

require 'vendor/autoload.php';

use Mecxer713\GoPay\GoPayService;

$goPay = new GoPayService(
    'https://gopay.gooomart.com',
    'api_key',
    'secret_key',
    'payout_api_key',
    'payout_secret_key'
);

$balance = $goPay->getPayoutBalance();

Méthodes Disponibles

Voici la liste de toutes les méthodes que vous pouvez appeler depuis l'instance GoPayService (ou via la Facade GoPay sous Laravel) :

💳 Paiements (Payment API)

• initPayment(float $amount, string $devise, string $telephone, string $myref, ?string $usersId = null) Initie une demande de paiement. Renvoie les instructions (ex: saisir le PIN) et les références.
• checkPayment(string $ref) Vérifie l'état d'une transaction de paiement en utilisant la référence retournée lors de l'initialisation.

💸 Transferts d'Argent (Payout API)

• getPayoutBalance() Récupère le solde disponible dans votre Wallet (en différentes devises).
• getPayoutTransfers() Récupère la liste paginée de vos transferts d'argent (historique).
• sendPayoutTransfer(float $montant, string $devise, array $telephones, array $myrefs, ?string $dateDenvoi = null) Permet d'envoyer de l'argent à une ou plusieurs personnes (Mobile Money) en une seule requête.
• getPayoutTransferStatus(string $transIdOrMyref) Affiche le statut actuel d'un transfert d'argent spécifique (EN ATTENTE, TRAITÉE, REJETÉE).
• deletePayoutTransfer(string $transId) Permet d'annuler et de supprimer un transfert d'argent (seulement s'il est au statut EN ATTENTE).

Retours de l'API (DTOs)

Toutes les méthodes de paiement et de payout (à l'exception de getPayoutTransfers) retournent désormais des objets DTO fortement typés :

• Mecxer713\GoPay\DTO\PaymentResponse
• Mecxer713\GoPay\DTO\PayoutBalanceResponse
• Mecxer713\GoPay\DTO\PayoutTransferResponse

Cela permet une meilleure autocomplétion et évite les erreurs d'accès aux tableaux. Par exemple, pour accéder au statut : $response->status au lieu de $response['status'].

Tests

Le SDK utilise Pest PHP pour les tests automatisés. Pour exécuter la suite de tests :

composer test
# ou
./vendor/bin/pest