PHPackages codepreneur/halk-pay - 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. codepreneur/halk-pay ActiveLibrary codepreneur/halk-pay ==================== Laravel package for HalkPay 3D Hosted gateway integration v1.4(1mo ago)05MITPHPPHP ^8.2CI passing Since Mar 16Pushed 1mo agoCompare [ Source](https://github.com/kodpreneur-dooel/halk-pay)[ Packagist](https://packagist.org/packages/codepreneur/halk-pay)[ RSS](/packages/codepreneur-halk-pay/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (5)Dependencies (9)Versions (10)Used By (0) Codepreneur HalkPay Package =========================== [](#codepreneur-halkpay-package) Reusable Laravel package for HalkPay 3D Hosted gateway integrations. Installation ------------ [](#installation) ``` composer require codepreneur/halk-pay ``` > Supports Laravel 11/12 and PHP 8.2+. Package development structure ----------------------------- [](#package-development-structure) This package now follows the standard Spatie Laravel package skeleton conventions: - Service provider built on `spatie/laravel-package-tools` - Test suite powered by Pest + Orchestra Testbench - CI workflow matrix for PHP/Laravel combinations - Static analysis (`phpstan`) and formatting (`pint`) scripts Run local quality checks: ``` composer test composer analyse composer format ``` Setup (works in any Laravel project) ------------------------------------ [](#setup-works-in-any-laravel-project) ### 1) Publish package config [](#1-publish-package-config) ``` php artisan vendor:publish --tag=halkpay-config ``` ### 2) Configure `.env` [](#2-configure-env) ``` HALKPAY_CLIENT_ID= HALKPAY_STORE_KEY= HALKPAY_STORE_TYPE=3D_PAY_HOSTING HALKPAY_CURRENCY=807 HALKPAY_TRANSACTION_TYPE=Auth HALKPAY_LANG=mk HALKPAY_SUCCESS_URL=https://your-app.test/payments/success HALKPAY_FAIL_URL=https://your-app.test/payments/fail HALKPAY_GATEWAY_URL=https://torus-stage-halkbankmacedonia.asseco-see.com.tr/fim/est3Dgate # Optional callback response behavior HALKPAY_CALLBACK_RESPONSE_MODE=json HALKPAY_CALLBACK_SUCCESS_REDIRECT_TO=/ HALKPAY_CALLBACK_FAIL_REDIRECT_TO=/ HALKPAY_CALLBACK_SUCCESS_VIEW=halkpay::payments.success HALKPAY_CALLBACK_FAIL_VIEW=halkpay::payments.fail ``` ### 3) Use package routes (or customize) [](#3-use-package-routes-or-customize) Default package routes: - `POST /halkpay/redirect` (`halkpay.redirect`) - `POST /halkpay/callback` (`halkpay.callback`) You can customize route enable/prefix/middleware/name prefix in `config/halkpay.php`. ### 4) Send a redirect request [](#4-send-a-redirect-request) Call the redirect route with at least `amount`. Typical payload fields: - `amount` (required) - `oid` (optional; generated when omitted) - `customer_name` / `bill_to_name` - `success_url`, `fail_url`, `callback_url` - `installment`, `transaction_type`, `currency`, `lang` Can success/fail Blade templates be extended? --------------------------------------------- [](#can-successfail-blade-templates-be-extended) Yes. ### Option A: Override package views in your project (recommended) [](#option-a-override-package-views-in-your-project-recommended) Publish views: ``` php artisan vendor:publish --tag=halkpay-views ``` Then edit: - `resources/views/vendor/halkpay/payments/success.blade.php` - `resources/views/vendor/halkpay/payments/fail.blade.php` - `resources/views/vendor/halkpay/payments/redirect.blade.php` Laravel will automatically prefer your published versions. ### Option B: Point callback to your own view names [](#option-b-point-callback-to-your-own-view-names) Set in `.env` (or directly in `config/halkpay.php`): ``` HALKPAY_CALLBACK_RESPONSE_MODE=view HALKPAY_CALLBACK_SUCCESS_VIEW=payments.gateway-success HALKPAY_CALLBACK_FAIL_VIEW=payments.gateway-fail ``` This lets callback responses render any Blade view in your app. Callback handling and security ------------------------------ [](#callback-handling-and-security) - Callback hash validation is built in (`HASHPARAMS`, `HASHPARAMSVAL`, `HASH` + `store_key`) - Middleware alias: `halkpay.hash` - Callback `response_mode` supports: - `json` - `redirect` - `view` Universal integration points ---------------------------- [](#universal-integration-points) Bind contracts only when you need domain-specific behavior. ``` use Codepreneur\HalkPayGateway\Contracts\TransactionReferenceResolver; use Codepreneur\HalkPayGateway\Contracts\CallbackProcessor; $this->app->bind(TransactionReferenceResolver::class, YourOidResolver::class); $this->app->bind(CallbackProcessor::class, YourCallbackProcessor::class); ``` If you do not bind them, package defaults are safe no-ops. Events ------ [](#events) - `Codepreneur\HalkPayGateway\Events\HalkPayCallbackReceived` ### Health Score 42 — FairBetter than 89% of packages Maintenance96 Actively maintained with recent releases Popularity5 Limited adoption so far Community6 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 5 Last Release 52d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/e0a86c135d6db93f47a4eef421bc638f33308761a872fc9f8bf789883ecd4441?d=identicon)[kodpreneur-dooel](/maintainers/kodpreneur-dooel) --- Top Contributors [![danielveselinov](https://avatars.githubusercontent.com/u/87199149?v=4)](https://github.com/danielveselinov "danielveselinov (17 commits)") ### Code Quality TestsPest Static AnalysisPHPStan Code StyleLaravel Pint Type Coverage Yes ### Embed Badge ![Health badge](/badges/codepreneur-halk-pay/health.svg) ``` [![Health](https://phpackages.com/badges/codepreneur-halk-pay/health.svg)](https://phpackages.com/packages/codepreneur-halk-pay) ``` ### Alternatives [spatie/laravel-query-builder Easily build Eloquent queries from API requests 4.4k26.9M219](/packages/spatie-laravel-query-builder)[spatie/laravel-honeypot Preventing spam submitted through forms 1.6k6.0M60](/packages/spatie-laravel-honeypot)[intervention/image-laravel Laravel Integration of Intervention Image 1496.5M100](/packages/intervention-image-laravel)[api-platform/laravel API Platform support for Laravel 59126.4k5](/packages/api-platform-laravel)[konekt/html HTML and Form Builders for the Laravel Framework 24403.2k5](/packages/konekt-html)[dragon-code/laravel-http-logger Logging incoming HTTP requests 319.8k3](/packages/dragon-code-laravel-http-logger) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)