Download the PHP package klc/tami-laravel without Composer
On this page you can find all versions of the php package klc/tami-laravel. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download klc/tami-laravel
More information about klc/tami-laravel
Files in klc/tami-laravel
Package tami-laravel
Short Description Tami sanal POS için Laravel-native paket — tip-güvenli, test edilebilir, güvenli
License MIT
Informations about the package tami-laravel
Tami Laravel
Tami sanal POS için Laravel-native paket. Tip-güvenli, test edilebilir, güvenli.
Kurulum
Laravel 10.x+ ve PHP 8.1+ gerektirir. Paket auto-discovery ile otomatik yüklenir.
Konfigürasyon
.env dosyasına aşağıdaki değişkenleri ekleyin:
Canlı ortam için:
Kullanım
Ödeme (Payment)
3D Secure Ödeme
3DS Callback Yönetimi
Paket otomatik olarak POST /tami/callback ve GET /tami/callback route'larını kaydeder. Callback payload'ında hashedData varsa paket Tami'nin 3DS HMAC-SHA256 formülüne göre doğrular; doğrulama başarısızsa /payment/complete-3ds çağrısı yapılmadan hata event'i yayınlanır. Başarılı/başarısız durumlar için event dinleyicileri:
Ön Otorizasyon (Pre-Auth)
İptal / İade
Sipariş Sorgulama
Taksit ve Kart Bilgisi
Bonus / Puan Sorgulama
Puanlı Satış
Ortak Ödeme Sayfası (Hosted Payment)
Tami'nin sunduğu ortak ödeme sayfası entegrasyonu — işyerinin kart bilgisi toplamasına gerek kalmadan, ödeme sayfası Tami tarafından sunulur. Masterpass ile kayıtlı kartlarla veya yeni kart bilgisiyle ödeme yapılabilir.
Token geçerlilik süresi: Test ortamında 15 dakika, prod ortamda 6 dakika. Token alınır alınmaz kullanıcı sayfaya yönlendirilmelidir.
Callback yönetimi: Başarılı ödemede Tami, successCallbackUrl'e yönlendirme yapar. Callback verisi taşımadığı için işlem durumunu Query servisi ile sorgulayın:
Not: failCallbackUrl şu an için Tami tarafından kullanılmamaktadır, successCallbackUrl ile aynı değer verilebilir. Hata durumunda kullanıcıya Tami sayfasında hata mesajı gösterilir.
Hata Yönetimi
Route Konfigürasyonu
Güvenlik Notları
Paket, Tami'ye gönderilen request body için securityHash değerini Tami PHP örneğiyle uyumlu JWK/HS512 JWT algoritmasıyla üretir. securityHash, request body'ye eklenmeden önceki JSON üzerinden hesaplanır.
Normal API response'larında dönen securityHash için Tami PHP örneklerinde doğrulama algoritması bulunmadığı için bu paket o alanı yanlış algoritmayla doğrulamaya çalışmaz. TAMI_RESPONSE_HASH_ENABLED=true yapılırsa paket fail-closed davranır ve TamiSecurityException fırlatır. Bu ayarı ancak normal API response hash algoritması netleşip pakette ayrıca implemente edildikten sonra açın.
3DS callback payload'ında hashedData varsa paket bu değeri secretKey ile HMAC-SHA256 kullanarak doğrular. Callback payload'ına güvenip siparişi doğrudan tamamlamayın; paket callback sonrası server-to-server /payment/complete-3ds çağrısı yapar.
Test
3DS Callback ve CSRF
3DS callback route'u varsayılan olarak api middleware ile kaydedilir — banka callback'i
CSRF token taşımadığı için web middleware altında 419 hatası alabilir.
Eğer web middleware kullanmak isterseniz VerifyCsrfToken middleware'ine
tami/callback yolunu ekleyin:
Lisans
MIT
All versions of tami-laravel with dependencies
illuminate/support Version >=10.0
illuminate/http Version >=10.0
illuminate/validation Version >=10.0
illuminate/events Version >=10.0
illuminate/contracts Version >=10.0
illuminate/routing Version >=10.0
illuminate/queue Version >=10.0