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

ActivePackage[Payment Processing](/categories/payments)

kalimeromk/halkbank-payment
===========================

A Laravel package for handling HalkBank payments.

v1.4.1(2y ago)15282MITPHPPHP ^7.4|^8.0

Since Nov 15Pushed 1y ago1 watchersCompare

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

READMEChangelog (6)DependenciesVersions (7)Used By (0)

Halkbank Payment Gateway for Laravel
====================================

[](#halkbank-payment-gateway-for-laravel)

[![Halk logo](https://camo.githubusercontent.com/ed4ec2740e97b6fb01a036b2e0f871661b34dbb6890be1e6a3e5bccf5672040f/68747470733a2f2f75706c6f61642e77696b696d656469612e6f72672f77696b6970656469612f636f6d6d6f6e732f7468756d622f332f33392f48616c6b62616e6b5f6c6f676f2e7376672f3235363070782d48616c6b62616e6b5f6c6f676f2e7376672e706e67)](https://camo.githubusercontent.com/ed4ec2740e97b6fb01a036b2e0f871661b34dbb6890be1e6a3e5bccf5672040f/68747470733a2f2f75706c6f61642e77696b696d656469612e6f72672f77696b6970656469612f636f6d6d6f6e732f7468756d622f332f33392f48616c6b62616e6b5f6c6f676f2e7376672f3235363070782d48616c6b62616e6b5f6c6f676f2e7376672e706e67)

Integrate Halkbank's online payment gateway seamlessly into your Laravel application with this dedicated package. Designed specifically for Macedonian businesses, this package provides an easy-to-use interface for integrating Halkbank payment services.

Credits
-------

[](#credits)

This package was created by KalimeroMK.

License
-------

[](#license)

This package is open-sourced software licensed under the [MIT license](https://opensource.org/licenses/MIT).

Prerequisites
-------------

[](#prerequisites)

Before you begin, ensure you have the following:

- PHP >= 7.4

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

[](#installation)

Follow these steps to install the package:

**Install via Composer**Run the following command to install the package:

```
composer require kalimeromk/halkbank-payment

```

Publish Configurations and Views
--------------------------------

[](#publish-configurations-and-views)

```
php artisan vendor:publish --provider="Kalimeromk\HalkbankPayment\HalkBankPaymentServiceProvider"

```

Middleware
----------

[](#middleware)

Pls register CsrfExemptMiddleware in the Kernel of laravel app

Configure the Package
---------------------

[](#configure-the-package)

Edit the published config/payment.php with your Halkbank credentials and settings. Usage

Routes
------

[](#routes)

```
Route::prefix('payment')->group(function () {
    Route::get('/{amount}', [PaymentController::class, 'showPaymentForm'])->name('payment.form');
    Route::post('/', [PaymentController::class, 'showPaymentForm'])->name('payment.post');
    Route::get('success', [PaymentController::class, 'paymentSuccess'])->name('payment.success')->middleware('csrf_exempt');
    Route::get('fail', [PaymentController::class, 'paymentFail'])->name('payment.fail')->middleware('csrf_exempt');
});

```

Customization
-------------

[](#customization)

Views:
------

[](#views)

Customize the payment form in resources/views/vendor/payment.

Controller:
-----------

[](#controller)

Extend PaymentController to modify or add new payment processing logic.

Routes:
-------

[](#routes-1)

Add new routes in your Laravel application as needed.

Halkbank Payment Gateway Configuration .env
-------------------------------------------

[](#halkbank-payment-gateway-configuration-env)

```
PAYMENT_CLIENT_ID=
PAYMENT_STORE_KEY=
PAYMENT_STORE_TYPE=
PAYMENT_CURRENCY=807
PAYMENT_TRANSACTION_TYPE=Auth
PAYMENT_OK_URL=http://localhost:87/payment-success
PAYMENT_FAIL_URL=http://localhost:87/payment-fail
PAYMENT_LANG=en
PAYMENT_LAYOUT=

```

Fail url
--------

[](#fail-url)

Fail url returns post form with this array

```
[
    'ReturnOid' => '',
    'TRANID' => '',
    'PAResSyntaxOK' => '',
    'islemtipi' => '',
    'refreshtime' => '',
    'lang' => '',
    'merchantID' => '',
    'maskedCreditCard' => '',
    'amount' => '',
    'sID' => '',
    'RECEIVERPAN' => '',
    'ACQBIN' => '',
    'Ecom_Payment_Card_ExpDate_Year' => '',
    'MaskedPan' => '',
    'merchantName' => '',
    'clientIp' => '',
    '_token' => '',
    'iReqDetail' => '',
    'okUrl' => '',
    'md' => '',
    'ProcReturnCode' => '',
    'payResults_dsId' => '',
    'taksit' => '',
    'vendorCode' => '',
    'TransId' => '',
    'EXTRA_TRXDATE' => '',
    'Ecom_Payment_Card_ExpDate_Month' => '',
    'storetype' => '',
    'iReqCode' => '',
    'Response' => '',
    'SettleId' => '',
    'mdErrorMsg' => '',
    'ErrMsg' => '',
    'PAResVerified' => '',
    'cavv' => '',
    'digest' => '',
    'HostRefNum' => '',
    'callbackCall' => '',
    'AuthCode' => '',
    'failUrl' => '',
    'terms' => '',
    'cavvAlgorithm' => '',
    'xid' => '',
    'encoding' => '',
    'currency' => '',
    'oid' => '',
    'AcquirerAllowedFallback' => '',
    'mdStatus' => '',
    'dsId' => '',
    'eci' => '',
    'version' => '',
    'clientid' => '',
    'txstatus' => '',
    'HASH' => '',
    'rnd' => '',
    'HASHPARAMS' => '',
    'HASHPARAMSVAL' => '',
    'countdown' => ''
]

```

###  Health Score

28

—

LowBetter than 54% of packages

Maintenance26

Infrequent updates — may be unmaintained

Popularity16

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity52

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

Total

6

Last Release

907d ago

PHP version history (2 changes)v1PHP ^7.2|^8.0

v1.2PHP ^7.4|^8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/472c4da0220f15747dd81d3a27ffbba022a06ab20f64a367ddcaacd790d812d7?d=identicon)[KalimeroMK](/maintainers/KalimeroMK)

---

Top Contributors

[![KalimeroMK](https://avatars.githubusercontent.com/u/24772657?v=4)](https://github.com/KalimeroMK "KalimeroMK (2 commits)")

---

Tags

halk-banklaravelpackagepaymentpayment-gatewaylaravel

### Embed Badge

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

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

###  Alternatives

[anandsiddharth/laravel-paytm-wallet

Integrate paytm wallet easily with this package. This package uses official Paytm PHP SDK's

104421.1k7](/packages/anandsiddharth-laravel-paytm-wallet)[dena-a/iran-payment

a Laravel package to handle Internet Payment Gateways for Iran Banking System

312.4k1](/packages/dena-a-iran-payment)[threesquared/laravel-paymill

Laravel wrapper for the Paymill API

121.3k](/packages/threesquared-laravel-paymill)

PHPackages © 2026

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