README

SDK unique pour consommer les APIs BGFI RDC (Omnitech) côté Laravel (provider + facade) et Symfony (bundle auto-wirable) : vérification de compte, dépôt Rakakash, collecte mobile money et suivi de transaction.

Prérequis

• PHP 8.1+
• Composer
• Framework: Laravel 10/11/12 ou Symfony 7.x

Installation Laravel

composer require mecxer713/bgfi-payment
php artisan vendor:publish --tag=bgfi-config

.env minimum :

BGFI_BASE_URL=https://api-uat.bgfi.com
BGFI_LOGIN=mon_login
BGFI_PASSWORD=mon_password
BGFI_CONSUMER_ID=xxxx
BGFI_CONSUMER_SECRET=xxxx
BGFI_CURRENCY=CDF

Installation Symfony

composer require mecxer713/bgfi-payment

Activer le bundle (config/bundles.php) :

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

Configuration (config/packages/bgfi_payment.yaml) :

bgfi_payment:
  base_url: https://api-uat.bgfi.com
  login: mon_login
  password: mon_password
  consumer_id: xxxx
  consumer_secret: xxxx
  currency: CDF

Configuration avancée (commune)

Utilisation

Laravel : importer le facade. Symfony : auto-wirer le service.

// Laravel
use Mecxer713\BgfiPayment\Facades\BgfiPayment;

// Symfony
use Mecxer713\BgfiPayment\Services\BgfiService;
// $bgfi = $container->get(BgfiService::class);

• checkAccount(string $account, string $type = 'RAKAKASH', array $bankDetails = [])
  Vérifie l'existence d'un compte.

  $response = BgfiPayment::checkAccount('243820460800');          // Laravel
  // $response = $bgfi->checkAccount('243820460800');             // Symfony

• deposit(string $phone, float $amount, ?string $currency = null)
  Dépôt Rakakash.

  $response = BgfiPayment::deposit('243998760311', 10000, 'CDF');
  // $response = $bgfi->deposit('243998760311', 10000, 'CDF');

• collect(array $data)
  Collecte mobile money (amount, phone, reference, currency, return_url optionnel).

  $response = BgfiPayment::collect([
      'amount'    => 25000,
      'phone'     => '243820460800',
      'reference' => 'ORDER-2026-0001',
      'currency'  => 'CDF',
      'return_url'=> 'https://votre-app.test/paiement/retour',
  ]);
  // $response = $bgfi->collect([...]);

• getCollectStatus(string $externalRef)
  Statut d'une collecte existante.

  $status = BgfiPayment::getCollectStatus('ORDER-2026-0001');
  // $status = $bgfi->getCollectStatus('ORDER-2026-0001');

Webhook / Callback

• Laravel : route POST auto /{callback_path} (par défaut api/bgfi/callback). Désactiver via BGFI_REGISTER_CALLBACK_ROUTE=false. L'événement Mecxer713\BgfiPayment\Events\BgfiCallbackReceived est dispatché.
• Symfony : exposez votre propre contrôleur qui appelle BgfiService ou relaie l'événement selon vos besoins.

Vérification rapide (Laravel)

php artisan bgfi:test

Tests

composer test