PHPackages tarfin-labs/laravel-pos - 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. [Utility & Helpers](/categories/utility) 4. / 5. tarfin-labs/laravel-pos ActiveLibrary[Utility & Helpers](/categories/utility) tarfin-labs/laravel-pos ======================= laravel pos package 76.4k3[1 issues](https://github.com/tarfin-labs/laravel-pos/issues)[1 PRs](https://github.com/tarfin-labs/laravel-pos/pulls)PHP Since Feb 8Pushed 2y ago4 watchersCompare [ Source](https://github.com/tarfin-labs/laravel-pos)[ Packagist](https://packagist.org/packages/tarfin-labs/laravel-pos)[ RSS](/packages/tarfin-labs-laravel-pos/feed)WikiDiscussions master Synced 3d ago READMEChangelogDependenciesVersions (2)Used By (0) Laravel Pos =========== [](#laravel-pos) [![Latest Version on Packagist](https://camo.githubusercontent.com/40c6d32f2ff1cf72eb8f3bd2a9c515bf8a8f6345ddf265e4e713e0626f378fb6/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f74617266696e2d6c6162732f6c61726176656c2d706f732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/tarfin-labs/laravel-pos)[![Build Status](https://camo.githubusercontent.com/fce888bfdc3e4bab53a8c160ada234de75f5532684d7c81ebca8acbf2f8b9374/68747470733a2f2f696d672e736869656c64732e696f2f7472617669732f74617266696e2d6c6162732f6c61726176656c2d706f732f6d61737465722e7376673f7374796c653d666c61742d737175617265)](https://travis-ci.org/tarfin-labs/laravel-pos)[![Quality Score](https://camo.githubusercontent.com/80e9aa7b87a817b50b12c046782c11033ed9838073845fc504a6792b102c7ae4/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f672f74617266696e2d6c6162732f6c61726176656c2d706f732e7376673f7374796c653d666c61742d737175617265)](https://scrutinizer-ci.com/g/tarfin-labs/laravel-pos)[![Total Downloads](https://camo.githubusercontent.com/55f77a95966c2bcc7a112d6c1b3681bbccd9dc8400f006a3e766c0db1bd3ca97/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f74617266696e2d6c6162732f6c61726176656c2d706f732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/tarfin-labs/laravel-pos) EST altyapısını kullanan bankalar için Laravel sanal pos entegrasyonu. Kurulum ------- [](#kurulum) laravel-pos paketini composer ile aşağıdaki komutu çalıştırarak kolayca ekleyebilirsiniz : ``` composer require tarfin-labs/laravel-pos ``` Sonrasında config dosyasını ve migrationları publish etmeniz gerekmektedir: ``` php artisan vendor:publish --provider="TarfinLabs\LaravelPos\LaravelPosServiceProvider" ``` Konfigürasyonu tamamlamak için kullanacağız bankalara ait gerekli bilgileri config dosyasında tanımlayıp `.env` dosyasına aşağıdaki şekilde ekleyebilirsiniz: ``` LARAVEL_POS_XXXXX_BASE_URL= LARAVEL_POS_XXXXX_MERCHANT_ID= LARAVEL_POS_XXXXX_STORE_KEY= LARAVEL_POS_XXXXX_BANK_NAME= ``` Varsayılan banka konfigürasyonu için aşağıdaki .env değişkenini tanımlamanız gerekmektedir. ``` LARAVEL_POS_DEFAULT_BANK=`BANK_CONFIG_KEY_IN_CONFIG_FILE` ``` ### Örnek Config [](#örnek-config) ``` return [ 'currency' => env('LARAVEL_POS_CURRENCY', 949), 'locale' => env('LARAVEL_POS_LOCALE','tr'), 'default_bank' => env('LARAVEL_POS_DEFAULT_BANK',''),//banks dizisindeki key 'bin_file_path' => env('LARAVEL_POS_BIN_FILE_PATH', 'resources/bin.json'), 'banks' => [ 'ZİRAAT BANKASI' => [ 'name' => env('LARAVEL_POS_ZIRAAT_BANK_NAME',''),//bin dosyasındaki banka adı 'base_url' => env('LARAVEL_POS_ZIRAAT_BASE_URL',''), 'merchant_id' => env('LARAVEL_POS_ZIRAAT_MERCHANT_ID', ''), 'store_key' => env('LARAVEL_POS_ZIRAAT_STORE_KEY', ''), ] ] ]; ``` \####Önemli bilgi banks -> ZİRAAT BANKASI -> name değerinin bin dosyasındaki banka ismiyle eşleşiyor olması gerekmektedir. Kullanım -------- [](#kullanım) ``` $card = new Card('Kart No', 'YY', 'MM', 'CV2', 'Kart Üzerindeki İsim'); $orderId = Str::random();//Benzersiz sipariş numarası $tutar = 20;//TL $taksit = 1; $order = new Order($orderId, $tutar, $taksit); $paymentBuilder = LaravelPos::builder(); $paymentBuilder->bank('ZİRAAT BANKASI') ->card($card) ->order($order) ->okUrl('http://odeme.siteadresi.com/ok') ->failUrl('http://odeme.siteadresi.com/fail') ``` Ek request bilgileri (müşteri id, email adresi vb.) için bir `Customer` nesnesi oluşturup `$paymentBuilder` nesnesine geçebilirsiniz. ``` new Customer([ 'id' => 1, 'email': 'foo@bar.com', 'foo': 'bar' ]); $paymentBuilder->customer($customer); ``` Oluşturduğunuz `Customer` nesnesindeki bilgiler ödeme alma işleminde gönderilen http isteğine eklenecektir. \##Ödeme alma ``` $paymentBuilder->charge(); ``` methodu ile ödeme işlemini başlatabilirsiniz. \###Ödeme sonucu Ödeme işlemi tamamlandığında veya iptal olduğunda ilgili banka `okUrl` ve `failUrl` parametrelerinde tanımlı adreslerden birisine işlemle ilgili post isteği gönderir. Ödeme işlemi ile ilgili sonucu kaydedebilmek için kullandığınız `User` modeline `Billable` trait'inin eklenmesi gereklidir. Trait eklendikten sonra; ``` $user = User::find(1); $user->handlePayment(request()->all()); ``` Şeklinde ödeme sonucu veritabanına kaydedilir. \###Ek bilgiler - LaravelPos paketiyle yalnızca 3d-pay methoduyla ödeme alınabilmektedir. - Bank() parametresi tanımlanmazsa İlgili banka, girilen kredi kartının ilk 6 hanesinden (Bin Number) tespit edilir. Bulunan banka config dosyasında tanımlanmışsa o banka için tanımlı olan ayarlar kullanılır. (Ödeme ilgili bankadan çekilir.) Aksi durumlarda varsayılan banka ayarları kullanılır. - Daha güncel bir BIN listesine sahipseniz BIN dosyası yolunu .env dosyanızdan değiştirebilirsiniz. (LARAVEL\_POS\_BIN\_FILE\_PATH) ### Test [](#test) ``` composer test ``` ### Changelog [](#changelog) Please see [CHANGELOG](CHANGELOG.md) for more information what has changed recently. Contributing ------------ [](#contributing) Please see [CONTRIBUTING](CONTRIBUTING.md) for details. ### Security [](#security) If you discover any security related issues, please email instead of using the issue tracker. Credits ------- [](#credits) - [Faruk Can](https://github.com/frkcn) - [Hakan Özdemir](https://github.com/hozdemir) - [All Contributors](../../contributors) License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. ### Health Score 23 — LowBetter than 27% of packages Maintenance17 Infrequent updates — may be unmaintained Popularity25 Limited adoption so far Community15 Small or concentrated contributor base Maturity29 Early-stage or recently created project Bus Factor1 Top contributor holds 55.2% 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. ### Community Maintainers ![](https://www.gravatar.com/avatar/e252316490c5fc7bae7eb25b6c0cb301b49fbc706c32896fea9467b64cf3653b?d=identicon)[Tarfin Labs](/maintainers/Tarfin%20Labs) --- Top Contributors [![frkcn](https://avatars.githubusercontent.com/u/374634?v=4)](https://github.com/frkcn "frkcn (16 commits)")[![hozdemir](https://avatars.githubusercontent.com/u/464927?v=4)](https://github.com/hozdemir "hozdemir (11 commits)")[![deligoez](https://avatars.githubusercontent.com/u/3030815?v=4)](https://github.com/deligoez "deligoez (1 commits)")[![tkaratug](https://avatars.githubusercontent.com/u/4394344?v=4)](https://github.com/tkaratug "tkaratug (1 commits)") ### Embed Badge ![Health badge](/badges/tarfin-labs-laravel-pos/health.svg) ``` [![Health](https://phpackages.com/badges/tarfin-labs-laravel-pos/health.svg)](https://phpackages.com/packages/tarfin-labs-laravel-pos) ``` ### Alternatives [richjenks/stats Statistics library for non-statistical people 23149.0k1](/packages/richjenks-stats)[withcandour/aardvark-seo Save time and get your Statamic site to rank better with the SEO addon for Statamic. 13128.3k](/packages/withcandour-aardvark-seo)[joelwmale/livewire-quill Easily add QuillJS with image support to any Laravel Livewire component. 1314.0k](/packages/joelwmale-livewire-quill) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)