Download the PHP package emre-tarhan/kuveytturk-vpos-laravel-sdk without Composer
On this page you can find all versions of the php package emre-tarhan/kuveytturk-vpos-laravel-sdk. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download emre-tarhan/kuveytturk-vpos-laravel-sdk
More information about emre-tarhan/kuveytturk-vpos-laravel-sdk
Files in emre-tarhan/kuveytturk-vpos-laravel-sdk
Package kuveytturk-vpos-laravel-sdk
Short Description Kuveyt Türk Sanal Pos (Virtual POS) Laravel SDK with 3D Secure 2.0 support
License MIT
Homepage https://github.com/emre-tarhan/kuveytturk-vpos-laravel-sdk
Informations about the package kuveytturk-vpos-laravel-sdk
Kuveyt Turk Sanal POS Laravel SDK
Kuveyt Turk Sanal POS entegrasyonu icin kapsamli Laravel SDK. Tam 3D Secure 2.0 destegi.
Ozellikler
- 3D Secure 2.0 Tam Destek — Iki asamali odeme akisi
- Iki Asamali Odeme: Kart Dogrulama + Provizyon (Odeme Alma)
- Taksit Destegi — 24 aya kadar taksit imkani
- Ertelemeli Odeme (Harcama Oteleme) — Esnek odeme planlama
- Hash Veri Dogrulama — SHA1 tabanli istek dogrulama
- Test & Produksiyon Ortamlari — Ayri endpoint'ler
- Satis / Iptal / Iade / Kismi Iade Islemleri — Tam islem yasam dongusu
- WCF SOAP Servis Entegrasyonu — Iptal/iade islemleri icin
- Kapsamli Hata Yonetimi — Tum Kuveyt Turk hata kodlari
- Laravel 12.x & 13.x Uyumlu
- PHP 8.1, 8.2, 8.3, 8.4 Destegi
Gereksinimler
- PHP: 8.1, 8.2, 8.3 veya 8.4
- Laravel: 12.x veya 13.x
- PHP Eklentileri: curl, libxml, openssl
Kurulum
Ayarlari Yayinlama
Veya kurulum komutunu kullanin:
Bu islem ayar dosyasini config/kuveytturk-vpos.php konumuna yayinlayacaktir.
Yapilandirma
Kuveyt Turk kimlik bilgilerinizi .env dosyasina ekleyin:
Veya config/kuveytturk-vpos.php dosyasindan yapilandirin:
Kullanim
Temel Satis (Tam 3D Akis)
Iki Asamali Odeme (Manuel Kontrol)
Odeme akisi uzerinde daha fazla kontrole ihtiyaciniz varsa:
Asama 1: Kart Dogrulama
Asama 2: Provizyon (Odeme Tamamlama)
Islem Iptali (Ayni Gun)
Iade (Gun Sonu Sonrasi)
Kismi Iade
Gercek Entegrasyon Ornegi (3D Secure Akisi)
Asagida produksiyon ortaminda kullanilan, tam 3D Secure odeme akisi ornegi bulunmaktadir. Bu akis 5 asamadan olusur: odeme baslatma, bankaya yonlendirme, callback karsilama, provizyon tamamlama ve siparisi sonuclandirma.
Asama 1: Servis Konteynerine Kayit
Asama 2: Odeme Baslatma (Controller)
Kart dogrulama islemi bankadan HTML dondurur. Bu HTML'i tarayicida render etmeniz gerekir — otomatik olarak bankanin 3D Secure sayfasina yonlendiren bir form icerir.
Asama 3: 3D Secure Sayfasini Render Etme (Frontend)
Bankanin HTML'i otomatik gonderilen bir form icerir. Gizli bir div'de gosterip otomatik gonderin:
Asama 4: Banka Callback'inin Karsilanmasi (CSRF/Session Middleware Haric)
Onemli: Banka callback URL'lerinize cross-site POST gonderir. Bu route'lar middleware gruplarinin disinda olmalidir (CSRF ve session yok):
Asama 5: Provizyon (Odeme Tamamlama)
CSP Basliklari (Gerekli)
3D Secure yonlendirme formunun engellenmemesi icin Kuveyt Turk domainlerini Content Security Policy'nize ekleyin:
Yanit Nesneleri
SaleResponse
| Ozellik | Aciklama |
|---|---|
isSuccessful() |
Boolean — islem onaylandiysa true |
responseCode |
Kuveyt Turk yanit kodu ("00" = basarili) |
responseMessage |
Okunabilir yanit mesaji |
orderId |
Banka siparis numarasi |
provisionNumber |
Provizyon numarasi |
rrn |
Referans numarasi |
stan |
Sistem iz numarasi |
transactionTime |
Islem zaman damgasi |
merchantOrderId |
Sizin siparis numaraniz |
md |
3D Secure MD degeri |
Hata Yonetimi
Hata Kodlari
| Kod | Aciklama |
|---|---|
| 00 | Otorizasyon verildi / Islem basarili |
| 01 | Gecersiz kart numarasi |
| 05 | Yetersiz bakiye |
| 12 | Gecersiz uye isyeri |
| 14 | Gecersiz islem / CVV |
| 17 | Kart limiti asildi |
| 54 | Kart suresi dolmus |
| 59 | Sahtekarlik suphesi |
| 70 | Mukerrer siparis |
| 91 | Zaman asimi |
| 96 | Sistem hatasi |
| 99 | Hashdata uyusmazligi |
Tutar Formatı
Tum tutarlar gercek deger olarak belirtilmelidir (ornegin 100.50 = 100 TL 50 kurus).
SDK bankanin formatina otomatik donusturur (tutar x 100, ornegin 100.50 TL = 10050).
Test Ortami
Sandbox testleri icin asagidaki test kartini kullanin:
| Alan | Deger |
|---|---|
| Kart Numarasi | 5188 9619 3919 2544 |
| CVV | 929 |
| Son Kullanma | 06/25 |
| 3D Sifre | 123456 |
Test Endpoint'leri:
- Kart Dogrulama:
https://boatest.kuveytturk.com.tr/boa.virtualpos.services/Home/ThreeDModelPayGate - Provizyon:
https://boatest.kuveytturk.com.tr/boa.virtualpos.services/Home/ThreeDModelProvisionGate
Produksiyon Endpoint'leri:
- Kart Dogrulama:
https://sanalpos.kuveytturk.com.tr/ServiceGateWay/Home/ThreeDModelPayGate - Provizyon:
https://sanalpos.kuveytturk.com.tr/ServiceGateWay/Home/ThreeDModelProvisionGate
Test Calistirma
Katkida Bulunma
Katkilar memnuniyetle karsilanir! Lutfen bir Pull Request gonderin.
Lisans
MIT Lisansi. Detaylar icin LICENSE dosyasina bakin.
Destek
Sorular ve sorunlar icin lutfen GitHub'da issue acin: https://github.com/emre-tarhan/kuveytturk-vpos-laravel-sdk