README

Bu paket, Yapı Kredi Bankası'nın Sanal POS sistemi ile kolay kullanımlı bir entegrasyon sağlar ve entegrasyon dokümantasyonunda belirtildiği gibi 3D Secure 2.1 protokolünü uygular.

Kurulum

Paketi composer aracılığıyla kurabilirsiniz:

composer require w3/yapikredi-pos

Kullanım

Temel Yapılandırma

use W3\YapiKrediPos\YapiKrediPos;

// Yapı Kredi POS istemcisini başlatın
$pos = new YapiKrediPos(
    'YOUR_MERCHANT_ID',    // Yapı Kredi Bankası tarafından sağlanan Üye İşyeri ID
    'YOUR_TERMINAL_ID',    // Yapı Kredi Bankası tarafından sağlanan Terminal ID
    'YOUR_POSNET_ID',      // Yapı Kredi Bankası tarafından sağlanan POS Net ID
    'YOUR_MERCHANT_KEY',   // Güvenli iletişim için üye işyeri anahtarı
    'test'                 // Ortam: 'test' veya 'production'
);

Laravel Entegrasyonu

Bu paket Laravel entegrasyonu ile birlikte gelir. Paketi kurduktan sonra, yapılandırma dosyasını yayınlayın:

php artisan vendor:publish --provider="W3\YapiKrediPos\Laravel\YapiKrediPosServiceProvider" --tag="config"

Bu, Laravel uygulamanızda bir config/yapikredi-pos.php dosyası oluşturacaktır. .env dosyanızda aşağıdaki ortam değişkenlerini ayarlayarak paketi yapılandırabilirsiniz:

YAPIKREDI_MERCHANT_ID=your_merchant_id
YAPIKREDI_TERMINAL_ID=your_terminal_id
YAPIKREDI_POSNET_ID=your_posnet_id
YAPIKREDI_MERCHANT_KEY=your_merchant_key
YAPIKREDI_ENVIRONMENT=test

Daha sonra paketi Laravel uygulamanızda kullanabilirsiniz:

// Bağımlılık enjeksiyonu kullanarak
public function checkout(YapiKrediPos $pos)
{
    // $pos örneğini kullanın
}

// Facade kullanarak
use YapiKrediPos;

public function checkout()
{
    $response = YapiKrediPos::threeDSecureAuth()
        ->setOrderId(uniqid('order_'))
        // ... diğer parametreler
        ->send();
}

// Servis konteyneri kullanarak
$pos = app('yapikredi-pos');

3D Secure Ödeme Akışı

Adım 1: 3D Secure Kimlik Doğrulamasını Başlatın

// Bu işlem için benzersiz bir sipariş ID'si oluşturun
$orderId = uniqid('order_');

// 3D Secure kimlik doğrulamasını başlatın
$response = $pos->threeDSecureAuth()
    ->setOrderId($orderId)
    ->setCardNumber('4506349116608409')  // Test kart numarası
    ->setExpiryMonth('12')
    ->setExpiryYear('30')
    ->setCvv('000')
    ->setAmount(100.50)                  // TL cinsinden tutar
    ->setCurrency('TL')                  // Para birimi kodu
    ->setInstallment(0)                  // 0 tek ödeme için, veya taksit sayısı
    ->setReturnUrl('https://your-website.com/payment/callback')
    ->send();

// Kimlik doğrulama isteğinin başarılı olup olmadığını kontrol edin
if ($response->isSuccessful()) {
    // Sipariş ID'sini daha sonra kullanmak üzere oturumda veya veritabanında saklayın
    $_SESSION['order_id'] = $orderId;

    // 3D Secure yönlendirmesi için HTML formunu alın
    echo $response->getRedirectForm('Ödemeye Devam Et');

    // Veya formu manuel olarak oluşturabilirsiniz:
    // echo '<form method="POST" action="' . $response->getFormAction() . '">';
    // echo '<input type="hidden" name="data" value="' . $response->getFormData() . '">';
    // echo '<button type="submit">Ödemeye Devam Et</button>';
    // echo '</form>';
} else {
    // Kimlik doğrulama hatasını işleyin
    echo 'Hata: ' . $response->getErrorMessage();
}

Adım 2: 3D Secure Geri Dönüşünü İşleyin

// Geri dönüş URL işleyicinizde:

// Bankanın yanıtından 3D Secure verilerini alın
$threeDSecureData = $_POST['data'] ?? '';

// Sipariş ID'sini oturumdan veya veritabanından alın
$orderId = $_SESSION['order_id'] ?? '';

// Ödemeyi tamamlayın
try {
    $response = $pos->threeDSecurePayment()
        ->setOrderId($orderId)
        ->setThreeDSecureData($threeDSecureData)
        ->setAmount(100.50)              // Kimlik doğrulamada kullanılan tutarla eşleşmelidir
        ->setCurrency('TL')              // Kimlik doğrulamada kullanılan para birimiyle eşleşmelidir
        ->setInstallment(0)              // Kimlik doğrulamada kullanılan taksit sayısıyla eşleşmelidir
        ->send();

    // Ödemenin başarılı olup olmadığını kontrol edin
    if ($response->isSuccessful()) {
        // Ödeme başarılı
        echo 'Ödeme başarılı!';
        echo 'İşlem ID: ' . $response->getTransactionId();
        echo 'Yetkilendirme Kodu: ' . $response->getAuthCode();
    } else {
        // Ödeme başarısız
        echo 'Ödeme başarısız: ' . $response->getErrorMessage();
    }
} catch (\W3\YapiKrediPos\Exception\PaymentException $e) {
    // Ödeme istisnasını işleyin
    echo 'Ödeme hatası: ' . $e->getMessage();
    echo 'Hata kodu: ' . $e->getErrorCode();
} catch (\W3\YapiKrediPos\Exception\ConnectionException $e) {
    // Bağlantı istisnasını işleyin
    echo 'Bağlantı hatası: ' . $e->getMessage();
} catch (\W3\YapiKrediPos\Exception\ValidationException $e) {
    // Doğrulama istisnasını işleyin
    echo 'Doğrulama hatası: ' . $e->getMessage();
}

Hata Yönetimi

Paket, farklı hata senaryoları için farklı türde istisnalar fırlatır:

ValidationException: İstek parametreleri geçersiz olduğunda fırlatılır
ConnectionException: Yapı Kredi POS API'sine bağlanırken bir hata olduğunda fırlatılır
PaymentException: Ödeme reddedildiğinde veya başarısız olduğunda fırlatılır
YapiKrediPosException: Diğer tüm hatalar için temel istisna sınıfı

Özellikler

Yapı Kredi Bankası'nın POSNET sistemi ile 3D Secure 2.1 entegrasyonu
Hem 3D hem de 3D olmayan işlemler için destek
Kolay yapılandırma ve kurulum
Kapsamlı hata yönetimi
Laravel ve diğer PHP çerçeveleriyle uyumlu

w3 / yapikredi-pos

Maintainers

Details