Download the PHP package spiderwebtr/payment-kit without Composer
On this page you can find all versions of the php package spiderwebtr/payment-kit. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download spiderwebtr/payment-kit
More information about spiderwebtr/payment-kit
Files in spiderwebtr/payment-kit
Package payment-kit
Short Description Çok sağlayıcılı Laravel ödeme altyapısı + test panosu (3D Secure, kart saklama, taksit) — Horizon/Pulse tarzı.
License MIT
Homepage https://github.com/spiderwebtr/payment-kit
Informations about the package payment-kit
PaymentKit
Laravel için çok sağlayıcılı ödeme altyapısı. Sipay, Param/TurkPOS, iyzico, AHL Pay ve RubikPara'yı tek bir arayüz arkasında toplar; 3D Secure ödemeleri kendi sayfalarınızdan başlatabilir, ayrıca — Horizon/Pulse gibi ayrı bir panodan — test edip izleyebilirsiniz.
Gereksinimler
- PHP 8.3+
- Laravel 13+
- Livewire 3.5+
Kurulum
Yalnızca config ya da yalnızca migration için
--tag=payment-kit-config/--tag=payment-kit-migrationskullanabilirsiniz. Migration'lar yayınlanırken güncel timestamp alır (uygulama migration'larıyla doğru sırada çalışır).
Pano varsayılan olarak /payment-kit adresinde yayınlanır (config/payment-kit.php → path).
Kapatma
PAYMENT_KIT_ENABLED=false ile paketin tüm route'ları (pano, process, callback, logo)
tek anahtarla devre dışı bırakılabilir.
Erişim
- Yerel ortamda (
APP_ENV=local) panoya doğrudan girilir. - Diğer ortamlarda erişim, Laravel'in
viewPaymentKitgate'i ile kontrol edilir (Pulse'ınviewPulsedeseni).AppServiceProvider::boot()içinde tanımlayın:
Gate tanımlı değilse (yerel dışı) erişim reddedilir.
Sağlayıcı kimlik bilgileri
.env üzerinden verilir (ör. SIPAY_*, AHLPAY_*, RUBIKPARA_*...). Ayrıntı için
config/payment-kit.php dosyasındaki providers bölümüne bakın.
Kendi sayfanızdan kullanım
API + Next.js (headless) kuruyorsanız: adım adım entegrasyon için docs/headless-integration.md.
Pano dışında, kendi ödeme sayfanızdan (ör. bağış formu) da ödeme başlatabilirsiniz.
Formunuz kart alanlarını card_data[...] adlarıyla göndersin; 3DS sonrası kullanıcı
returnUrl ile verdiğiniz sayfaya döner:
returnUrl string|Closure|null kabul eder:
Closure, oluşturulan Payment ile çağrılır — ödeme createTransaction içinde
yaratıldığından, URL'i kurarken id/uuid'sine ancak bu sayede erişirsiniz (ör.
/thanks/42). Verilmezse kullanıcı paket işlem detayına döner.
Sonuç sayfanızda ödemeyi Payment modelinden okuyun (status, note, reference_id).
Ödeme sahibi (owner)
Ödemeyi herhangi bir modele bağlayabilirsiniz — polymorphic ve opsiyonel.
Sahip illa giriş yapmış bir kullanıcı olmak zorunda değil; giriş yapılmamış bir
ödeme bile bir Order'a (ya da Subscription, Invoice, Cart...) bağlanabilir:
Kayıtlı kartla ödemede sahip verilmezse otomatik olarak kartın sahibine düşer. Sorgulama:
Eventler
PaymentCompleted / PaymentCanceled / PaymentRefunded event'leri yayınlanır.
Laravel'in event auto-discovery'si (varsayılan açık) ile bir Listener'da handle()
parametresini type-hint etmeniz dinlemek için yeterlidir:
(Auto-discovery kapalıysa Event::listen(PaymentCompleted::class, ...) ile manuel kaydedin.)
Kart saklama (tokenization)
Kartın kendisi sağlayıcıda saklanır; veritabanında yalnızca sağlayıcı token'ı
(şifreli) ve kartı tanımaya yetecek maskeli bilgiler (bin + son 4, marka/tip) tutulur.
Her saklanan kartın bir sahibi (owner) zorunludur — User dahil herhangi bir
host modeli olabilir (polymorphic). Sahipsiz kart saklanamaz (panoda misafir
kullanıcı kart kaydedemez):
Sağlayıcının desteklemesi için handler'ı SupportsCardStorage arayüzünü uygulamalıdır
(şu an: RubikPara). Pano, destekleyen sağlayıcılarda "kartı kaydet" seçeneği ve
kayıtlı kart listesi sunar.
Yeni sağlayıcı ekleme
Tek bir handler class'ı + DB satırı + public/images/providers/{key} logosu yeterlidir.
Durum
PaymentKit yalnızca bir test panosu değil; aynı zamanda çok sağlayıcılı bir ödeme altyapısı / boilerplate sunar (kendi sayfalarınızdan gerçek 3DS ödemesi, kart saklama, taksit, event'ler). Ancak henüz stabil değildir — API'ler değişebilir.
⚠️ Bu sürüm production'da kullanılmamalıdır. Stabil bir sürüme kadar yalnızca test/geliştirme ortamlarında değerlendirin.
All versions of payment-kit with dependencies
illuminate/support Version ^13.0
illuminate/console Version ^13.0
illuminate/database Version ^13.0
livewire/livewire Version ^3.5