README

Getting Started

To get started with your Airtel Money integration:

1. Register your application on the Airtel Money Developer Portal.

2. Add products to your application: APIs are grouped into products.

   • Start with: Account, KYC, Collection-APIs, and Disbursement-APIs.
   • Each product may have specific KYC/compliance requirements, which the Airtel Money team will advise during onboarding.

3. Request application approval from the Airtel Money Support Team.

   • Your application will only work after it has been approved.
   • You can monitor the approval status in the developer portal.

4. Whitelist your source IPs in the developer portal under Settings -> Security -> Server IP Allowed List.

   • Any collection or disbursement request originating from a non-whitelisted source IP will be declined at Airtel Money.

5. Set disbursement PIN: optional for collections.

6. Set collection callback: you can set an endpoint to where your callbacks should be set. Optionally, you can enable Authorization for it.

Statuses

New Applications will have the default NA status.

Products

The disbursement wallet has no dedicated balance-inquiry API; its running balance is returned with each transaction response.

Integration

Installation

composer require bmatovu/laravel-airtel-money

Publishables

php artisan vendor:publish --provider="Bmatovu\AirtelMoney\AirtelMoneyServiceProvider"

Database Migrations

php artisan migrate

Authorization & PIN

Set Credentials

Retrieve your client_id and client_secret from Key Management

php artisan airtel-money:auth

Set Disbursement PIN

php artisan airtel-money:pin

Usage

Authorization

use Bmatovu\AirtelMoney\Facades\Authorization;

$token = Authorization::getToken();

KYC

use Bmatovu\AirtelMoney\Facades\Kyc;

$user = Kyc::getUser($phoneNumber);

Collection

use Bmatovu\AirtelMoney\Facades\Collection;

$transaction = Collection::receive($phoneNumber, $amount);

$transaction = Collection::refund($airtelMoneyId);

$transaction = Collection::getTransaction($transactionId);

Account

use Bmatovu\AirtelMoney\Facades\Account;

$balance = Account::getBalance();

Disbursement

use Bmatovu\AirtelMoney\Facades\Disbursement;

$transaction = Disbursement::send($phoneNumber, $amount);

$transaction = Disbursement::getTransaction($transactionId);

Testing

composer test

Credits

• mtvbrianking
• All Contributors

License

This package is open-source software licensed under the MIT License.