Download the PHP package furkanmeclis/laravel-paytr without Composer
On this page you can find all versions of the php package furkanmeclis/laravel-paytr. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download furkanmeclis/laravel-paytr
More information about furkanmeclis/laravel-paytr
Files in furkanmeclis/laravel-paytr
Package laravel-paytr
Short Description Updated and Maintained Laravel Paytr Payment Gateway for Laravel 10, 11 & 12
License MIT
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package laravel-paytr
# Laravel Paytr (Güncel ve Kapsamlı Sürüm)
Bu paket, Paytr ödeme altyapısını modern Laravel (10, 11, 12+) projelerinize kolayca entegre edebilmeniz için geliştirilmiştir. past/paytr paketinin kod tabanı kullanılarak Furkan Meclis tarafından yeniden yapılandırılmış, güncellenmiş ve bakımı yapılmaktadır.
Paket, Paytr'ın Iframe API, Direct API ve Iframe Havale/EFT gibi tüm popüler ödeme yöntemlerini destekler.
İçindekiler
- Desteklenen Sürümler
- Kurulum
- Yapılandırma
- Yapılandırma Dosyasını Yayınlama
- Ortam Değişkenleri (.env)
- Temel Kullanım (
FurkanMeclis\Paytr\Payment)- Iframe API ile Ödeme Alma
- Direct API (Doğrudan Ödeme)
- Iframe Havale/EFT ile Ödeme
- Ödeme Bildirimlerini (Callback) Doğrulama
- Yöntem 1:
PaymentSınıfı ile Doğrulama (Önerilen) - Yöntem 2:
PaymentVerificationSınıfı ile Doğrulama
- Yöntem 1:
- Gelişmiş Kullanım ve İpuçları
- Taksit Seçenekleri
- Para Birimi (Currency) Değiştirme
- Paket Sınıflarına Genel Bakış
- Alternatif Kullanım (
Request\Payment)
Desteklenen Sürümler
- PHP:
^8.2 - Laravel:
^10.0,^11.0,^12.0
Kurulum
Composer kullanarak paketi projenize kolayca ekleyebilirsiniz:
Yapılandırma
Yapılandırma Dosyasını Yayınlama
Paketin yapılandırma dosyasını (paytr.php) kendi projenizin config dizinine kopyalamak için aşağıdaki Artisan komutunu çalıştırın. Bu, varsayılan ayarları değiştirmenize olanak tanır.
Ortam Değişkenleri (.env)
Yapılandırma dosyasını yayınladıktan sonra, .env dosyanıza aşağıdaki değişkenleri ekleyip kendi Paytr Mağaza bilgilerinizle doldurmanız gerekmektedir.
PAYTR_TEST_MODE:trueolarak ayarlandığında tüm işlemler test modunda çalışır. Canlıya geçerkenfalseyapmayı unutmayın.PAYTR_BASE_URI: Paytr API'sinin ana URL'sidir. Genellikle değiştirmeniz gerekmez.PAYTR_TIMEOUT: API istekleri için saniye cinsinden zaman aşımı süresi.
Temel Kullanım (FurkanMeclis\Paytr\Payment)
Bu sınıf, ödeme işlemleri oluşturmak için ana ve önerilen yöntemdir. Oldukça esnek ve zincirleme metot (fluent interface) kullanımını destekler.
1. Iframe API ile Ödeme Alma
Bu en yaygın yöntemdir. Kullanıcı, sitenizden ayrılmadan güvenli bir Paytr iframe'i içinde ödeme yapar.
2. Direct API (Doğrudan Ödeme)
Bu yöntemde, kullanıcı kredi kartı bilgilerini doğrudan sitenizdeki formlara girer. PCI-DSS sertifikası gerektirir!
3. Iframe Havale/EFT ile Ödeme
Ödeme Bildirimlerini (Callback) Doğrulama
Paytr, ödeme sonucu ne olursa olsun .env dosyanızda belirttiğiniz PAYTR_SUCCESS_URL veya PAYTR_FAIL_URL'e kullanıcıyı yönlendirir ve arka planda sunucunuza bir POST isteği gönderir. Gelen bu isteğin Paytr'dan geldiğini ve değiştirilmediğini doğrulamak zorunludur.
Aşağıda routes/web.php veya routes/api.php içinde bir callback rotası örneği bulunmaktadır.
Yöntem 1: Payment Sınıfı ile Doğrulama (Önerilen)
Bu yöntem, ana Payment sınıfının checkHash metodunu kullanır ve en basit yaklaşımdır.
Yöntem 2: PaymentVerification Sınıfı ile Doğrulama
Bu, paketin eski yapısından gelen alternatif bir doğrulama yöntemidir.
Gelişmiş Kullanım ve İpuçları
Taksit Seçenekleri
setInstallmentCount(int $count): Sadece Direct API için geçerlidir.1(tek çekim) veya2-12arası taksit sayısını belirtir.setNoInstallment(bool $status): Iframe API'de taksit seçeneklerini gizlemek içintrueyapın.setMaxInstallment(int $count): Iframe API'de gösterilecek maksimum taksit sayısını belirler (0hepsi demektir).
Para Birimi (Currency) Değiştirme
Varsayılan para birimi TL'dir. Desteklenen diğer para birimlerini Currency enum'ı ile ayarlayabilirsiniz.
Paket Sınıflarına Genel Bakış
FurkanMeclis\Paytr\Payment: Ana ödeme sınıfı.FurkanMeclis\Paytr\PaytrClient: API istekleri için temel Guzzle istemcisi.FurkanMeclis\Paytr\Request\Order: Sipariş detaylarını ve kullanıcı bilgilerini tutar.FurkanMeclis\Paytr\Request\Basket: Ürün listesini yönetir.FurkanMeclis\Paytr\Request\Product: Tek bir ürünün adını ve fiyatını tutar.FurkanMeclis\Paytr\Response\PaymentResponse: API'den dönen yanıtı (HTML veya JSON) yönetir.FurkanMeclis\Paytr\Enums\*:Currency,TransactionTypegibi sabit değerleri içeren Enum sınıfları.
Alternatif Kullanım (Request\Payment)
Paket, past/paytr'ın orijinal yapısını korumak amacıyla FurkanMeclis\Paytr\Request\Payment adında alternatif bir ödeme sınıfı daha içerir. Bu sınıfın kullanımı, ana Payment sınıfından farklıdır ve zincirleme metotları desteklemez.
Uyarı: Bu sınıf, ana
Paymentsınıfıyla benzer işlevlere sahip olduğu için kafa karıştırıcı olabilir. Genellikle anaPaymentsınıfını kullanmanız önerilir.
Örnek:
All versions of laravel-paytr with dependencies
guzzlehttp/guzzle Version ^7.0.1
illuminate/collections Version ^10.0|^11.0|^12.0
illuminate/http Version ^10.0|^11.0|^12.0
illuminate/support Version ^10.0|^11.0|^12.0