PHPackages                             enessvg/laravel-paynet - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Payment Processing](/categories/payments)
4. /
5. enessvg/laravel-paynet

ActiveLibrary[Payment Processing](/categories/payments)

enessvg/laravel-paynet
======================

Paynet Payment Gateway Laravel SDK

v3.0.1(4w ago)238↓88.2%MITPHPPHP ^8.2

Since Feb 17Pushed 4w agoCompare

[ Source](https://github.com/enessvg/laravel-paynet)[ Packagist](https://packagist.org/packages/enessvg/laravel-paynet)[ RSS](/packages/enessvg-laravel-paynet/feed)WikiDiscussions main Synced today

READMEChangelog (7)Dependencies (12)Versions (12)Used By (0)

Laravel Paynet
==============

[](#laravel-paynet)

Paynet Payment Gateway icin Laravel SDK. PHP 8.2+ ve Laravel 10/11/12 ile uyumludur.

Kurulum
-------

[](#kurulum)

```
composer require enessvg/laravel-paynet
php artisan vendor:publish --tag=paynet-config
```

`.env`:

```
PAYNET_SECRET_KEY=your_secret_key_here
PAYNET_PUBLIC_KEY=your_public_key_here
PAYNET_IS_LIVE=false
PAYNET_TIMEOUT=30
PAYNET_VERIFY_SSL=true
PAYNET_TDS_RETURN_URL=https://your-domain.com/payment/callback
```

Response Kullanimi
------------------

[](#response-kullanimi)

Tum client methodlari SDK response objesi dondurur. Laravel HTTP response gerekiyorsa `raw()` ile erisebilirsiniz.

```
$result->successful();     // Tahsilat/operasyon basarili mi?
$result->failed();         // Basarisiz mi?
$result->apiSuccessful();  // Paynet code 0 veya 100 mu?
$result->errorMessage();   // Banka/Paynet hata mesaji
$result->get('xact_id');   // Ham response alanina erisim
$result->toArray();        // Ham body array
$result->raw();            // Illuminate\Http\Client\Response|null
```

Odeme benzeri response'larda `successful()` sadece `is_succeed=true` ve Paynet sonuc kodu `0` veya `100` ise true doner. Yani HTTP 200 veya `code=0` tek basina tahsilat basarisi sayilmaz.

Direkt Odeme
------------

[](#direkt-odeme)

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

$result = Paynet::payment(new PaymentParams(
    amount: PaynetTools::formatWithDecimalSeparator(123.45),
    referenceNo: PaynetTools::generateReferenceNo('ORD-'),
    domain: 'www.acme.com',
    pan: '5400617004770430',
    month: '12',
    year: '2030',
    cvc: '123',
    cardHolder: 'John Doe',
));

if ($result->successful()) {
    $transactionId = $result->xactId;
}

if ($result->failed()) {
    $message = $result->errorMessage();
}
```

Sakli kart ile odeme:

```
$result = Paynet::payment(new PaymentParams(
    amount: '123,45',
    referenceNo: 'ORD-1001',
    domain: 'www.acme.com',
    cardHash: 'saved-card-token',
));
```

3D Odeme
--------

[](#3d-odeme)

```
use Paynet\DTOs\TdsChargeParams;
use Paynet\DTOs\TdsInitialParams;
use Paynet\Facades\Paynet;

$initial = Paynet::tdsInitial(new TdsInitialParams(
    amount: '123,45',
    referenceNo: 'ORD-1002',
    returnUrl: route('payment.callback'),
    domain: 'www.acme.com',
    pan: '5400617004770430',
    month: '12',
    year: '2030',
    cvc: '123',
    cardHolder: 'John Doe',
));

if ($initial->successful()) {
    return redirect($initial->postUrl);
}

// Callback icinde Paynet'in post ettigi/session'da saklanan degerlerle:
$charge = Paynet::tdsCharge(new TdsChargeParams(
    sessionId: request('session_id'),
    tokenId: request('token_id'),
));

if ($charge->successful()) {
    $transactionId = $charge->xactId;
}
```

Odeme Dogrulama
---------------

[](#odeme-dogrulama)

Odeme cevabini aldiktan sonra tek helper ile Paynet sorgusu uzerinden dogrulayabilirsiniz.

```
$verification = Paynet::verifyPayment(
    referenceNo: 'ORD-1001',
    expectedAmount: '123,45',
    expectedCurrency: 'TRY',
    expectedReferenceNo: 'ORD-1001',
);

if ($verification->successful()) {
    $transaction = $verification->transaction;
}
```

Oran/Taksit
-----------

[](#orantaksit)

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

$ratios = Paynet::getRatios(new RatioParams(
    amount: '100000',
    bin: '540061',
    addCommissionToAmount: true,
    agentId: '1001',
    cardType: 'cc',
));

foreach ($ratios->banks as $bank) {
    foreach ($bank->ratios as $ratio) {
        echo "{$bank->bankName}: {$ratio->instalment} taksit\n";
    }
}
```

Public oran, oran tipi ve oran tanimlari:

```
use Paynet\DTOs\RatioCodeParams;
use Paynet\DTOs\RatioDefinitionParams;
use Paynet\DTOs\RatioTypeParams;

Paynet::getPublicRatios(new RatioParams(bin: '540061'));
Paynet::setRatioType(new RatioTypeParams(description: 'API oran'));
Paynet::deleteRatioType(new RatioCodeParams(ratioCode: 'RATIO1'));
Paynet::defineRatio(new RatioDefinitionParams(
    ratioCode: 'RATIO1',
    cardType: 'cc',
    banks: [
        [
            'bank_id' => 'DENZ',
            'instalments' => [
                ['instalment' => 0, 'ratio' => 0.1],
            ],
        ],
    ],
));
```

Kart Saklama
------------

[](#kart-saklama)

```
use Paynet\DTOs\CardDescUpdateParams;
use Paynet\DTOs\CardListParams;
use Paynet\DTOs\DeleteCardParams;
use Paynet\DTOs\SaveCardParams;
use Paynet\DTOs\SavedCardOtpCheckParams;
use Paynet\DTOs\SavedCardOtpParams;
use Paynet\Facades\Paynet;

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

$cardOwnerId = $save->cardOwnerId;

$cards = Paynet::listCards(new CardListParams(
    cardOwnerId: $cardOwnerId,
));

$cardHash = $cards->cards[0]->cardHash;

Paynet::updateCardDescription(new CardDescUpdateParams(
    cardOwnerId: $cardOwnerId,
    cardHash: $cardHash,
    cardDesc: 'Yeni Kart Aciklamasi',
));

Paynet::deleteCard(new DeleteCardParams(
    cardOwnerId: $cardOwnerId,
    cardHash: $cardHash,
));

$otp = Paynet::sendCardOtp(new SavedCardOtpParams(
    userGsm: '5551234567',
    otpSessionId: 'otp-session-id',
));

Paynet::checkOtpForSavedCard(new SavedCardOtpCheckParams(
    userGsm: '5551234567',
    otpSessionId: 'otp-session-id',
    otpCode: 'ART2',
));
```

Iade ve Iptal
-------------

[](#iade-ve-iptal)

```
use Paynet\DTOs\ReversalListParams;
use Paynet\DTOs\ReversedRequestParams;
use Paynet\DTOs\TransactionIdParams;
use Paynet\Facades\Paynet;

Paynet::requestReversal(new ReversedRequestParams(
    xactId: 'xk_...',
    amount: '1000',
));

Paynet::listReversals(new ReversalListParams(
    datab: '2026-01-01',
    datbi: '2026-01-02',
));

Paynet::cancelPreAuthorization(new TransactionIdParams(xactId: 'xk_...'));
Paynet::cancelCapture(new TransactionIdParams(xactId: 'xk_...'));
```

Yardimci Fonksiyonlar
---------------------

[](#yardimci-fonksiyonlar)

```
use Paynet\Support\PaynetTools;

PaynetTools::formatWithDecimalSeparator(123.45);    // "123,45"
PaynetTools::formatWithoutDecimalSeparator(123.45); // "12345"
PaynetTools::validateCardNumber('5400617004770430');
PaynetTools::validateExpiryDate('12', '2030');
PaynetTools::validateCvc('123');
PaynetTools::maskCardNumber('5400617004770430');    // "540061******0430"
PaynetTools::getCardBin('5400617004770430');        // "540061"
PaynetTools::generateReferenceNo('ORD-');
```

Test Kartlari
-------------

[](#test-kartlari)

Paynet test kartlari icin:

Lisans
------

[](#lisans)

MIT

###  Health Score

44

—

FairBetter than 90% of packages

Maintenance94

Actively maintained with recent releases

Popularity12

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity54

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~11 days

Recently: every ~25 days

Total

11

Last Release

29d ago

Major Versions

v1.0.4 → v2.0.02026-02-24

v2.0.2 → v3.0.02026-06-05

### Community

Maintainers

![](https://www.gravatar.com/avatar/b68f9696f9300f9c28cdbaaa2976a14cf5682074b878c5f2bf566bc952da80fc?d=identicon)[enessvg](/maintainers/enessvg)

---

Top Contributors

[![enessvg](https://avatars.githubusercontent.com/u/133034948?v=4)](https://github.com/enessvg "enessvg (18 commits)")

---

Tags

iyzicolaravelpaymentpayment-gatewaypaynetphplaravelpaymentgatewayposcredit-cardpaynet

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/enessvg-laravel-paynet/health.svg)

```
[![Health](https://phpackages.com/badges/enessvg-laravel-paynet/health.svg)](https://phpackages.com/packages/enessvg-laravel-paynet)
```

###  Alternatives

[sebdesign/laravel-viva-payments

A Laravel package for integrating the Viva Payments gateway

4851.0k](/packages/sebdesign-laravel-viva-payments)[linkxtr/laravel-qrcode

A clean, modern, and easy-to-use QR code generator for Laravel

3720.4k](/packages/linkxtr-laravel-qrcode)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)