alexasomba/lenco-php

PHP SDK for Lenco API - Payments, Transfers, Collections

dev-main 2025-12-05 03:39 UTC

Requires

• php: ^8.1
• guzzlehttp/guzzle: ^7.0

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.0
• phpstan/phpstan: ^1.0
• phpunit/phpunit: ^10.0

MIT

• Alexander Asomba

• api
• payments
• sdk
• africa
• fintech
• mobile-money
• lenco

README

PHP SDK for Lenco API - Payments, Transfers, Collections

Installation

composer require alexasomba/lenco-php

Quick Start

<?php

use Lenco\Client;

$lenco = new Client([
    'api_key' => getenv('LENCO_API_KEY'),
    'environment' => 'production', // or 'sandbox'
]);

// Get accounts
$accounts = $lenco->accounts->list();

// Transfer to bank account
$transfer = $lenco->transfers->toBankAccount([
    'accountId' => 'your-account-uuid',
    'accountNumber' => '0123456789',
    'bankId' => 'bank-uuid',
    'amount' => 10000,
    'reference' => 'payment-001',
    'narration' => 'Payment for services',
]);

// Collect via mobile money
$collection = $lenco->collections->fromMobileMoney([
    'amount' => 5000,
    'reference' => 'order-123',
    'phone' => '0971234567',
    'operator' => 'airtel',
    'country' => 'zm',
]);

Laravel Integration

// config/services.php
'lenco' => [
    'key' => env('LENCO_API_KEY'),
    'environment' => env('LENCO_ENVIRONMENT', 'production'),
],

// app/Providers/AppServiceProvider.php
use Lenco\Client;

public function register()
{
    $this->app->singleton(Client::class, function ($app) {
        return new Client([
            'api_key' => config('services.lenco.key'),
            'environment' => config('services.lenco.environment'),
        ]);
    });
}

Features

• Full PHP 8.1+ support
• Accounts, Banks, Transfers, Collections, Settlements, Transactions APIs
• Webhook signature verification
• Automatic retries with exponential backoff
• Laravel service provider included

Documentation

Full API documentation available at docs.lenco.co

Author

Alexander Asomba (@alexasomba) · 𝕏 @alexasomba

License

MIT