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(7mo ago)02MITPHPPHP >=8.1

Since Sep 16Pushed 7mo agoCompare

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

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

28

—

LowBetter than 54% of packages

Maintenance62

Regular maintenance activity

Popularity2

Limited adoption so far

Community2

Small or concentrated contributor base

Maturity37

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

238d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/b1df4c326f667674059508c1a8b1e21d2ee5a31dc3c5a8635e386d5f6faa2c92?d=identicon)[karadzinov](/maintainers/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/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)