gathuku / laravelmpesa
为laravel框架提供简单的mpesa包
v1.2.2
2021-11-13 09:48 UTC
Requires
- php: ^7.1|^8.0
- illuminate/support: ^5.0|^6.0|^7.0|^8.0
Requires (Dev)
- orchestra/testbench: ^4.0
- phpunit/phpunit: ^8.0
README
此包可以帮助您将laravel应用程序与Mpesa daraja API集成。该包消除了(几乎)所有麻烦,让您专注于重要的事情。
该包将帮助您集成以下API,这些API可在mpesa daraja上找到;
- C2B(消费者到企业)
- B2C(企业到消费者)
- 在线Lipa na mpesa(Mpesa Express)
- 撤销
- 交易状态
- 账户余额
文档
您现在看到的就是。但我们还有精美、完全可导航的文档。
安装
您可以通过composer安装此出色的包。
composer require gathuku/laravelmpesa
如果您正在使用Laravel >=5.5,您只需这样做。
如果您仍在使用Laravel 5.4版本,您需要进行的最后步骤是添加包的服务提供者并别名包。为此,请打开您的config/app.php
文件。
向providers
数组添加新行
Gathuku\Mpesa\MpesaServiceProvider::class,
可选地,向aliases
数组添加新行
'Mpesa' => Gathuku\Mpesa\Facades\Mpesa::class,
祝您编码愉快 🎉 💯
配置
接下来,在包安装完成后运行;
php artisan mpesa:install
或者
php artisan vendor:publish
这将有助于发布config/mpesa.php
文件。这个mpesa配置文件是您添加所有Mpesa API配置的地方。这包括应用程序运行的环境(沙箱或生产环境)、回调URL和所需的凭证。您可以从Safaricom的开发者门户的app
获取凭证。
<?php return [ //Specify the environment mpesa is running, sandbox or production 'mpesa_env' => 'sandbox', /*----------------------------------------- |The App consumer key |------------------------------------------ */ 'consumer_key' => 'aR7R09zePq0OSfOttvuQDrfdM4n37i0C', /*----------------------------------------- |The App consumer Secret |------------------------------------------ */ 'consumer_secret' => 'F9AebI6azDlRjLiR', /*----------------------------------------- |The paybill number |------------------------------------------ */ 'paybill' => 601380, /*----------------------------------------- |The Lipa Na Mpesa Online shortcode |------------------------------------------ */ 'lipa_na_mpesa' => '174379', ];
对于生产环境,您需要替换为生产凭证。
出于安全原因,您可能希望在env
文件中定义您的API凭证。例如;
'consumer_key' => env('CONSUMER_KEY'),
用法
完整的用法和示例在USAGE.md
贡献
感谢您考虑为laravelmpesa
做出贡献。欢迎拉取请求和问题。
请务必阅读CONTRIBUTING.md,并在继续之前检查开放问题和PR。
安全漏洞
如果您在laravelmpesa
中发现安全漏洞,请通过hey@gathuku.me发送电子邮件给Moses Gathuku。所有安全漏洞都将得到及时处理。
许可
laravelmpesa
包是开源软件,许可协议为MIT许可