8000 GitHub - yasinkuyu/omnipay-qnb: QNB (PayFor) virtual POS gateway for Omnipay: hosted payment page (3D Host), refund, void, order inquiry · GitHub
[go: up one dir, main page]

Skip to content

About

QNB (PayFor) virtual POS gateway for Omnipay: hosted payment page (3D Host), refund, void, order inquiry

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

3 Commits

Folders and files

Repository files navigation

Omnipay: QNB

QNB sanal POS'u (PayFor) için Omnipay sürücüsü

Latest Stable Version Total Downloads License

Türkçe | English

Bu paket ne yapar?

Mağazanızda QNB sanal POS'unuzla kartla ödeme almanızı sağlar. Müşteri QNB'nin ortak ödeme sayfasına gider, kartını orada girer, 3D Secure doğrulamasını yapar ve sitenize geri döner. Kart bilgisi sizin sunucunuzdan hiç geçmez.

Siteniz ──(imzalı form)──▶ QNB ortak ödeme sayfası ──(3D Secure)──▶ Siteniz (dönüş adresi)

Bu paket QNB'nin PayFor altyapısı içindir (yönetim ekranı vpos.qnb.com.tr). Eski NestPay / EST altyapısındaki QNB Finansbank üye iş yerleri için omnipay-nestpay kullanılır.

Özellikler

Ödeme Ortak ödeme sayfası (3D Host)
Taksit 2-12 (bankanızla anlaştığınız kadar)
İade / iptal refund() (tam ya da kısmi), void() (gün sonundan önce)
Sorgu fetchTransaction()
Güvenlik SHA-1 imza; dönüşte imza, üye iş yeri, sipariş no ve tutar denetimi

Kurulum

composer require yasinkuyu/omnipay-qnb php-http/guzzle7-adapter

PHP 8.1 ya da üstü gerekir.

Bankadan almanız gereken bilgiler

Ayar Nedir? Nereden bulunur?
merchantId Üye iş yeri numarası Bankanın gönderdiği bilgiler / sanal POS yönetim ekranı
userCode API kullanıcı adı Sanal POS yönetim ekranında açılan API kullanıcısı
userPass API kullanıcı şifresi (iade / iptal / sorgu) Aynı kullanıcı
merchantPass 3D anahtarı (imza için) Sanal POS yönetim ekranı → 3D ayarları
mbrId Kurum kodu QNB için 5 (varsayılan)

Hızlı başlangıç

1. Gateway'i hazırlayın

use Omnipay\Omnipay;

$gateway = Omnipay::create('Qnb');
$gateway->initialize([
    'merchantId'   => '085300000009704',
    'userCode'     => 'QNB_API_KULLANICI_3DPAY',
    'userPass'     => 'UcBN0',
    'merchantPass' => '12345678',
    'testMode'     => true,   // canlıya geçerken false
]);

2. Ödemeyi başlatın (odeme.php)

$response = $gateway->purchase([
    'amount'        => '149.90',
    'currency'      => 'TRY',
    'transactionId' => 'SIP-10045',                          // sizin sipariş numaranız, her denemede benzersiz
    'returnUrl'     => 'https://magaza.com/odeme-donus.php', // başarılı ve başarısız dönüş buraya
    'installment'   => 3,                                    // tek çekim için 1 ya da hiç yazmayın
])->send();

$response->redirect(); // tarayıcıyı QNB'nin ödeme sayfasına götüren formu basar ve gönderir

3. Dönüşü doğrulayın (odeme-donus.php)

$result = $gateway->completePurchase([
    'transactionId' => 'SIP-10045', // KENDİ kaydınızdaki sipariş no
    'amount'        => '149.90',    // KENDİ kaydınızdaki tutar
])->send();

if (!$result->isVerified()) {
    // İmza tutmadı ya da sipariş no / tutar farklı: bu dönüşe güvenmeyin.
} elseif ($result->isSuccessful()) {
    // Ödeme alındı.
    $result->getTransactionReference(); // bankanın referans no (HostRefNum)
    $result->getAuthCode();
    $result->getMaskedCard();
} else {
    echo $result->getMessage();         // ret nedeni ya da 3D Secure hatası
}

Doğrulama nasıl çalışır? Banka dönüşü imzalar: üye iş yeri no, 3D anahtarı, sipariş no, onay kodu, sonuç kodu, 3D durumu, rastgele sayı ve kullanıcı adı birleştirilip SHA-1 alınır. Ödeme ancak sonuç kodu 00 ve 3D durumu 1 ise başarılı sayılır.

İade, iptal, sorgu

$gateway->void(['transactionId' => 'SIP-10045'])->send();                         // gün sonundan önce: iptal
$gateway->refund(['transactionId' => 'SIP-10045', 'amount' => '50.00'])->send(); // tam ya da kısmi iade
$status = $gateway->fetchTransaction(['transactionId' => 'SIP-10045'])->send();
$status->getData()['TxnResult'];                                                  // Success / Failed …

isReadable() false dönerse bankanın yanıtı okunamamıştır: işlem gerçekleşmiş olabilir. Otomatik olarak yeniden denemeyin; sanal POS ekranından kontrol edin.

Test ortamı

testMode => true iken istekler QNB'nin test ortamına gider, para çekilmez. Yukarıdaki örnekteki bilgiler QNB'nin herkese açık test hesabıdır. Test kartı: 4155 6501 0041 6111, son kullanma 01/28, CVV 123. Test ortamının ödeme sayfası, dönüşleri ve sorgu / iptal / iade API'si buradan çalışır.

Sık karşılaşılan durumlar

Belirti Neden
Banka hata sayfasına (GatewayError) yönleniyor merchantPass, merchantId ya da userCode yanlış
isVerified() hep false Farklı merchantPass ya da userCode, ya da dönüş alanları değiştirilmiş
İptal / iadede "V013 Seçili İşlem Bulunamadı" Sipariş no yanlış ya da işlem gün sonuna girmiş (iptal yerine iade)
Dönüşte oturum düşüyor Banka dönüşü siteler arası POST'tur: dönüş adresinde oturum çerezine güvenmeyin

Testler

composer install
vendor/bin/phpunit

Diğer Omnipay paketleri

Lisans

MIT — Yasin Kuyu

About

QNB (PayFor) virtual POS gateway for Omnipay: hosted payment page (3D Host), refund, void, order inquiry

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

0