PHPackages                             tapsilat/tapsilat-laravel - 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. tapsilat/tapsilat-laravel

ActiveLibrary[Payment Processing](/categories/payments)

tapsilat/tapsilat-laravel
=========================

Laravel integration package for Tapsilat Payment Gateway SDK

v2025.12.19.4(4mo ago)00MITPHPPHP ^8.1CI passing

Since Dec 19Pushed 4mo agoCompare

[ Source](https://github.com/tapsilat/tapsilat-laravel)[ Packagist](https://packagist.org/packages/tapsilat/tapsilat-laravel)[ Docs](https://github.com/tapsilat/tapsilat-laravel)[ RSS](/packages/tapsilat-tapsilat-laravel/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (4)Dependencies (7)Versions (5)Used By (0)

Tapsilat Laravel
================

[](#tapsilat-laravel)

[![Latest Version on Packagist](https://camo.githubusercontent.com/e394a30a59d7dc4a9fc1459f7f5e6d715fa64bdda7cff1fdd0b713866a6295d4/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f74617073696c61742f74617073696c61742d6c61726176656c2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/tapsilat/tapsilat-laravel)[![Tests](https://github.com/tapsilat/tapsilat-laravel/actions/workflows/tests.yml/badge.svg)](https://github.com/tapsilat/tapsilat-laravel/actions/workflows/tests.yml)[![Total Downloads](https://camo.githubusercontent.com/7858c7870f384861e4b6c497742844a498c687c3a43bcb940e99ebd16f071367/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f74617073696c61742f74617073696c61742d6c61726176656c2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/tapsilat/tapsilat-laravel)

Laravel integration package for the Tapsilat Payment Gateway. This package provides a seamless integration with the [Tapsilat PHP SDK](https://github.com/tapsilat/tapsilat-php) for Laravel applications.

Requirements
------------

[](#requirements)

- PHP 8.1+
- Laravel 10.x or 11.x

Installation
------------

[](#installation)

Install the package via Composer:

```
composer require tapsilat/tapsilat-laravel
```

### Publish Configuration

[](#publish-configuration)

Publish the configuration file:

```
php artisan vendor:publish --tag="tapsilat-config"
```

Or run the install command which will publish the config and add environment variables:

```
php artisan tapsilat:install
```

Configuration
-------------

[](#configuration)

Add the following environment variables to your `.env` file:

```
TAPSILAT_API_KEY=your_api_key_here
TAPSILAT_WEBHOOK_SECRET=your_webhook_secret_here

# Optional settings
TAPSILAT_BASE_URL=https://panel.tapsilat.dev/api/v1
TAPSILAT_TIMEOUT=30
TAPSILAT_DEFAULT_CURRENCY=TRY
TAPSILAT_DEFAULT_LOCALE=tr
TAPSILAT_PAYMENT_SUCCESS_URL=https://yoursite.com/payment/success
TAPSILAT_PAYMENT_FAILURE_URL=https://yoursite.com/payment/failure
TAPSILAT_LOGGING_ENABLED=false
```

Usage
-----

[](#usage)

### Using the Facade

[](#using-the-facade)

```
use Tapsilat\Laravel\Facades\Tapsilat;

// Create a simple order
$order = Tapsilat::createSimpleOrder(
    amount: 100.00,
    buyerName: 'John',
    buyerSurname: 'Doe',
    buyerEmail: 'john@example.com'
);

// Get checkout URL
$checkoutUrl = $order->getCheckoutUrl();

// Redirect user to checkout
return redirect($checkoutUrl);
```

### Using Dependency Injection

[](#using-dependency-injection)

```
use Tapsilat\Laravel\TapsilatManager;

class PaymentController extends Controller
{
    public function __construct(
        private TapsilatManager $tapsilat
    ) {}

    public function createPayment(Request $request)
    {
        $order = $this->tapsilat->createSimpleOrder(
            100.00,
            'John',
            'Doe',
            'john@example.com'
        );

        return redirect($order->getCheckoutUrl());
    }
}
```

### Creating Orders with Full Options

[](#creating-orders-with-full-options)

```
use Tapsilat\Laravel\Facades\Tapsilat;
use Tapsilat\Models\BuyerDTO;
use Tapsilat\Models\OrderCreateDTO;
use Tapsilat\Models\BasketItemDTO;
use Tapsilat\Models\BillingAddressDTO;

// Create buyer
$buyer = new BuyerDTO(
    name: 'John',
    surname: 'Doe',
    email: 'john@example.com',
    gsm_number: '+905551234567'
);

// Create basket items
$basketItem = new BasketItemDTO(
    category1: 'Electronics',
    category2: 'Phones',
    id: 'ITEM-001',
    item_type: 'PHYSICAL',
    name: 'iPhone 15 Pro',
    price: 50000.00,
    quantity: 1
);

// Create billing address
$billingAddress = new BillingAddressDTO(
    address: '123 Main St',
    city: 'Istanbul',
    contact_name: 'John Doe',
    country: 'TR',
    zip_code: '34000'
);

// Create order DTO
$orderDto = new OrderCreateDTO(
    amount: 50000.00,
    currency: 'TRY',
    locale: 'tr',
    buyer: $buyer,
    basket_items: [$basketItem],
    billing_address: $billingAddress,
    conversation_id: 'unique-conversation-id',
    payment_success_url: 'https://yoursite.com/success',
    payment_failure_url: 'https://yoursite.com/failure'
);

$order = Tapsilat::createOrder($orderDto);

return redirect($order->getCheckoutUrl());
```

### Order Operations

[](#order-operations)

```
use Tapsilat\Laravel\Facades\Tapsilat;
use Tapsilat\Models\RefundOrderDTO;

// Get order by reference ID
$order = Tapsilat::getOrder('order-reference-id');

// Get order by conversation ID
$order = Tapsilat::getOrderByConversationId('conversation-id');

// Get order list with pagination
$orders = Tapsilat::getOrderList(page: 1, perPage: 10);

// Cancel an order
Tapsilat::cancelOrder('order-reference-id');

// Refund an order (partial)
Tapsilat::refundOrderSimple(
    amount: 50.00,
    referenceId: 'order-reference-id'
);

// Refund entire order
Tapsilat::refundAllOrder('order-reference-id');

// Get order status
$status = Tapsilat::getOrderStatus('order-reference-id');

// Get order transactions
$transactions = Tapsilat::getOrderTransactions('order-reference-id');

// Get system order statuses
$statuses = Tapsilat::getSystemOrderStatuses();

// Process order accounting
use Tapsilat\Models\OrderAccountingRequest;
$accountingRequest = new OrderAccountingRequest('order-reference-id');
Tapsilat::orderAccounting($accountingRequest);

// Process order post-authorization
use Tapsilat\Models\OrderPostAuthRequest;
$postAuthRequest = new OrderPostAuthRequest(100.00, 'order-reference-id');
Tapsilat::orderPostAuth($postAuthRequest);
```

### Subscription Operations

[](#subscription-operations)

```
use Tapsilat\Laravel\Facades\Tapsilat;
use Tapsilat\Models\SubscriptionCreateRequest;
use Tapsilat\Models\SubscriptionBillingDTO;
use Tapsilat\Models\SubscriptionUserDTO;

// Create billing information
$billing = new SubscriptionBillingDTO(
    address: '123 Main St',
    city: 'Istanbul',
    contact_name: 'John Doe',
    country: 'TR',
    zip_code: '34000'
);

// Create user information
$user = new SubscriptionUserDTO(
    id: 'user-123',
    first_name: 'John',
    last_name: 'Doe',
    email: 'john@example.com',
    phone: '5551234567'
);

// Create subscription request
$subscription = new SubscriptionCreateRequest(
    amount: 99.99,
    currency: 'TRY',
    title: 'Monthly Premium Plan',
    period: 30,
    cycle: 1,
    payment_date: 1,
    external_reference_id: 'sub-ext-123',
    success_url: 'https://yoursite.com/subscription/success',
    failure_url: 'https://yoursite.com/subscription/failure',
    billing: $billing,
    user: $user
);

$response = Tapsilat::createSubscription($subscription);
echo "Subscription Reference: " . $response->getReferenceId();

// Get subscription by reference ID
$subscription = Tapsilat::getSubscriptionByReferenceId('sub-reference-id');

// Get subscription by external ID
$subscription = Tapsilat::getSubscriptionByExternalId('sub-ext-123');

// List subscriptions
$subscriptions = Tapsilat::listSubscriptions(page: 1, perPage: 10);

// Cancel subscription
Tapsilat::cancelSubscriptionByReferenceId('sub-reference-id');
```

### Organization Settings

[](#organization-settings)

```
use Tapsilat\Laravel\Facades\Tapsilat;

$settings = Tapsilat::getOrganizationSettings();
```

### Health Check

[](#health-check)

```
use Tapsilat\Laravel\Facades\Tapsilat;

$health = Tapsilat::healthCheck();

// Or use artisan command
// php artisan tapsilat:health
```

Webhook Handling
----------------

[](#webhook-handling)

The package automatically registers a webhook endpoint at `/tapsilat/webhook` when you have configured `TAPSILAT_WEBHOOK_SECRET`.

### Available Events

[](#available-events)

Listen to these events in your application:

```
use Tapsilat\Laravel\Events\OrderPaid;
use Tapsilat\Laravel\Events\OrderFailed;
use Tapsilat\Laravel\Events\OrderRefunded;
use Tapsilat\Laravel\Events\SubscriptionCreated;
use Tapsilat\Laravel\Events\SubscriptionCanceled;
use Tapsilat\Laravel\Events\SubscriptionPaymentSucceeded;
use Tapsilat\Laravel\Events\SubscriptionPaymentFailed;
use Tapsilat\Laravel\Events\WebhookReceived;
```

### Creating Event Listeners

[](#creating-event-listeners)

```
// app/Listeners/HandleOrderPaid.php
namespace App\Listeners;

use Tapsilat\Laravel\Events\OrderPaid;

class HandleOrderPaid
{
    public function handle(OrderPaid $event): void
    {
        $referenceId = $event->getReferenceId();
        $amount = $event->getAmount();
        $currency = $event->getCurrency();

        // Update your order status
        // Send confirmation email
        // etc.
    }
}
```

### Registering Listeners

[](#registering-listeners)

In your `EventServiceProvider`:

```
use Tapsilat\Laravel\Events\OrderPaid;
use Tapsilat\Laravel\Events\OrderFailed;
use App\Listeners\HandleOrderPaid;
use App\Listeners\HandleOrderFailed;

protected $listen = [
    OrderPaid::class => [
        HandleOrderPaid::class,
    ],
    OrderFailed::class => [
        HandleOrderFailed::class,
    ],
];
```

### Manual Webhook Verification

[](#manual-webhook-verification)

If you need to handle webhooks manually:

```
use Tapsilat\Laravel\Facades\Tapsilat;

$payload = request()->getContent();
$signature = request()->header('X-Tapsilat-Signature');

if (Tapsilat::verifyWebhook($payload, $signature)) {
    // Process webhook
    $data = json_decode($payload, true);
}
```

Accessing the Raw API Client
----------------------------

[](#accessing-the-raw-api-client)

If you need direct access to the underlying Tapsilat PHP SDK:

```
use Tapsilat\Laravel\Facades\Tapsilat;

$client = Tapsilat::client();

// Now you can use any method from the SDK directly
$response = $client->makeCustomRequest(...);
```

Error Handling
--------------

[](#error-handling)

```
use Tapsilat\Laravel\Facades\Tapsilat;
use Tapsilat\APIException;

try {
    $order = Tapsilat::createSimpleOrder(100, 'John', 'Doe', 'john@example.com');
} catch (APIException $e) {
    // Handle Tapsilat API errors
    $statusCode = $e->statusCode;
    $errorCode = $e->code;
    $errorMessage = $e->error;

    Log::error('Tapsilat API Error', [
        'status_code' => $statusCode,
        'code' => $errorCode,
        'error' => $errorMessage,
    ]);
}
```

Logging
-------

[](#logging)

Enable logging in your `.env` file:

```
TAPSILAT_LOGGING_ENABLED=true
TAPSILAT_LOG_CHANNEL=stack
```

Testing
-------

[](#testing)

```
composer test
```

Changelog
---------

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

Contributing
------------

[](#contributing)

Please see [CONTRIBUTING](CONTRIBUTING.md) for details.

Security Vulnerabilities
------------------------

[](#security-vulnerabilities)

If you discover a security vulnerability, please send an e-mail to .

Credits
-------

[](#credits)

- [Tapsilat](https://github.com/tapsilat)
- [All Contributors](../../contributors)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE) for more information.

###  Health Score

34

—

LowBetter than 77% of packages

Maintenance74

Regular maintenance activity

Popularity0

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity46

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 52.9% 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 ~0 days

Total

4

Last Release

145d ago

PHP version history (2 changes)v2025.12.19.1PHP ^8.1

v2025.12.19.2PHP ^8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/10771f854083d479bea13d4733e93db076296fb9a295f092812fc8a87962f2cb?d=identicon)[hmert](/maintainers/hmert)

---

Top Contributors

[![hmert](https://avatars.githubusercontent.com/u/182906?v=4)](https://github.com/hmert "hmert (9 commits)")[![atakanargn](https://avatars.githubusercontent.com/u/12297738?v=4)](https://github.com/atakanargn "atakanargn (8 commits)")

---

Tags

laravellaravel-packagepaymentsphplaravelpaymentsubscriptioncheckoutpayment gatewaytapsilat

###  Code Quality

TestsPest

Static AnalysisPHPStan

Code StyleLaravel Pint

Type Coverage Yes

### Embed Badge

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

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

###  Alternatives

[sebdesign/laravel-viva-payments

A Laravel package for integrating the Viva Payments gateway

4845.9k](/packages/sebdesign-laravel-viva-payments)[musahmusah/laravel-multipayment-gateways

A Laravel Package that makes implementation of multiple payment Gateways endpoints and webhooks seamless

852.2k1](/packages/musahmusah-laravel-multipayment-gateways)

PHPackages © 2026

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