PHPackages                             class-atlas/laravel-keepz-ecommerce - 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. class-atlas/laravel-keepz-ecommerce

ActiveLibrary[Payment Processing](/categories/payments)

class-atlas/laravel-keepz-ecommerce
===================================

Laravel package for seamless payment gateway via Keepz ecommerce API

1.0.0(10mo ago)402[1 issues](https://github.com/ClassAtlas/laravel-keepz-ecommerce/issues)MITPHPPHP ^8.2

Since Jun 26Pushed 4mo ago1 watchersCompare

[ Source](https://github.com/ClassAtlas/laravel-keepz-ecommerce)[ Packagist](https://packagist.org/packages/class-atlas/laravel-keepz-ecommerce)[ RSS](/packages/class-atlas-laravel-keepz-ecommerce/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (1)Dependencies (15)Versions (2)Used By (0)

📦 Laravel KeepzEcommerce Integration
====================================

[](#-laravel-keepzecommerce-integration)

[![Latest Version on Packagist](https://camo.githubusercontent.com/c09ea2484b6b977aec8b7c110353cad6dbf80c297dac6140872e2ee19be6e1cd/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f636c6173732d61746c61732f6c61726176656c2d6b6565707a2d65636f6d6d657263652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/class-atlas/laravel-keepz-ecommerce)[![Total Downloads](https://camo.githubusercontent.com/4e5286bfd0a592efb950a4037b551377376a80000cd53c87dabb4d8d751887b7/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f636c6173732d61746c61732f6c61726176656c2d6b6565707a2d65636f6d6d657263652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/class-atlas/laravel-keepz-ecommerce)

This Laravel package provides seamless integration with [Keepz](https://keepz.me)'s eCommerce [API](https://www.developers.keepz.me/category/ecommerce--pay-via-keepz) — allowing your application to create, monitor, and manage online orders with ease.

Whether you're creating new orders, tracking their statuses, or canceling them — this package simplifies the interaction with Keepz's API using elegant PHP DTOs and Laravel-style conventions.

---

📌 Features
----------

[](#-features)

- 🛒 Create Orders
- 🔍 Check Order Status
- ❌ Cancel Orders

---

🧱 Installation
--------------

[](#-installation)

Install the package via Composer:

```
composer require class-atlas/laravel-keepz-ecommerce
```

---

⚙️ Configuration
----------------

[](#️-configuration)

Add the following to your `.env` file:

```
KEEPZ_ECOMMERCE_PRIVKEY=
KEEPZ_ECOMMERCE_PUBKEY=
KEEPZ_ECOMMERCE_API_URL=https://gateway.keepz.me/ecommerce-service
KEEPZ_ECOMMERCE_INTEGRATOR_ID=
```

ℹ️ Note: Public and private key files must be placed under the storage directory. For example:

- storage/keepz/privkey
- storage/keepz/pubkey

The values in your .env file should be relative paths from the storage folder, not full system paths.

- keepz/privkey
- keepz/pubkey

🛒 Create Order
--------------

[](#-create-order)

Use the `createOrder` method to create a new order with Keepz:

```
    $uuid = Str::uuid();

    $orderData = OrderData::from([
        'receiverId' => $merchant->keepz_id,
        'integratorOrderId' => $uuid,
        'successRedirectUri' => route('order.success'),
        'failRedirectUri' => route('order.error'),
        'amount' => $amount,
    ]);

    $orderData = KeepzEcommerce::createOrder($orderData);

    if ($orderData instanceof ErrorData) {
        if (app()->environment('production')) {
            abort(500);
        } else {
            return $orderData;
        }
    }

    return redirect()->away($orderData->urlForQR);
```

Returns either:

- `CreateOrderData` on success
- `ErrorData` on failure (includes error code and message)

---

🔍 Check Order Status
--------------------

[](#-check-order-status)

Use `checkOrderStatus` to retrieve the latest status of a specific order:

```
KeepzEcommerce::checkOrderStatus($uuid);
```

Returns either:

- `CheckOrderStatusData` (includes status, timestamps, etc.)
- `ErrorData` (if order not found or request fails)

---

❌ Cancel Order
--------------

[](#-cancel-order)

Use `cancelOrder` to cancel an existing order via its `integratorOrderId`:

```
KeepzEcommerce::cancelOrder($uuid);
```

Returns:

- `CancelOrderData` (contains confirmation and status)

---

🧱 Data Transfer Objects
-----------------------

[](#-data-transfer-objects)

Each API response is automatically converted into a strict typed DTO (Data Transfer Object), making it easy to work with structured responses in a Laravel-ish way.

- ✅ No need to parse JSON manually
- ✅ IntelliSense &amp; static analysis friendly

---

###  Health Score

33

—

LowBetter than 75% of packages

Maintenance60

Regular maintenance activity

Popularity6

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity49

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 66.7% 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

Unknown

Total

1

Last Release

321d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/662517d7046f333d56b6a4c15f83f12024cffa82864638fa8651919b772aef16?d=identicon)[kirkita](/maintainers/kirkita)

---

Top Contributors

[![kirkita](https://avatars.githubusercontent.com/u/554355?v=4)](https://github.com/kirkita "kirkita (2 commits)")[![nnnnnnnngu](https://avatars.githubusercontent.com/u/17468622?v=4)](https://github.com/nnnnnnnngu "nnnnnnnngu (1 commits)")

---

Tags

laravelpaymentskeepzeccomerce

###  Code Quality

TestsPest

Static AnalysisPHPStan

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/class-atlas-laravel-keepz-ecommerce/health.svg)

```
[![Health](https://phpackages.com/badges/class-atlas-laravel-keepz-ecommerce/health.svg)](https://phpackages.com/packages/class-atlas-laravel-keepz-ecommerce)
```

###  Alternatives

[danestves/laravel-polar

A package to easily integrate your Laravel application with Polar.sh

7812.3k](/packages/danestves-laravel-polar)[musahmusah/laravel-multipayment-gateways

A Laravel Package that makes implementation of multiple payment Gateways endpoints and webhooks seamless

852.2k1](/packages/musahmusah-laravel-multipayment-gateways)[creagia/laravel-redsys

Laravel Redsys Payments Gateway

2013.6k](/packages/creagia-laravel-redsys)[basillangevin/laravel-data-json-schemas

Transforms Spatie Data objects into JSON Schemas with built-in validation

1312.2k1](/packages/basillangevin-laravel-data-json-schemas)

PHPackages © 2026

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