PHPackages                             kodbee/jomabee-php - 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. kodbee/jomabee-php

ActiveLibrary[Payment Processing](/categories/payments)

kodbee/jomabee-php
==================

Official PHP client for the Jomabee payment API by Kodbee — create payments, verify transactions, check status/balance and validate webhooks.

v1.0.0(today)001MITPHPPHP >=8.1

Since Jun 19Pushed todayCompare

[ Source](https://github.com/kodbeedev/jomabee-php)[ Packagist](https://packagist.org/packages/kodbee/jomabee-php)[ Docs](https://kodbee.com)[ RSS](/packages/kodbee-jomabee-php/feed)WikiDiscussions main Synced today

READMEChangelogDependencies (1)Versions (2)Used By (1)

Jomabee PHP
===========

[](#jomabee-php)

Official PHP client for the [Jomabee](https://kodbee.com) payment API by **Kodbee**. Zero dependencies (just cURL + JSON) — works in any PHP 8.1+ project.

- Create payments and get a hosted payment URL + QR
- Verify transactions by TrxID
- Check invoice status, list transactions, read balance
- Validate incoming webhooks (HMAC-SHA256)

Install
-------

[](#install)

```
composer require kodbee/jomabee-php
```

Quick start
-----------

[](#quick-start)

```
use Kodbee\Jomabee\Jomabee;

$jomabee = new Jomabee(
    apiKey: 'your_api_key',
    secretKey: 'your_secret_key',      // required for create/verify
    baseUrl: 'https://pay.kodbee.com'  // your Jomabee instance
);

// Create a payment
$payment = $jomabee->createPayment([
    'amount' => 500,
    'product_name' => 'Premium Plan',
    'customer_name' => 'Karim Mia',
    'customer_email' => 'karim@example.com',
    'redirect_url' => 'https://yoursite.com/thank-you',
    'callback_url' => 'https://yoursite.com/webhooks/jomabee',
    // 'gateway' => 'bkash',          // optional: lock to one gateway
    // 'expiry_minutes' => 30,
]);

header('Location: ' . $payment['payment_url']); // send customer to pay
```

Verify & status
-------------------

[](#verify--status)

```
// Verify a payment with a customer-supplied TrxID
$result = $jomabee->verifyPayment('JOMB-XXXXXX', 'ABCDE12345', 'bkash');
// $result['status'] => verified | pending | failed | expired | duplicate

// Poll invoice status
$status = $jomabee->paymentStatus('JOMB-XXXXXX');

// List transactions
$txns = $jomabee->transactions(['status' => 'verified', 'per_page' => 50]);

// Balance
$balance = $jomabee->balance(); // ['currency' => 'BDT', 'verified_total' => ..., 'available' => ...]
```

Webhooks
--------

[](#webhooks)

Jomabee signs the JSON payload with HMAC-SHA256 and sends the digest in the `X-Jomabee-Signature` header.

```
use Kodbee\Jomabee\Webhook;

try {
    $event = Webhook::verifyRequest('your_webhook_secret');
    // $event['event'] === 'payment.verified'
    // $event['invoice_id'], $event['trx_id'], $event['amount'], $event['gateway'] ...
} catch (\RuntimeException $e) {
    http_response_code(400);
    exit('Invalid signature');
}
```

You can also verify a raw body or decoded array directly:

```
Webhook::verify($rawJsonBody, $signature, $secret);   // returns payload, throws on failure
Webhook::isValid($payloadArray, $signature, $secret); // returns bool
```

Error handling
--------------

[](#error-handling)

```
use Kodbee\Jomabee\Exceptions\ApiException;
use Kodbee\Jomabee\Exceptions\NetworkException;
use Kodbee\Jomabee\Exceptions\ConfigurationException;

try {
    $jomabee->createPayment([...]);
} catch (ApiException $e) {
    echo $e->errorCode();   // e.g. invalid_api_key, not_found
    echo $e->statusCode();  // HTTP status
    echo $e->getMessage();
} catch (NetworkException $e) {
    // transport failure (timeout/DNS/TLS)
} catch (ConfigurationException $e) {
    // missing key/secret
}
```

All exceptions extend `Kodbee\Jomabee\Exceptions\JomabeeException`.

License
-------

[](#license)

MIT © [Kodbee](https://kodbee.com)

###  Health Score

38

—

LowBetter than 83% of packages

Maintenance100

Actively maintained with recent releases

Popularity0

Limited adoption so far

Community5

Small or concentrated contributor base

Maturity42

Maturing project, gaining track record

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

0d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/193194609?v=4)[Jahidul Islam](/maintainers/kodbeedev)[@kodbeedev](https://github.com/kodbeedev)

---

Tags

sdkpaymentrocketbkashnagadbangladeshupayjomabeekodbee

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/kodbee-jomabee-php/health.svg)

```
[![Health](https://phpackages.com/badges/kodbee-jomabee-php/health.svg)](https://phpackages.com/packages/kodbee-jomabee-php)
```

###  Alternatives

[yandex-money/yandex-money-sdk-php

Yandex.Money API SDK for PHP

105168.6k2](/packages/yandex-money-yandex-money-sdk-php)[cryptonator/merchant-php-sdk

Cryptonator.com Merchant API SDK for PHP

2714.2k](/packages/cryptonator-merchant-php-sdk)

PHPackages © 2026

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