PHPackages                             kbk/nepali-payment-gateway - 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. [API Development](/categories/api)
4. /
5. kbk/nepali-payment-gateway

ActiveLibrary[API Development](/categories/api)

kbk/nepali-payment-gateway
==========================

Nepali Payment Gateway integration in PHP language. It includes eSewa, Khalti, ConnectIps, etc.

1.0.2(6mo ago)92711MITPHPPHP ^8.1

Since Dec 15Pushed 4mo ago3 watchersCompare

[ Source](https://github.com/aryanmalla19/nepali-payment-gateway)[ Packagist](https://packagist.org/packages/kbk/nepali-payment-gateway)[ Docs](https://github.com/aryanmalla19/nepali-payment-gateway)[ RSS](/packages/kbk-nepali-payment-gateway/feed)WikiDiscussions main Synced today

READMEChangelogDependencies (4)Versions (11)Used By (1)

Nepali Payment Gateway
======================

[](#nepali-payment-gateway)

[![X (formerly Twitter)](https://camo.githubusercontent.com/a5c593e70fd93b7a11eba7584e7efe91cce5ce28fdd67b6b41f4e4bad0e836a4/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f2d40617279616e6d616c6c6131392d77686974653f7374796c653d666c6174266c6f676f3d78266c6162656c3d28666f726d65726c792532305477697474657229)](https://x.com/aryanmalla19)[![Facebook](https://camo.githubusercontent.com/3c9c0c85b2bbbd2e9b4928c3e1fa08aeec3c542947dd9c3edbe4146cdb024da9/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f46616365626f6f6b2d617279616e6d616c6c6131392d626c75653f7374796c653d666c6174266c6f676f3d66616365626f6f6b)](https://www.facebook.com/aryanmalla19)[![PHP Version](https://camo.githubusercontent.com/71f6292a0e3b5d84aefbce336d1370f8876c7943b504a2ffe22d307bb394272d/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f6b626b2f6e6570616c692d7061796d656e742d67617465776179)](https://camo.githubusercontent.com/71f6292a0e3b5d84aefbce336d1370f8876c7943b504a2ffe22d307bb394272d/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f6b626b2f6e6570616c692d7061796d656e742d67617465776179)[![Downloads](https://camo.githubusercontent.com/7efd235c60320515ff8293254af2566009988844bda6897df5dc30bfd48f7b33/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6b626b2f6e6570616c692d7061796d656e742d676174657761793f6c6162656c3d446f776e6c6f616473)](https://packagist.org/packages/kbk/nepali-payment-gateway)[![License](https://camo.githubusercontent.com/96245d7a786245df3372b83630d30381b6c5ce6a64ea36067c3527596a77f1e9/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f617279616e6d616c6c6131392f6e6570616c692d7061796d656e742d67617465776179)](LICENSE)[![Packagist](https://camo.githubusercontent.com/9f46359e0b12e3aeb11d62c85611254c21e83e84a3c451e15e945ee82d547451/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6b626b2f6e6570616c692d7061796d656e742d67617465776179)](https://packagist.org/packages/kbk/nepali-payment-gateway)

> A PHP library for integrating major Nepali payment gateways.

---

Introduction
------------

[](#introduction)

Nepali Payment Gateway is a PHP package designed to integrate major online payment systems in Nepal into any PHP-based application.
It provides a unified, clean, and developer-friendly interface for initiating and verifying payments across multiple providers.

Currently supported payment gateways:

- **eSewa**
- **Khalti**
- **ConnectIPS**

This package is developed and maintained by **Aryan Malla** along with the open-source community.

For gateway-specific rules, configurations, and policies, please refer to the official documentation provided by each payment partner:

- [Official eSewa Documentation](https://developer.esewa.com.np/)
- [Official Khalti Documentation](https://docs.khalti.com/)
- [Official ConnectIPS Documentation](https://doc.connectips.com/docs/category/2-connectips-gateway/)

---

Requirements
------------

[](#requirements)

- PHP **8.1** or higher
- Composer
- Required PHP extensions:
    - `ext-curl`
    - `ext-openssl`

---

Installation
------------

[](#installation)

```
composer require kbk/nepali-payment-gateway

```

---

Getting Started
---------------

[](#getting-started)

```
require __DIR__ . '/vendor/autoload.php';
```

---

Usage
-----

[](#usage)

### 1) eSewa Payment Gateway

[](#1-esewa-payment-gateway)

#### 1.1 Payment Example

[](#11-payment-example)

```
use Kbk\NepaliPaymentGateway\Epay\Esewa;

$esewa = new Esewa([
    'product_code' => 'EPAYTEST',
    'secret_key'   => 'your-secret-key', // use "8gBm/:&EnhH.1/q" for test env
]);

$response = $esewa->payment([
    'amount'       => 1000,
    'success_url'  => 'https://example.com/success',
    'failure_url'  => 'https://example.com/failure',
]);

return $response->redirect();
```

---

#### 1.2 Payment Verification Example

[](#12-payment-verification-example)

```
$response = $esewa->verify([
    'total_amount' => 100,
    'transaction_uuid' => '123',
]);

if ($response->isSuccess()) {
    echo 'Payment Successful';
} else {
    echo 'Payment Failed';
}
```

Learn More at [eSewa Payment Gateway Docs](eSewa.md)

### 2) Khalti Payment Gateway

[](#2-khalti-payment-gateway)

#### 2.1 Payment Example

[](#21-payment-example)

```
use Kbk\NepaliPaymentGateway\Epay\Khalti;

$khalti = new Khalti(
  secretKey: 'your-secret-key',
  enviroment: 'test', // or 'live'
);

$response = $khalti->payment([
    'return_url' => 'https://example.com/success',
    'website_url' => 'https://example.com/failure',
    'amount' => 100, // in Rs.
    'purchase_order_id' => 'TEST01',
    'purchase_order_name' => 'TEST01',
]);

return $response->redirect();
```

#### 2.2 Payment Verification Example

[](#22-payment-verification-example)

```
$response = $khalti->verify([
    'pidx' => 'your-payment-index',
]);

if ($response->isSuccess()) {
    echo 'Payment Successful';
} else {
    echo 'Payment Failed';
}
```

Learn More at [Khalti Payment Gateway Docs](Khalti.md)

### 3) ConnectIps Payment Gateway

[](#3-connectips-payment-gateway)

#### 3.1 Payment Example

[](#31-payment-example)

```
use \Kbk\NepaliPaymentGateway\Epay\ConnectIps;

$connectIps = new ConnectIps([
    'base_url' => 'https://uat.connectips.com',
    'merchant_id' => 'your-merchant-id',
    'app_id' => 'your-app-id',
    'app_name' => 'your-app-name',
    'private_key_path' => 'your-private-key',
    'password' => 'your-password',
]);

$response = $connectIps->payment([
    'remarks' => 'your-remarks',
    'particulars' => 'your-particulars',
    'reference_id' => 'your-reference-id',
]);

return $response->redirect();
```

#### 3.2 Payment Verification Example

[](#32-payment-verification-example)

```
$response = $connectIps->verify([
    'reference_id' => 'your-reference-id',
    'transaction_amount' => 100, // in Rs.
]);

if ($response->isSuccess()) {
    echo 'Payment Successful';
} else {
    echo 'Payment Failed';
}
```

Learn More at [ConnectIps Payment Gateway Docs](ConnectIps.md)

---

Contribution
------------

[](#contribution)

The contributions of the Open Source community are highly valued and appreciated. To ensure a smooth and efficient process, please adhere to the following guidelines when submitting code:

- Ensure that the code adheres to [PER Coding Style 3.0](https://www.php-fig.org/per/coding-style/) standards.
- All submitted code must pass relevant tests.
- Proper documentation and clean code practices are essential.
- Please make pull requests to the `main` branch.
- Thank you for your support and contributions. Looking forward to reviewing your code.

###  Health Score

39

—

LowBetter than 84% of packages

Maintenance73

Regular maintenance activity

Popularity14

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity50

Maturing project, gaining track record

 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.

###  Release Activity

Cadence

Every ~1 days

Total

10

Last Release

183d ago

Major Versions

v0.1.6 → v1.0.02025-12-31

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/84025233?v=4)[Aryan Malla](/maintainers/aryanmalla19)[@aryanmalla19](https://github.com/aryanmalla19)

---

Top Contributors

[![aryanmalla19](https://avatars.githubusercontent.com/u/84025233?v=4)](https://github.com/aryanmalla19 "aryanmalla19 (97 commits)")

---

Tags

phpapipaymentgatewaykhaltiesewanepalConnectIps

###  Code Quality

TestsPHPUnit

Code StylePHP CS Fixer

### Embed Badge

![Health badge](/badges/kbk-nepali-payment-gateway/health.svg)

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

###  Alternatives

[checkout/checkout-sdk-php

Checkout.com SDK for PHP

563.6M13](/packages/checkout-checkout-sdk-php)

PHPackages © 2026

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