PHPackages                             karadzinov/halkbank - 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. karadzinov/halkbank

ActiveLibrary[Payment Processing](/categories/payments)

karadzinov/halkbank
===================

Laravel package for Halkbank (NestPay/Payten) ver3 3D Pay Hosting integration

v0.2.2(9mo ago)02MITPHPPHP >=8.1

Since Sep 16Pushed 9mo agoCompare

[ Source](https://github.com/karadzinov/halkbank)[ Packagist](https://packagist.org/packages/karadzinov/halkbank)[ RSS](/packages/karadzinov-halkbank/feed)WikiDiscussions main Synced today

READMEChangelogDependenciesVersions (5)Used By (0)

Halkbank (NestPay) Laravel (ver3)
=================================

[](#halkbank-nestpay-laravel-ver3)

Laravel helper for NestPay/Payten 3D Pay Hosting with Hash Version 3.

Packagist:

Install
-------

[](#install)

```
composer require karadzinov/halkbank
php artisan vendor:publish --tag=nestpay-config
```

Usage
-----

[](#usage)

```
use Nestpay\Laravel\Facades\Nestpay;

$params = [
  'clientid' => config('nestpay.client_id'),
  'amount' => '10.00',
  'oid' => 'OID'.time(),
  'okurl' => route('nestpay.ok'),
  'failUrl' => route('nestpay.fail'),
  'TranType' => 'Auth',
  'Instalment' => '',
  'currency' => config('nestpay.currency'),
  'rnd' => microtime(true),
  'storetype' => config('nestpay.store_type'),
  'hashAlgorithm' => 'ver3',
  'lang' => 'en',
];

$hash = Nestpay::buildRequestHash($params);
$fields = array_merge($params, ['HASH' => $hash]);
return view('nestpay::redirect', [
  'action' => Nestpay::threeDPostUrl(),
  'fields' => $fields,
]);
```

### Verify response

[](#verify-response)

```
if (!Nestpay::verifyResponseHash(request()->post())) {
    abort(400, 'Invalid HASH');
}
```

### Order inquiry

[](#order-inquiry)

```
$result = Nestpay::orderInquiry($orderId);
```

Configure credentials in `config/nestpay.php` or via `.env`.

Required .env variables
-----------------------

[](#required-env-variables)

```
NESTPAY_CLIENT_ID=your_client_id
NESTPAY_STORE_KEY=your_store_key
NESTPAY_STORE_TYPE=3D_PAY_HOSTING
NESTPAY_CURRENCY=807
NESTPAY_LANG=en
NESTPAY_3D_POST_URL=https://your-bank-domain/fim/est3Dgate
NESTPAY_API_POST_URL=https://your-bank-domain/fim/api
NESTPAY_API_USERNAME=your_api_username
NESTPAY_API_PASSWORD=your_api_password

# Optional helpers for local dev behind a tunnel
# Set to your public https base (e.g., ngrok/Cloudflare Tunnel)
PUBLIC_BASE_URL=https://your-public-https-url
FORCE_HTTPS=true
```

The `PUBLIC_BASE_URL` ensures callback URLs (`okurl`/`failUrl`) are generated using your public HTTPS domain during development.

###  Health Score

26

—

LowBetter than 41% of packages

Maintenance56

Moderate activity, may be stable

Popularity2

Limited adoption so far

Community2

Small or concentrated contributor base

Maturity38

Early-stage or recently created project

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 ~0 days

Total

4

Last Release

291d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/7139106?v=4)[Martin Karadzinov](/maintainers/karadzinov)[@karadzinov](https://github.com/karadzinov)

### Embed Badge

![Health badge](/badges/karadzinov-halkbank/health.svg)

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

###  Alternatives

[omnipay/coinbase

Coinbase driver for the Omnipay payment processing library

18579.5k1](/packages/omnipay-coinbase)[msilabs/bkash

bKash Payment Gateway API for Laravel Framework.

181.2k](/packages/msilabs-bkash)[binkode/laravel-paystack

A description for laravel-paystack.

112.1k](/packages/binkode-laravel-paystack)

PHPackages © 2026

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