enessvg/laravel-paynet

Paynet Payment Gateway Laravel SDK

v2.0.2 2026-02-25 19:57 UTC

Requires

• php: ^8.2
• guzzlehttp/guzzle: ^7.0
• illuminate/support: ^10.0|^11.0|^12.0

Requires (Dev)

• orchestra/testbench: ^8.0|^9.0|^10.0
• phpunit/phpunit: ^10.0|^11.0

MIT

• Enes SVG

• payment
• gateway
• laravel
• pos
• credit-card
• paynet

README

Paynet Payment Gateway için Laravel paketi. PHP 8.2+ ve Laravel 10/11/12 uyumlu.

Kurulum

composer require enessvg/laravel-paynet

Yapılandırma

Config dosyasını yayınlayın:

php artisan vendor:publish --tag=paynet-config

.env dosyanıza aşağıdaki değişkenleri ekleyin:

PAYNET_SECRET_KEY=your_secret_key_here
PAYNET_PUBLIC_KEY=your_public_key_here
PAYNET_IS_LIVE=false
PAYNET_TDS_RETURN_URL=https://your-domain.com/payment/callback

Kullanım

Facade ile Kullanım

use Paynet\Facades\Paynet;
use Paynet\DTOs\PaymentParams;
use Paynet\Support\PaynetTools;

// Direkt ödeme (3D Secure olmadan)
$params = new PaymentParams(
    amount: PaynetTools::formatWithDecimalSeparator(123.45),
    referenceNo: PaynetTools::generateReferenceNo('ORD-'),
    domain: 'www.acme.com',
    pan: '5400617004770430',
    month: '12',
    year: '25',
    cvc: '123',
    cardHolder: 'John Doe',
    instalment: 1,
);

$result = Paynet::payment($params);

if ($result->code === 0) {
    // Ödeme başarılı
    $transactionId = $result->xactId;
} else {
    // Hata
    $errorMessage = $result->bankErrorMessage ?? $result->message;
}

Dependency Injection ile Kullanım

use Paynet\PaynetClient;
use Paynet\DTOs\PaymentParams;

class PaymentController extends Controller
{
    public function __construct(
        private readonly PaynetClient $paynet
    ) {}

    public function processPayment(Request $request)
    {
        $params = new PaymentParams(
            amount: '123,45',
            referenceNo: PaynetTools::generateReferenceNo('ORD-'),
            domain: 'www.acme.com',
            pan: $request->card_number,
            month: $request->expire_month,
            year: $request->expire_year,
            cvc: $request->cvc,
            cardHolder: $request->card_holder,
        );

        return $this->paynet->payment($params);
    }
}

3D Secure Ödeme

use Paynet\Facades\Paynet;
use Paynet\DTOs\TdsInitialParams;
use Paynet\DTOs\TdsChargeParams;
use Paynet\Enums\ResultCode;

// Adım 1: 3D Secure başlat
$params = new TdsInitialParams(
    amount: '123,45',
    referenceNo: PaynetTools::generateReferenceNo('ORD-'),
    domain: 'www.acme.com',
    returnUrl: config('paynet.tds_return_url'),
    pan: '5400617004770430',
    month: '12',
    year: '25',
    cvc: '123',
    cardHolder: 'John Doe',
);

$result = Paynet::tdsInitial($params);

if ($result->code === ResultCode::Successful) {
    // Session'a kaydet
    session(['paynet_session_id' => $result->sessionId]);
    session(['paynet_token_id' => $result->tokenId]);
    
    // 3D sayfasına yönlendir
    return redirect($result->postUrl);
}

// Adım 2: Callback'de ödemeyi onayla
public function callback(Request $request)
{
    $params = new TdsChargeParams(
        sessionId: $request->paynet_session_id,
        tokenId: $request->paynet_token_id,
    );

    $result = Paynet::tdsCharge($params);

    if ($result->isSucceed) {
        return view('payment.success', ['transaction' => $result]);
    }

    return view('payment.error', ['error' => $result->bankErrorMessage]);
}

Taksit/Oran Sorgulama

use Paynet\Facades\Paynet;
use Paynet\DTOs\RatioParams;

$params = new RatioParams(
    amount: '1000,00',
    bin: '540061', // Kartın ilk 6 hanesi (opsiyonel)
);

$result = Paynet::getRatios($params);

if ($result->code === 0 && isset($result->banks)) {
    foreach ($result->banks as $bank) {
        echo "Banka: {$bank->bankName}\n";
        foreach ($bank->ratios as $ratio) {
            echo "  {$ratio->instalment} Taksit: %{$ratio->ratio}\n";
        }
    }
    // Veya HTML tablo olarak
    // echo $result->toHtmlTable();
} else {
    echo $result->message;
}

İşlem Sorgulama

use Paynet\Facades\Paynet;
use Paynet\DTOs\CheckTransactionParams;

$result = Paynet::checkTransaction(new CheckTransactionParams(
    xactId: '12345678',
));

// veya referans numarası ile
$result = Paynet::checkTransaction(new CheckTransactionParams(
    referenceNo: 'ORD-12345',
));

if ($result->isSucceed) {
    echo "İşlem durumu: Başarılı";
    echo "Tutar: {$result->amount}";
}

Mail/SMS ile Ödeme Linki

use Paynet\Facades\Paynet;
use Paynet\DTOs\MailOrderParams;

$params = new MailOrderParams(
    amount: '500,00',
    nameSurname: 'Ahmet Yılmaz',
    userName: '[e-mail]',
    email: '[e-mail]',
    sendMail: true,
    phone: '05551234567',
    sendSms: true,
    expireDate: 24, // 24 saat geçerli
    succeedUrl: route('payment.success'),
    errorUrl: route('payment.error'),
);

$result = Paynet::createMailOrder($params);

if ($result->isSuccessful()) {
    $paymentUrl = $result->url;
}

Paynet JS Widget ile Kullanım (v1)

// Blade view
<form action="{{ route('payment.charge') }}" method="post" id="checkout-form">
    @csrf
    <script type="text/javascript"
        class="paynet-button"
        src="https://pts-pj.paynet.com.tr/public/js/paynet.js"
        data-key="{{ config('paynet.public_key') }}"
        data-description="Ödemenizi tamamlamak için bilgileri girip tamam butonuna basınız"
        data-amount="{{ \Paynet\Support\PaynetTools::formatWithoutDecimalSeparator($amount) }}"
        data-button_label="Ödemeyi Tamamla"
        data-pos_type="5">
    </script>
</form>

// Controller
use Paynet\Facades\Paynet;
use Paynet\DTOs\ChargeParams;
use Paynet\Support\PaynetTools;

public function charge(Request $request)
{
    $params = new ChargeParams(
        sessionId: $request->session_id,
        tokenId: $request->token_id,
        amount: (string) PaynetTools::formatWithoutDecimalSeparator(session('amount')),
    );

    $result = Paynet::charge($params);

    if ($result->isSucceed) {
        return redirect()->route('payment.success');
    }

    return back()->withErrors(['payment' => $result->bankErrorMessage]);
}

Kart Saklama

saveCard

use Paynet\Facades\Paynet;
use Paynet\DTOs\SaveCardParams;

$response = Paynet::saveCard(new SaveCardParams(
    cardDesc: 'Kisisel Kartim',
    cardHolder: 'John Doe',
    cardNumber: '4355080000000000',
    expireMonth: '12',
    expireYear: '30',
    cvv: '123',
    userUniqueId: 'user-123',
));

$data = $response->json();

if (($data['code'] ?? 1) === 0) {
    $cardOwnerId = $data['card_owner_id'] ?? null;
}

listCards

use Paynet\Facades\Paynet;
use Paynet\DTOs\CardListParams;

$response = Paynet::listCards(new CardListParams(
    cardOwnerId: 'abc45adc20-91ba-4a29-a599-0eb18177247e',
    limit: 10,
));

$data = $response->json();

if (($data['code'] ?? 1) === 0) {
    $cards = $data['Data'] ?? [];
}

updateCardDescription

use Paynet\Facades\Paynet;
use Paynet\DTOs\CardDescUpdateParams;

$response = Paynet::updateCardDescription(new CardDescUpdateParams(
    cardOwnerId: 'abc45adc20-91ba-4a29-a599-0eb18177247e',
    cardHash: 'abcdef-8014-435e-8bcc-daf4592f3431',
    cardDesc: 'Yeni Kart Aciklamasi',
));

$data = $response->json();

if (($data['code'] ?? 1) === 0) {
    $message = $data['message'] ?? 'Basarili Islem';
}

deleteCard

use Paynet\Facades\Paynet;
use Paynet\DTOs\DeleteCardParams;

$response = Paynet::deleteCard(new DeleteCardParams(
    cardOwnerId: 'abc45adc20-91ba-4a29-a599-0eb18177247e',
    cardHash: 'abcdef-8014-435e-8bcc-daf4592f3431',
));

$data = $response->json();

if (($data['code'] ?? 1) === 0) {
    $message = $data['message'] ?? 'Basarili Islem';
}

Saklı Kart - OTP Gönderme

$params = new SavedCardOtpParams(
    userGsm: '...',
    otpSessionId: '...'
);

$response = Paynet::sendOtpForSavedCard($params);

$data = $response->json();

if (($data['code'] ?? 1) === 0) {
    $message = $data['message'] ?? 'Basarili Islem';
}

Saklı Kart - OTP Kontrol

$params = new SavedCardOtpCheckParams(
    userGsm: '...',
    otpSessionId: '...',
    otpCode: '...'
)

$response = Paynet::checkOtpForSavedCard($params);

$data = $response->json();

if (($data['code'] ?? 1) === 0) {
    $message = $data['message'] ?? 'Basarili Islem';
}

Yardımcı Fonksiyonlar

use Paynet\Support\PaynetTools;

// Tutar formatlama
$formatted = PaynetTools::formatWithDecimalSeparator(123.45); // "123,45"
$cents = PaynetTools::formatWithoutDecimalSeparator(123.45);  // 12345

// Kart doğrulama
$isValid = PaynetTools::validateCardNumber('5400617004770430'); // true
$isValidExpiry = PaynetTools::validateExpiryDate('12', '25');   // true
$isValidCvc = PaynetTools::validateCvc('123');                  // true

// Kart maskeleme
$masked = PaynetTools::maskCardNumber('5400617004770430'); // "540061******0430"

// BIN numarası
$bin = PaynetTools::getCardBin('5400617004770430'); // "540061"

// Benzersiz referans numarası
$refNo = PaynetTools::generateReferenceNo('ORD-'); // "ORD-17082532451234"

Enum Kullanımı

use Paynet\Enums\ResultCode;
use Paynet\Enums\TransactionType;

// Sonuç kodu kontrolü
if ($result->code === ResultCode::Successful) {
    // Başarılı
}

// Açıklama alma
$description = ResultCode::Successful->description(); // "İşlem başarılı"

// İşlem tipi
$params->transactionType = TransactionType::Sale;     // Satış
$params->transactionType = TransactionType::Refund;   // İade

Hata Yönetimi

use Paynet\Exceptions\PaynetException;

try {
    $result = Paynet::payment($params);
} catch (PaynetException $e) {
    // Bağlantı veya yapılandırma hatası
    Log::error('Paynet Error: ' . $e->getMessage(), [
        'result_code' => $e->resultCode?->value,
        'bank_error' => $e->bankErrorMessage,
    ]);
}

Test Kartları

Altta ki linkten detaylı bir şekilde ulaşabilirsiniz

https://doc.paynet.com.tr/genel-bilgiler/test-kartlari

Lisans

MIT