Laravel Tabby Pay in 4 Payment Gateway

A professional Laravel package for integrating Tabby Pay in 4 - the leading Buy Now Pay Later (BNPL) solution in the Middle East. Supports Saudi Arabia, UAE, and Kuwait.

Customers can split their payments into 4 interest-free installments, increasing conversion and average order value.

Features

• ✅ Full Tabby Checkout flow (Create Session, Callback, Cancel, Failure)
• ✅ Capture authorized payments
• ✅ Refund payments (partial or full)
• ✅ Payment details retrieval
• ✅ Webhook management (authorized, captured, failed, rejected)
• ✅ Sandbox & Production environments
• ✅ Multi-region support (SA, AE, KW)
• ✅ Multi-currency support (SAR, AED, KWD)
• ✅ Arabic & English language support
• ✅ Guzzle HTTP client (no raw cURL)
• ✅ Configurable routes prefix & middleware
• ✅ Transaction logging migration
• ✅ Laravel 10, 11, 12 & 13 compatible
• ✅ PHP 8.1+

Requirements

Installation

composer require aghfatehi/laravel-tabby

Configuration

1. Publish Configuration

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

2. Publish Migration (Optional)

php artisan vendor:publish --tag=tabby-migrations
php artisan migrate

3. Environment Variables

Add these to your .env file:

TABBY_SANDBOX_MODE=true
TABBY_SECRET_KEY=sk_test_your_secret_key_here
TABBY_MERCHANT_CODE=ae
TABBY_REGION=ae
TABBY_CURRENCY=AED
TABBY_LANGUAGE=en
TABBY_LOGGING=true
TABBY_ROUTE_PREFIX=tabby

4. Service Provider

The package auto-discovers via Laravel's package discovery. If you disable discovery, register manually in config/app.php:

'providers' => [
    Aghfatehi\Tabby\TabbyServiceProvider::class,
],

5. Facade (Optional)

'aliases' => [
    'Tabby' => Aghfatehi\Tabby\Facades\Tabby::class,
],

Usage

Quick Start - Frontend Checkout

use Aghfatehi\Tabby\Facades\Tabby;

// Build the checkout payload
$response = Tabby::createCheckout([
    'payment' => [
        'amount' => '500.00',
        'currency' => 'SAR',
        'description' => 'Order #1234 payment',
        'buyer' => [
            'phone' => '500000001',
            'email' => 'customer@example.com',
            'name' => 'Ahmed Ali',
            'dob' => '1990-01-01',
        ],
        'order' => [
            'reference_id' => 'ORD-' . uniqid(),
            'items' => [
                [
                    'title' => 'Product Name',
                    'quantity' => 1,
                    'unit_price' => '500.00',
                ],
            ],
        ],
    ],
    'merchant_code' => config('tabby.merchant_code'),
    'merchant_urls' => [
        'success' => route('tabby.callback'),
        'cancel' => route('tabby.cancel'),
        'failure' => route('tabby.failure'),
    ],
]);

// Redirect customer to Tabby checkout
$webUrl = $response['configuration']['available_products']['installments'][0]['web_url']
    ?? $response['configuration']['available_products']['pay_by_installments']['web_url']
    ?? null;

if ($webUrl) {
    return redirect()->away($webUrl);
}

Using Routes

The package registers these routes under the configured prefix (/tabby by default):

API Methods

use Aghfatehi\Tabby\Facades\Tabby;

// Create Checkout Session
$checkout = Tabby::createCheckout($data);

// Retrieve Payment
$payment = Tabby::getPayment('pay_xxxxx');

// Update Payment (e.g., order reference)
$updated = Tabby::updatePayment('pay_xxxxx', [
    'order' => ['reference_id' => 'NEW-ORD-123'],
]);

// Capture Payment (after authorization)
$captured = Tabby::capturePayment('pay_xxxxx', '500.00');

// Refund Payment
$refunded = Tabby::refundPayment('pay_xxxxx', '100.00');

// List Payments with filters
$payments = Tabby::listPayments([
    'created_at__gte' => '2025-03-01',
    'limit' => 20,
]);

// Webhook Management
$webhook = Tabby::webhookRegister('https://example.com/webhook', [
    'title' => 'Authorization',
    'value' => 'Bearer xxx',
]);
$list = Tabby::webhookList();
$detail = Tabby::webhookGet('webhook-id');
Tabby::webhookUpdate('webhook-id', 'https://example.com/webhook-new');
Tabby::webhookDelete('webhook-id');

Amount Formatting

use Aghfatehi\Tabby\Facades\Tabby;

$formatted = Tabby::formatAmount(100.5); // "100.50"

Regions & API Endpoints

Webhook Events

The webhook endpoint handles these events:

• payment_authorized - Payment has been authorized (ready to capture)
• payment_captured - Payment has been captured (funds collected)
• payment_failed - Payment failed
• payment_rejected - Payment was rejected

Customising Routes

Publish the config and modify the routes section:

// config/tabby.php
'routes' => [
    'prefix' => 'payment/tabby',     // Custom prefix
    'middleware' => ['web', 'auth'],   // Custom middleware
],

Test Cards (Sandbox)

Test Customer

Email: test@example.com
Phone: +966500000000

Testing

composer test

Changelog

See CHANGELOG for recent changes.

Security

If you discover security issues, please email fathi.a.n2002@gmail.com instead of using the issue tracker.

License

This package is open-sourced software licensed under the MIT license.

Support

• Issues: GitHub Issues
• Tabby Docs: https://docs.tabby.ai
• Author: Abdelghafour Fatehi (fathi.a.n2002@gmail.com)

Comparison with Tamara