keenops/laravel-mpesa

Laravel 对 Vodacom M-Pesa API 的封装,为 Laravel 应用程序提供无缝集成体验

v0.0.1-beta.1 2023-11-16 19:44 UTC

This package is auto-updated.

Last update: 2024-09-16 22:07:27 UTC


README

Latest Version on Packagist Total Downloads

为与 Vodacom M-Pesa OpenApi 无缝集成而设计,它为 Laravel 开发者提供了一个简化流程,以轻松高效地执行客户与企业交易。

安装

您可以通过 composer 安装此包

composer require keenops/laravel-mpesa:v0.0.1-beta.1

运行上述命令还应发布一个名为 laravel-mpesa.php 的配置文件到配置目录。如果没有发生,可以通过运行以下命令发布配置文件:

php artisan vendor:publish --tag=laravel-mpesa

用法

将 Vodacom M-Pesa API 凭据添加到 .env 文件中。凭据可以在 此处 获取

    MPESA_API_KEY= // get this from your mpesa developer/bussiness account
    MPESA_PUBLIC_KEY= // get this from your mpesa developer/bussiness account
    MPESA_ENVIROMENT= // options are: sandbox, openapi
    MPESA_MARKET_COUNTRY= // options are: TZN, GHA, LES, DRC
    MPESA_MARKET_CURRENCY= // options are: TZS, GHS, SLS, USD

客户到企业交易

在您的控制器中使用如下:

namespace App\Http\Controllers;

use Keenops\Mpesa\Mpesa;


class CheckoutController extends Controller
{
    public function checkout()
    {
        return Mpesa::c2b(
            amount: '1000',
            customerNumber:'255746277553',
            serviceCode: '000000',
            reference: 'T12344Z',
            description: 'Three items',
            conversationId: '1e9b774d1da34af78412a498cbc28f43e'
        );

        //this returns json response from M-Pesa API. Refer the link https://openapiportal.m-pesa.com/ for error and success codes
    }
}

错误

当发送或接收操作失败时,括号内可能会显示特定的错误代码。这些错误代码中最常见的是在 openapiportal.m-pesa.com 上找到的 API 文档中指定的。

测试

composer test

变更日志

有关最近更改的更多信息,请参阅 CHANGELOG

贡献

有关详细信息,请参阅 CONTRIBUTING

安全

如果您发现任何安全相关的问题,请通过电子邮件 git@kimwalu.com 而不是使用问题跟踪器。

鸣谢

许可证

MIT 许可证 (MIT)。有关更多信息,请参阅 许可证文件

Laravel 包模板

此包是使用 Laravel 包模板 生成的。