Download the PHP package mecxer713/gopay-php without Composer

On this page you can find all versions of the php package mecxer713/gopay-php. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Example code of mecxer713/gopay-php

Informations about the package gopay-php

# GoPay PHP SDK **SDK PHP officiel pour l'API GoPAY — Paiement & Payout Mobile Money** [![Latest Version on Packagist](https://img.shields.io/packagist/v/mecxer713/gopay-php.svg?style=flat-square)](https://packagist.org/packages/mecxer713/gopay-php) [![PHP Version](https://img.shields.io/badge/PHP-%5E8.1-blue?style=flat-square&logo=php)](https://www.php.net) [![Laravel](https://img.shields.io/badge/Laravel-9%2B%20%7C%2010%2B%20%7C%2011%2B-orange?style=flat-square&logo=laravel)](https://laravel.com) [![Tests](https://img.shields.io/badge/tests-passing-brightgreen?style=flat-square)](https://github.com/Mecxer713/gopay-php) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](LICENSE) Intégrez l'API GoPAY en quelques minutes dans vos projets **PHP natif**, **Laravel** ou **Symfony**. [Installation](#-installation) · [Démarrage rapide](#-démarrage-rapide) · [Laravel](#-laravel) · [Symfony](#-symfony) · [PHP natif](#-php-natif) · [Gestion des erreurs](#-gestion-des-erreurs) · [Référence API](#-référence-api)

✅ Prérequis

Dépendance Version minimale
PHP ^8.1
Guzzle HTTP ^7.2
Laravel (optionnel) ^9.0 \| ^10.0 \| ^11.0
Symfony (optionnel) ^5.4 \| ^6.0 \| ^7.0

📦 Installation

⚡ Démarrage rapide

🔷 Laravel

1. Configuration

Le package supporte Laravel Package Auto-Discovery. Aucune déclaration manuelle n'est nécessaire.

Publiez le fichier de configuration :

Ajoutez vos clés dans le fichier .env :

2. Via la Facade

3. Via l'injection de dépendances

🟣 Symfony

1. Activer le Bundle

Dans config/bundles.php (si Flex ne l'a pas fait automatiquement) :

2. Créer la configuration

config/packages/go_pay.yaml :

.env :

3. Utilisation via l'injection de dépendances

🔧 PHP Natif

📖 Référence API

💳 Payment API

initPayment() — Initier un paiement

Retourne : PaymentResponse

checkPayment() — Vérifier le statut

Retourne : PaymentResponse

💸 Payout API

getPayoutBalance() — Solde du wallet

Retourne : PayoutBalanceResponse

sendPayoutTransfer() — Envoyer de l'argent

Retourne : PayoutTransferResponse

getPayoutTransferStatus() — Statut d'un transfert

Retourne : PayoutTransferResponse

getPayoutTransfers() — Liste des transferts

deletePayoutTransfer() — Supprimer un transfert

⚠️ Seuls les transferts au statut EN ATTENTE peuvent être supprimés.

Retourne : PayoutTransferResponse

🗂 Objets de Réponse (DTOs)

Toutes les méthodes retournent des objets PHP fortement typés, avec autocomplétion IDE complète.

PaymentResponse

Propriété Type Description
$success bool true si la requête a réussi
$transactionStatus ?string Statut textuel de la transaction (ex: "success")
$transId ?string Identifiant unique de la transaction
$url ?string URL de redirection (si applicable)
$state ?string État interne de la transaction
$message ?string Message humain retourné par l'API
$amount ?string Montant de la transaction
$currency ?string Devise (ex: "CDF", "USD")
$source ?string Source de la transaction (ex: "API")
$date ?string Date ISO de la transaction
$raw array Réponse JSON brute complète

Méthode helper : isSuccessful(): bool

PayoutBalanceResponse

Propriété Type Description
$success bool true si la requête a réussi
$balance float Solde du wallet
$currency ?string Devise du solde
$message ?string Message de l'API
$raw array Réponse JSON brute complète

Méthode helper : isSuccessful(): bool

PayoutTransferResponse

Propriété Type Description
$success bool true si la requête a réussi
$transactionStatus ?string Statut ("EN ATTENTE", "TRAITÉE", "REJETÉE")
$transId ?string Identifiant unique du transfert
$state ?string État interne
$message ?string Message de l'API
$amount ?string Montant du transfert
$currency ?string Devise
$source ?string Source
$date ?string Date ISO du transfert
$raw array Réponse JSON brute complète

Méthode helper : isSuccessful(): bool

🚨 Gestion des Erreurs

Le SDK retourne directement le corps de la réponse de l'API pour que vous puissiez inspecter toutes les informations en cas d'erreur logique (success: false). Les exceptions ne sont levées qu'en cas d'erreur de communication réseau ou de configuration.

Hiérarchie des exceptions

Exemple complet

Codes d'erreur (GoPayErrorCode)

Enum Valeur Description
APIKEY_MISSING ERR_APIKEY_MISSING Header x-api-key absent
SIGNATURE_MISSING ERR_SIGNATURE_MISSING Header x-signature absent
TIMESTAMP_MISSING ERR_TIMESTAMP_MISSING Header x-timestamp absent
NONCE_MISSING ERR_NONCE_MISSING Header x-nonce absent
APIKEY_INVALID ERR_APIKEY_INVALID Clé API invalide
APIKEY_FORBIDDEN ERR_APIKEY_FORBIDDEN Permissions insuffisantes
APIKEY_INACTIVE ERR_APIKEY_INACTIVE Clé API désactivée
SIGNATURE_INVALID ERR_SIGNATURE_INVALID Signature HMAC incorrecte
TIMESTAMP_EXPIRED ERR_TIMESTAMP_EXPIRED Timestamp expiré (> 120 sec)
NONCE_REPLAY ERR_NONCE_REPLAY Nonce déjà utilisé
VALIDATION ERR_VALIDATION Paramètres invalides
NO_PAYMENT_FOUND ERR_NO_PAYMENT_FOUND Transaction introuvable

🧪 Tests

📄 Changelog

Consultez le fichier CHANGELOG.md pour l'historique des versions.

Version Changements clés
v1.3.1 Mise à jour de .env.example pour inclure la clé Payout et corrections mineures
v1.3.0 Refactoring architectural : séparation en PaymentService, PayoutService et HTTP Client
v1.2.0 Refactoring complet : enums, DTOs enrichis, helpers, ServiceProvider amélioré
v1.1.x Gestion des erreurs API, support clés success/transaction
v1.0.x Version initiale

🤝 Contribution

Les contributions sont les bienvenues ! Pour contribuer :

  1. Forkez le dépôt
  2. Créez une branche : git checkout -b feature/ma-fonctionnalite
  3. Committez vos changements avec des messages clairs
  4. Ouvrez une Pull Request

Assurez-vous que les tests passent avant de soumettre : composer test.

📃 Licence

Ce package est distribué sous la licence MIT. Consultez le fichier LICENSE pour plus de détails.

Développé par Mecxer713 · Propulsé par GoPAY

All versions of gopay-php with dependencies

PHP Build Version
Package Version
Requires php Version ^8.0
guzzlehttp/guzzle Version ^7.2
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package mecxer713/gopay-php contains the following files

Loading the files please wait ...