Download the PHP package haybtech/php-sdk without Composer

On this page you can find all versions of the php package haybtech/php-sdk. 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 haybtech/php-sdk

Informations about the package php-sdk

HayBTech PHP SDK

SDK PHP officiel pour l'API HayBTech -- paiement mobile en Afrique de l'Ouest .

Packagist PHP

Intégration par IA (Prompt pour Marchands)

Si vous utilisez un assistant IA (comme Cursor, GitHub Copilot, ChatGPT, Claude, etc.), vous pouvez copier-coller le prompt suivant pour intégrer ce SDK de A à Z dans votre projet :

Installation

Versions PHP supportees

Le SDK manipule des cles secretes marchand (sk_live_*) et signe/verifie des webhooks HMAC. A ce titre, HayBTech ne supporte que les versions de PHP qui recoivent encore des correctifs de securite upstream par l'equipe php.net.

Version PHP Statut SDK Fin du support securite upstream
8.4 Support actif 31 dec 2028
8.3 Support actif 31 dec 2027
8.2 Support actif (min) 31 dec 2026
8.1 Non supporte (EOL) 31 dec 2025
8.0 Non supporte (EOL) 26 nov 2023
7.4 Non supporte (EOL) 28 nov 2022

Reference officielle : php.net/supported-versions.php

Politique d'EOL

HayBTech retire le support d'une version PHP au plus tard 3 mois apres son EOL upstream. Cette regle est appliquee dans composer.json (require.php) et fait l'objet d'une release MAJOR (semver) avec entree CHANGELOG dediee.

Vous etes bloque sur PHP < 8.2 ? Deux options :

  1. Plugin WooCommerce : haybtech-woocommerce-gateway (PHP 7.4+, polyfills inclus) pour les boutiques WordPress sur hebergement mutualise.
  2. Integration REST directe : l'API https://app.haybtech.com/v1 est documentee et utilisable sans SDK depuis n'importe quel runtime capable de signer un HMAC SHA-256.

Configuration (Zéro-Config)

Si vous utilisez un framework (Laravel, Symfony) ou un fichier .env, vous n'avez rien à configurer. Ajoutez simplement votre clé dans votre environnement :

Le SDK détectera automatiquement votre clé. Vous pouvez directement utiliser l'API n'importe où dans votre code :

(Optionnel) Si vous préférez initialiser manuellement, appelez configure() une seule fois au démarrage :

Paiements

Creer un paiement

Le SDK propose une interface fluide pour rediriger vos clients instantanement :

Si vous souhaitez recuperer manuellement l'URL ou d'autres donnees :

Webhooks

1. Verification des signatures (Inbound)

HayBTech envoie un POST signe a votre callback_url. Utilisez le helper pour securiser votre endpoint :

1.bis Verification AUTO (sans HAYBTECH_WEBHOOK_SECRET)

Si vous voulez eviter la double configuration (HAYBTECH_SECRET_KEY + HAYBTECH_WEBHOOK_SECRET), utilisez AutoVerifier : il recupere seul le secret HMAC depuis l'API HayBTech (via votre sk_live_*/sk_test_*) et le cache localement. Pattern recommande pour les nouvelles integrations.

Sur rotation cote HayBTech, le cache est automatiquement invalide a la prochaine signature mismatch (un seul retry, pas de boucle). Exemple complet avec fallback safe : examples/webhook-auto-verify.php.

Pour les workers daemon (Horizon, RoadRunner, queue listeners) sans I/O disque, remplacez FilesystemWebhookSecretCache par InMemoryWebhookSecretCache.

2. Gestion des endpoints (Outbound)

Gerez vos URLs de notification programmatique :

Evenements disponibles

Liste complete des event envoyes a vos endpoints webhook. Abonnez-vous a ce dont vous avez besoin via subscribed_events sur l'endpoint.

Paiements

Evenement Description
payment.initiated Transaction creee, en attente du payeur
payment.pending PSP a accepte, en attente de confirmation finale
payment.success Paiement confirme
payment.failed Paiement echoue (refus PSP, fonds insuffisants…)
payment.cancelled Annule par le client
payment.expired Delai d'attente PSP depasse
payment.updated Metadata ou statut intermediaire mis a jour

Payouts (transferts sortants)

Evenement Description
payout.success Payout confirme cote PSP
payout.failed Payout rejete (KYC, beneficiaire invalide)
payout.cancelled Annule avant execution
payout.refunded Retourne dans le wallet HayBTech
payout.partially_refunded Retour partiel

Remboursements

Evenement Description
refund.success Remboursement abouti
refund.failed Remboursement refuse par le PSP

Gestion des erreurs

Mode test

Utilisation avancee

Securite et Confidentialite

Le SDK integre des mecanismes de protection avances :

Ressources API

Ressource Description
HayBTech::payments() Creer, recuperer, lister, verifier des paiements + splits marketplace
HayBTech::refunds() Initier des remboursements (totaux ou partiels)
HayBTech::payouts() Envoyer des fonds vers un wallet mobile money
HayBTech::payoutRequests() Soumettre une demande de retrait soumise a approbation ops

| HayBTech::balance() | Solde disponible et reserve par devise | | HayBTech::providers() | Liste des PSP actifs (Orange Money SN/CI, Wave, OMD…) | | HayBTech::status() | Statut transaction avec pull PSP si non-terminal (cas webhook perdu) | | HayBTech::disputes() | Lister et repondre aux disputes mobile money | | HayBTech::settlements() | Lister les virements vers le compte marchand | | HayBTech::webhooks() | Gerer vos endpoints de notification (sortants) | | HayBTech::webhook() | Verifier les signatures de webhooks entrants | | HayBTech::health() | Endpoint de healthcheck (sondes uptime) |

Parametres avances pour payments->create()

En plus des champs documentés ci-dessus (merchant_ref, amount, currency, success_url, failed_url, callback_url), payments->create() accepte :

Champ Valeurs Description
payin_fee_mode merchant / customer / split Qui supporte les frais HayBTech. merchant = vous (defaut). customer = montant majore au payeur.
metadata.payment_channel push Active la branche Orange Money Push (paiement direct sans saisie code marchand cote payeur). Necessite l'activation om_push_payment_enabled cote admin + provider account configure (MSISDN partenaire + PIN chiffre).
metadata.* scalar libre Tout couple cle/valeur relaye intact dans les webhooks (commande interne, user_id, etc.).

Exemple OM Push :

Statut d'une transaction (cas webhook PSP perdu)

Publier sur Packagist

Cette section s'adresse aux mainteneurs du SDK.

1. Pousser sur GitHub

2. Soumettre sur Packagist

  1. packagist.org > Submit
  2. URL : https://github.com/haybtech/php-sdk > Check > Submit

3. Webhook GitHub (mises a jour automatiques)

GitHub > Settings > Webhooks > Add webhook :

Champ Valeur
Payload URL https://packagist.org/api/github?username=haybtech
Content type application/json
Secret votre token API Packagist
Events Just the push event

4. Publier une nouvelle version

Respectez semver : PATCH (bug fix) . MINOR (nouvelle feature) . MAJOR (breaking change).

MIT License

All versions of php-sdk with dependencies

PHP Build Version
Package Version
Requires php Version ^8.2
ext-curl Version *
ext-json Version *
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 haybtech/php-sdk contains the following files

Loading the files please wait ...