M-PESA API Package
This is a PHP package for the Safaricom's M-Pesa REST API dubbed DARAJA API.
If you are looking for a laravel implementation do check the following repo Laravel Implementation
Installation
This project supports both composer dependency management tool and can also be used without composer
Using Composer
Run the following commandcomposer require kabangi/mpesa
Without composer
Download the source code as zipped
Follow the following directions
<?php
require "{PATHTOTHISLIBFOLDER}/src/autoload.php";
use KabangiMpesaInit as Mpesa;
Check the following example for usage https://github.com/Kabangi/mpesa/blob/master/example/mpesa.php
Configuration
The library comes with a structured config file based on the API that you intend to use.
To add the necessary configurations:-
Open the folder installation.
Look for a file named config/mpesa.php
Edit the necessary keys that reflects the product you are using.
Usage
<?php
require "../src/autoload.php";
use KabangiMpesaInit as Mpesa;
// You can also pass your own config here.
// Check the folder ./config/mpesa.php for reference
$mpesa = new Mpesa();
try {
$response = $mpesa->STKPush([
'amount' => 10,
'transactionDesc' => '',
'phoneNumber' => '',
]);
$response = $mpesa->B2C([
'amount' => 10,
'accountReference' => '12',
'callBackURL' => 'https://example.com/v1/payments/C2B/confirmation',
'queueTimeOutURL' => 'https://example.com/v1/payments/C2B/confirmation',
'resultURL' => 'https://example.com/v1/payments/C2B/confirmation',
'Remarks' => 'Test'
]);
// $mpesa->STKStatus([]);
// $mpesa->C2BRegister([]);
// $mpesa->STKPush([]);
// $mpesa->C2BSimulate([]);
// $mpesa->B2C([])
// $mpesa->B2B([]);
// $mpesa->accountBalance([])
// $mpesa->reversal([]);
// $mpesa->transactionStatus([]);
// $mpesa->reversal([]);
}catch(Exception $e){
$response = json_decode($e->getMessage());
}
header('Content-Type: application/json');
echo json_encode($response);
Support
Need support using this package:- Send a quick message here
https://t.me/kabangi
API's Supported
The library implements all the exposed endpoints by Safaricom as listed below:-
1. Lipa na M-Pesa Online Payment
What it is?
The Lipa na M-Pesa Online Payment endpoint(STK push) allows you to request payment from your users/clients. With this endpoint all the user is required to do is input their M-PESA pin to a prompt to send a payment to you.
How to implement it?
Read docs here.
2. Lipa na M-Pesa Online Query Request
What it is?
When you request payment from your users/clients via Lipa na M-Pesa Online endpoint above you might want to know the status of that request. This endpoint facilitates that. It allows you to query the status of any STK push on demand.
How to implement it?
Read docs here.
3. C2B
What it is?
This endpoint enables developers to receive real time notifications when a client makes a payments to a merchant's Till number or Paybill number. It assumes the payment are made via the SIM card toolkit and as a developer you need to know when that payment hits the merchants till/paybill number for reconciliation and accounting purposes.
How to implement it?
Read docs here.
4. B2C
What it is?
This endpoints enables merchants to pay their customers from they paybill account. Some of the use cases are but not limited to paying salaries, paying promotions to customers etc.
How to implement it?
Read docs here.
5. B2B
What it is?
This endpoint allows merchants to transfer funds from business to business accounts.
How to implement it?
Read docs here.
6. Transaction Status
What it is?
This endpoint enables developers to initiate status check of a B2B, B2C and C2B transactions. It really comes in handy where one party in a transactions fails/claims not to have received an acknowledgment for a transaction.
How to implement it?
Read docs here.
7. Reverse API
What it is?
This endpoint enables merchants to reverse a B2B, B2C or C2B transaction. It allows automation of reversal of erronous payment to a merchant's paybill/till number or payments to goods never delivered.
How to implement it?
Read docs here.
8. Account Balance
What it is?
This endpoint enables merchants to query their Till/Paybill numbers account balance on demand.
How to implement it?
Read docs here.
Inspiration
This package was inspired by the work from smodav work on the following project:- https://github.com/SmoDav/mpesa
Contributors
Gratitudes goes to the following Ninjas for their help during my integration process and the things I had to learn along the way fom them or their code:-
Julius Kabangi
License
The M-Pesa Package is open-sourced software licensed under the MIT license.
版权声明：
1、该文章(资料)来源于互联网公开信息，我方只是对该内容做点评，所分享的下载地址为原作者公开地址。2、网站不提供资料下载，如需下载请到原作者页面进行下载。
3、本站所有内容均由合作方或网友上传，本站不对文档的完整性、权威性及其观点立场正确性做任何保证或承诺！文档内容仅供研究参考学习用！
4、如文档内容存在违规，或者侵犯商业秘密、侵犯著作权等，请点击“违规举报”。
