PHPackages                             palmpesa/palmpesa-payment - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Payment Processing](/categories/payments)
4. /
5. palmpesa/palmpesa-payment

ActiveLibrary[Payment Processing](/categories/payments)

palmpesa/palmpesa-payment
=========================

A Laravel package for handling PalmPesa payments including USSD Push and Pay-by-Link.

00PHP

Since May 5Pushed 1y ago1 watchersCompare

[ Source](https://github.com/Aam-tanzania/Laravel-Palmpesa)[ Packagist](https://packagist.org/packages/palmpesa/palmpesa-payment)[ RSS](/packages/palmpesa-palmpesa-payment/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

Palm pesa laravel simple package

---

```
# Laravel PalmPesa Payment Package

**PalmPesa** is a lightweight Laravel package that allows you to easily integrate payment by link using the Selcom PalmPesa gateway.

## 🔧 Features

- Generate payment links via API
- Redirect users to PalmPesa checkout
- Check transaction status
- Simple HTML form for testing
- Easy integration with any Laravel project

## 🧰 Requirements

- PHP >= 8.0
- Laravel 8, 9, or 10
- Selcom PalmPesa account

---

## 🚀 Installation

### Via Composer (Packagist - if published)

```bash
composer require palmpesa/laravel-palmpesa
```
```

### Or Via GitHub (for development/test)

[](#or-via-github-for-developmenttest)

Add this to your Laravel project's `composer.json`:

```
"repositories": [
  {
    "type": "vcs",
    "url": "https://github.com/Aam-tanzania/laravel-palmpesa"
  }
],
```

### We accept payment from M-pesa, Airtel Money, Mixx by Yas(Tigo), Halotel and TCCL pesa

[](#we-accept-payment-from-m-pesa-airtel-money-mixx-by-yastigo-halotel-and-tccl-pesa)

Then install:

```
composer require palmpesa/laravel-palmpesa
```

---

📦 Package Setup
---------------

[](#-package-setup)

### 1. Add the Service Provider (if Laravel version < 5.5)

[](#1-add-the-service-provider-if-laravel-version--55)

In `config/app.php`:

```
'providers' => [
    PalmPesa\PalmPesaServiceProvider::class,
],
```

### 2. Publish Config (if available)

[](#2-publish-config-if-available)

```
php artisan vendor:publish --tag=palmpesa-config
```

### env. add this line as it is in your .env file

[](#env-add-this-line-as-it-is-in-your-env-file)

PALMPESA\_VENDOR\_ID=TILL61103867

PALMPESA\_API\_KEY =Bearer {put your Api token from palmpesa dashboard}

```

---

## 🧪 Usage

````We have use these form view as an example so use the Url in the post of the form the way you want but those are the data that the specific route

### Payment Form (Pay by USSD PUSH)

```blade

    Payment Form (Pay by USSD PUSH)

        @csrf

            Full Name:

            Email:

            Address:

            Postcode:

            User ID:

            Phone Number:

            Amount (TSh):

        Pay Now

```

---

### Payment Link Form (Example)

[](#payment-link-form-example)

```

```blade

    @csrf

    Get Payment Link

```

### Redirect Page

[](#redirect-page)

```
Go to Payment

    setTimeout(function () {
        window.location.href = "{{ $paymentLink }}";
    }, 3000);

```

---

🛠 Configuration (optional)
--------------------------

[](#-configuration-optional)

If the package supports a config file, update your credentials in `config/palmpesa.php`.

---

📄 License
---------

[](#-license)

This package is open-sourced software licensed under the [MIT license](LICENSE).

---

👨‍💻 Author
----------

[](#‍-author)

**Anord Amri Mwinuka**CTO at [PalmPesa](https://palmpesa.co.tz)[GitHub](https://github.com/Aam-tanzania) • [Email](anoldmwinuka@gmail.com)

```

```

###  Health Score

15

—

LowBetter than 3% of packages

Maintenance36

Infrequent updates — may be unmaintained

Popularity0

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity15

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/da12438ad0b177977decfd65652d4bf8fed956e510839ddc1d4d3191647aef30?d=identicon)[Palmpesa](/maintainers/Palmpesa)

---

Top Contributors

[![Aam-tanzania](https://avatars.githubusercontent.com/u/65364159?v=4)](https://github.com/Aam-tanzania "Aam-tanzania (11 commits)")

### Embed Badge

![Health badge](/badges/palmpesa-palmpesa-payment/health.svg)

```
[![Health](https://phpackages.com/badges/palmpesa-palmpesa-payment/health.svg)](https://phpackages.com/packages/palmpesa-palmpesa-payment)
```

###  Alternatives

[omnipay/paypal

PayPal gateway for Omnipay payment processing library

3156.8M53](/packages/omnipay-paypal)[eduardokum/laravel-boleto

Biblioteca com boletos para o laravel

626351.9k2](/packages/eduardokum-laravel-boleto)[tbbc/money-bundle

This is a Symfony bundle that integrates moneyphp/money library (Fowler pattern): https://github.com/moneyphp/money.

1961.9M](/packages/tbbc-money-bundle)[2checkout/2checkout-php

2Checkout PHP Library

83740.3k2](/packages/2checkout-2checkout-php)[smhg/sepa-qr-data

Generate QR code data for SEPA payments

61717.2k5](/packages/smhg-sepa-qr-data)[omnipay/dummy

Dummy driver for the Omnipay payment processing library

271.2M33](/packages/omnipay-dummy)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)