Momo Suite
  • Introduction
  • Getting Started
  • Basic Concepts
  • Providers (Hubtel)
    • Korba
    • PayStack
    • ITC
  • Dashboard (Overview)
    • Transaction Detail Page
      • Status Check for Pending Transactions
      • Manual Status Update (Admin Only)
      • Transaction Timeline
      • Technical Details
  • User Management
  • Transaction Status Update Notifications
Powered by GitBook
On this page
  1. Providers (Hubtel)

Korba

  1. Add the following variables to your .env file:

KORBA_CLIENT_ID=your-client-id
KORBA_SECRET_KEY=your-secret-key
KORBA_CLIENT_KEY=your-client-key
KORBA_URL=https://xchange.korba365.com/api/v1.0/
KORBA_ENVIRONMENT=production  # or 'test' for testing
  1. The configuration is loaded from config/momo-suite.php:

'korba' => [
    'client_id' => env('KORBA_CLIENT_ID'),
    'secret_key' => env('KORBA_SECRET_KEY'),
    'client_key' => env('KORBA_CLIENT_KEY'),
    'base_url' => env('KORBA_URL', 'https://xchange.korba365.com/api/v1.0/'),
    'environment' => env('KORBA_ENVIRONMENT', 'production'),
],

Receiving Money

To receive money using Korba:

use Rais\MomoSuite\Facades\Momo;

// Using Facade
$result = Momo::setProvider('korba')
    ->receive([
        'phone' => '0241234567',
        'amount' => 1.00,
        'network' => 'MTN',
        'reference' => 'Test Payment',
    ]);

// Using Service Container
$momo = app('momo-suite');
$result = $momo->receive([
    'phone' => '0241234567',
    'amount' => 1.00,
    'network' => 'MTN',
    'reference' => 'Test Payment',
]);

// Required Parameters:
// - phone: Customer's phone number
// - amount: Transaction amount
// - network: Mobile network (MTN, VODAFONE, AIRTELTIGO)
// - reference: Your transaction reference

Sending Money

To send money using Korba:

use Rais\MomoSuite\Facades\Momo;

$result = Momo::setProvider('korba')
    ->send([
        'phone' => '0241234567',
        'amount' => 1.00,
        'network' => 'MTN',
        'reference' => 'Test Disbursement',
    ]);

// Required Parameters:
// - phone: Recipient's phone number
// - amount: Amount to send
// - network: Mobile network (MTN, VODAFONE, AIRTELTIGO)
// - reference: Your transaction reference

Webhook Handling

Korba sends webhook notifications to update transaction statuses. Configure your webhook URL in your Korba dashboard.

The package automatically handles webhooks at:

POST /momo/webhooks/korba

PreviousProviders (Hubtel)NextPayStack

Last updated 1 month ago