alloys9/mpesa_rahisi

一个用于集成Safaricom的M-Pesa API的简单库

dev-main 2024-08-27 16:15 UTC

This package is auto-updated.

Last update: 2024-09-27 16:26:16 UTC


README

License: MIT

Mpesa Rahisi 为您提供了一种简单的方法来将 M-Pesa 支付服务集成到 Laravel 应用程序中,让您可以通过 Safaricom 的 M-Pesa API 处理支付、处理交易回调和管理客户账单。

特性

  • 无缝集成 M-Pesa 与 Laravel 应用程序。
  • 易于使用的界面,用于发起 STK 推送请求。
  • 自动处理 M-Pesa 回调 URL 并更新交易。
  • 配置选项,可自定义 M-Pesa API 设置。
  • 兼容 Laravel 11.x。

安装

步骤 1:通过 Composer 安装包

composer require alloys9/mpesa_rahisi:dev-main@dev

步骤 2:运行安装命令

下一步是发布应用程序配置。运行以下命令

php artisan mpesa-rahisi:install

此命令将

  • 替换 config/app.php 文件
  • 将控制器复制到 app/Http/Controllers
  • 将迁移复制到数据库/migrations
  • 将模型复制到 app/Models
  • 将视图复制到 resources/views
  • 将必要的路由添加到 routes/web.php
  • 替换 CSRF 中间件文件

步骤 3:迁移数据库

运行以下命令以迁移必要的数据库表

php artisan migrate

步骤 4:将以下内容添加到您的 .env 文件中以保存变量

MPESA_ENVIRONMENT=
SAFARICOM_PASSKEY=
MPESA_BUSINESS_SHORTCODE=
MPESA_CONSUMER_KEY=
MPESA_CONSUMER_SECRET=
MPESA_INITIATOR_PASSWORD=
MPESA_INITIATOR_NAME=
MPESA_SHORTCODE=

MPESA_CALLBACK_URL="${APP_URL}/payments/stkcallback"

MPESA_TEST_URLPRE="https://sandbox.safaricom.co.ke"

MPESA_TOKEN_URL="${MPESA_TEST_URLPRE}/oauth/v1/generate?grant_type=client_credentials"

MPESA_INITIATE_URL="${MPESA_TEST_URLPRE}/mpesa/stkpush/v1/processrequest"

MPESA_STK_QUERY_URL="${MPESA_TEST_URLPRE}/mpesa/stkpushquery/v1/query"

MPESA_SIMULATE_URL="${MPESA_TEST_URLPRE}/mpesa/c2b/v1/simulate"

MPESA_REGISTER_URL="${MPESA_TEST_URLPRE}/mpesa/c2b/v1/registerurl"

MPESA_CONFIRMATION_URL="${APP_URL}/payments/confirmation"

MPESA_VALIDATION_URL="${APP_URL}/payments/validation"

MPESA_B2C_TIMEOUT_URL="${APP_URL}/payments/b2ctimeout"
MPESA_B2C_RESULT_URL="${APP_URL}/payments/b2cresult"

MPESA_REVERSAL_TIMEOUT_URL="${APP_URL}/payments/reversalResult"
MPESA_REVERSAL_RESULT_URL="${APP_URL}/payments/reversalTimeout"

然后您就完成了!就这么简单!

如果发生错误,请运行

php artisan vendor:publish --provider="Alloys9\MpesaRahisi\MpesaRahisiServiceProvider"

然后运行

php artisan mpesa-rahisi:install

许可证

此软件包是开源软件,根据 MIT 许可证授权。

MIT 许可证

版权所有 © 2024 Alloys Amasakha

特此授予任何获得本软件及其相关文档副本(“软件”)的人免费权利,在不加限制的情况下处理软件,包括但不限于使用、复制、修改、合并、发布、分发、转授和/或销售软件副本,并允许向提供软件的人授予此类权利,前提是遵守以下条件

上述版权声明和本许可声明应包含在软件的所有副本或主要部分中。

本软件按“现状”提供,不提供任何明示或暗示的保证,包括但不限于适销性、特定用途的适用性和非侵权性保证。在任何情况下,作者或版权所有者不对任何索赔、损害或其他责任负责,无论该责任是基于合同、侵权或其他方式产生,无论是从、因或与软件或软件的使用或其他交易有关。